Documentație

Agenți AI (MCP)

Conectați serverul MCP

Conectați Claude, Claude Code, ChatGPT, Cursor, VS Code sau Codex la spațiul dumneavoastră de lucru AmICited prin MCP. Un singur URL, autentificare OAuth și o cheie API ca alternativă.

AmICited rulează un server MCP (Model Context Protocol) mereu activ. Odată ce clientul dumneavoastră AI este conectat, poate citi datele de vizibilitate, rula rapoarte și, cu acces de scriere, adăuga prompturi, genera articole sau înregistra adnotări, totul dintr-o conversație obișnuită. Fiecare funcție din dashboard există și ca instrument MCP, deci nu este nimic ce puteți face în aplicație și un agent să nu poată face.

Înainte de a începe#

  • Un plan care include MCP. MCP este disponibil în perioada de probă de 7 zile și în Pro, Premium și Enterprise. Spațiile de lucru Starter pot vedea URL-ul serverului, dar conexiunile sunt refuzate până la upgrade. Consultați planuri și limite.
  • Permisiuni de Editor sau superioare în spațiul de lucru. Pagina MCP le spune membrilor fără acestea să ceară unui owner sau admin al spațiului de lucru.
  • Un sold pozitiv de credite. Citirile prin MCP sunt gratuite, dar endpointul verifică dacă spațiul de lucru are credite înainte de a răspunde. Consultați credite.

URL-ul serverului#

Există un singur URL pentru toți:

text
https://api.flowhunt.io/mcp/amicited

Spațiul de lucru nu se află în URL. Provine din credențialele dumneavoastră: cu OAuth alegeți spațiul de lucru pe ecranul de consimțământ, iar o cheie API aparține deja unui singur spațiu de lucru. Puteți copia URL-ul și din pagina MCP din aplicație, care îl afișează cu un buton Copy URL și aceleași instrucțiuni pentru fiecare client ca cele de mai jos. Transportul este streamable HTTP.

Conectați clientul dumneavoastră#

Alegeți clientul. Fiecare filă începe cu autentificarea OAuth recomandată și se încheie cu alternativa prin cheie API.

Claude (web și Desktop)

Conectorii pe care îi adăugați în claude.ai sunt disponibili și în aplicația Claude Desktop.

  1. Deschideți setările de conectori Claude.
  2. Faceți clic pe +, apoi pe Add custom connector.
  3. Lipiți https://api.flowhunt.io/mcp/amicited și faceți clic pe Add.
  4. Faceți clic pe Connect pe noul conector și aprobați accesul în fereastra de browser care se deschide. Alegeți spațiul de lucru pe ecranul de consimțământ.

Într-un chat, deschideți meniul de instrumente și asigurați-vă că conectorul AmICited este activat.

Alternativă prin cheie API (fișierul de configurare Claude Desktop). Adăugați aceasta sub mcpServers în ~/Library/Application Support/Claude/claude_desktop_config.json pe macOS, apoi reporniți Claude Desktop:

claude_desktop_config.json
{
  "mcpServers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited",
      "headers": {
        "Authorization": "Bearer <your-workspace-api-key>"
      }
    }
  }
}

Claude Code

Înregistrați serverul o singură dată din terminal:

bash
claude mcp add --transport http amicited https://api.flowhunt.io/mcp/amicited

Apoi rulați /mcp în Claude Code, alegeți Authenticate și aprobați accesul în fereastra de browser care se deschide.

Alternativă prin cheie API. Adăugați serverul sub cheia de nivel superior mcpServers din ~/.claude.json și reporniți Claude Code:

~/.claude.json
{
  "mcpServers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited",
      "headers": {
        "Authorization": "Bearer <your-workspace-api-key>"
      }
    }
  }
}

ChatGPT

Conectorii MCP personalizați necesită Developer mode, disponibil în planurile ChatGPT plătite (Plus, Pro, Team, Enterprise). În spațiile de lucru Business, Enterprise și Edu, un administrator poate fi nevoit să-l activeze pentru dumneavoastră.

  1. Activați Developer mode așa cum este descris în documentația OpenAI despre conectori.
  2. În ChatGPT, deschideți Settings, apoi Apps & Connectors.
  3. Adăugați un conector personalizat și lipiți https://api.flowhunt.io/mcp/amicited.
  4. Aprobați accesul în fereastra de browser care se deschide.

Alternativă prin cheie API. La pasul 4, alegeți în schimb autentificarea prin cheie API și lipiți cheia API a spațiului dumneavoastră de lucru. Salvați conectorul, apoi activați-l într-un chat nou.

Cursor

În pagina MCP a aplicației, selectați Cursor și faceți clic pe Add to Cursor. Cursor instalează serverul și rulează autentificarea pentru dumneavoastră.

Dacă butonul nu deschide Cursor, adăugați serverul manual în setările Cursor, la MCP, sau editați ~/.cursor/mcp.json (sau un .cursor/mcp.json per proiect):

~/.cursor/mcp.json
{
  "mcpServers": {
    "amicited": {
      "url": "https://api.flowhunt.io/mcp/amicited"
    }
  }
}

Cursor deschide un browser pentru autentificare prima dată când se conectează. Setați chatul pe modul Agent pentru a folosi instrumentele.

Alternativă prin cheie API. Adăugați un antet în aceeași intrare:

json
"headers": { "Authorization": "Bearer <your-workspace-api-key>" }

VS Code

VS Code folosește serverul prin GitHub Copilot în modul Agent, deci Copilot trebuie să fie activat.

În pagina MCP a aplicației, selectați VS Code și faceți clic pe Add to VS Code. VS Code instalează serverul și rulează autentificarea pentru dumneavoastră.

Pentru a-l adăuga manual, deschideți Command Palette, rulați MCP: Open User Configuration și adăugați serverul sub servers:

mcp.json
{
  "servers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited"
    }
  }
}

Alternativă prin cheie API. Adăugați "headers": { "Authorization": "Bearer <your-workspace-api-key>" } în intrare. Puteți rula și MCP: Add Server…, alege HTTP (HTTP or Server-Sent Events), lipi URL-ul și adăuga antetul Authorization când vi se solicită.

Codex

Codex se conectează ca un client MCP la distanță standard. Adăugați serverul, apoi autentificați-vă:

bash
codex mcp add amicited --url https://api.flowhunt.io/mcp/amicited
codex mcp login amicited

Sau editați direct ~/.codex/config.toml:

~/.codex/config.toml
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
oauth_resource = "https://api.flowhunt.io/mcp/amicited"

Alternativă prin cheie API. Puneți cheia într-o variabilă de mediu și indicați-o lui Codex:

~/.codex/config.toml
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
bearer_token_env_var = "AMICITED_API_KEY"

Codex rulat cu setări stricte de aprobare va ajunge în continuare la fiecare instrument numai pentru citire prin read_tool. Consultați seturi de instrumente și instrumente.

OAuth sau cheie API#

OAuth 2.1 (recomandat)Cheie API a spațiului de lucru (alternativă)
ConfigurareLipiți URL-ul, aprobați în browserLipiți URL-ul plus un antet Authorization: Bearer
Spațiu de lucruAles pe ecranul de consimțământFixat de cheie
Permisiuniamicited:read pentru conectare și citire; amicited:write este necesar și pentru scriereAcces complet la spațiul de lucru
RevocareConnected clients → Revoke în pagina MCPȘtergeți sau expirați cheia

OAuth este opțiunea implicită mai bună: nu există niciun secret de lipit într-un fișier de configurare, fiecare client apare pe nume în pagina MCP la Connected clients și puteți revoca unul fără a le atinge pe celelalte. Un token OAuth doar pentru citire poate lista și citi tot, dar orice instrument care creează, editează sau șterge va refuza cu un mesaj care numește domeniul amicited:write. Reîncercarea nu ajută; reconectați cu acces de scriere.

Tratați o cheie API ca pe o parolă

Oricine deține o cheie API a spațiului de lucru poate rula fiecare instrument de pe server asupra datelor dumneavoastră, inclusiv scrieri. Preferați OAuth, țineți cheile în afara depozitelor partajate și folosiți o variabilă de mediu acolo unde clientul dumneavoastră o acceptă.

Verificați că funcționează#

Cereți agentului ceva mic: „List my AmICited domains.” Ar trebui să apeleze list_domains și să returneze domeniile dumneavoastră pe nume. Apoi încercați „Show my AI visibility for the last 30 days”, care folosește prompt_analytics.

Dacă conexiunea este refuzată, mesajul spune de obicei de ce:

  • Plan. „requires a Pro plan or above”: planul owner-ului spațiului de lucru nu include MCP.
  • Credite. Soldul spațiului de lucru este zero sau negativ. Reîncărcați și reîncercați.
  • Limită de rată. Apelurile de instrumente sunt plafonate pe spațiu de lucru pe oră: 120 în perioada de probă, 600 în Pro, 2.000 în Premium, nelimitat în Enterprise. Mesajul spune când se resetează fereastra. Listarea instrumentelor și citirea skill-urilor nu se numără.

Articole conexe#