Dokumentácia

AI agenti (MCP)

Pripojenie MCP servera

Pripojte Claude, Claude Code, ChatGPT, Cursor, VS Code alebo Codex k svojmu workspaceu AmICited cez MCP. Jedna URL, prihlásenie cez OAuth a API kľúč ako záložná možnosť.

AmICited prevádzkuje vždy dostupný server MCP (Model Context Protocol). Keď je váš AI klient pripojený, dokáže čítať vaše dáta o viditeľnosti, spúšťať reporty a, s prístupom na zápis, pridávať prompty, generovať články alebo zaznamenávať anotácie, všetko z bežnej konverzácie. Každá funkcia dashboardu je dostupná aj ako nástroj MCP, takže neexistuje nič, čo môžete urobiť v aplikácii a agent nie.

Skôr než začnete#

  • Plán, ktorý zahŕňa MCP. MCP je dostupné v 7-dňovej skúšobnej verzii a v plánoch Pro, Premium a Enterprise. Workspacey s plánom Starter môžu vidieť URL servera, ale pripojenia sú odmietnuté, kým sa plán nevylepší. Pozrite si plány a limity.
  • Oprávnenia Editor alebo vyššie vo workspacei. Stránka MCP členom bez nich povie, aby požiadali vlastníka alebo správcu workspaceu.
  • Kladný zostatok kreditov. Čítania cez MCP sú zadarmo, ale endpoint pred odpoveďou kontroluje, či má workspace kredity. Pozrite si kredity.

URL servera#

Pre všetkých existuje jedna URL:

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

Workspace nie je v URL. Vychádza z vašich prihlasovacích údajov: pri OAuth vyberiete workspace na obrazovke súhlasu a API kľúč už patrí jednému workspaceu. URL môžete skopírovať aj zo stránky MCP v aplikácii, ktorá ju zobrazuje s tlačidlom Copy URL a rovnakými pokynmi pre jednotlivých klientov ako nižšie. Transport je streamable HTTP.

Pripojte svojho klienta#

Vyberte svojho klienta. Každá karta začína odporúčaným prihlásením cez OAuth a končí alternatívou s API kľúčom.

Claude (web a Desktop)

Konektory, ktoré pridáte na claude.ai, sú dostupné aj v aplikácii Claude Desktop.

  1. Otvorte nastavenia konektorov Claude.
  2. Kliknite na + a potom na Add custom connector.
  3. Vložte https://api.flowhunt.io/mcp/amicited a kliknite na Add.
  4. Kliknite na Connect pri novom konektore a schváľte prístup v okne prehliadača, ktoré sa otvorí. Na obrazovke súhlasu vyberte svoj workspace.

V chate otvorte ponuku nástrojov a uistite sa, že je konektor AmICited zapnutý.

Alternatíva s API kľúčom (konfiguračný súbor Claude Desktop). Pridajte toto pod mcpServers do ~/Library/Application Support/Claude/claude_desktop_config.json na macOS a potom reštartujte 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

Zaregistrujte server raz z terminálu:

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

Potom v Claude Code spustite /mcp, vyberte Authenticate a schváľte prístup v okne prehliadača, ktoré sa otvorí.

Alternatíva s API kľúčom. Pridajte server pod kľúč najvyššej úrovne mcpServers v ~/.claude.json a reštartujte Claude Code:

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

ChatGPT

Vlastné konektory MCP vyžadujú Developer mode, ktorý je dostupný v platených plánoch ChatGPT (Plus, Pro, Team, Enterprise). Vo workspacoch Business, Enterprise a Edu ho vám môže musieť zapnúť správca.

  1. Zapnite Developer mode podľa dokumentácie konektorov OpenAI.
  2. V ChatGPT otvorte Settings a potom Apps & Connectors.
  3. Pridajte vlastný konektor a vložte https://api.flowhunt.io/mcp/amicited.
  4. Schváľte prístup v okne prehliadača, ktoré sa otvorí.

Alternatíva s API kľúčom. V kroku 4 zvoľte namiesto toho autentifikáciu API kľúčom a vložte API kľúč svojho workspaceu. Uložte konektor a potom ho zapnite v novom chate.

Cursor

Na stránke MCP v aplikácii vyberte Cursor a kliknite na Add to Cursor. Cursor nainštaluje server a prihlásenie spustí za vás.

Ak sa tlačidlom Cursor neotvorí, pridajte server ručne v nastaveniach Cursor v časti MCP, alebo upravte ~/.cursor/mcp.json (alebo .cursor/mcp.json pre konkrétny projekt):

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

Pri prvom pripojení Cursor otvorí prehliadač na prihlásenie. Na používanie nástrojov nastavte chat do režimu Agent.

Alternatíva s API kľúčom. Do rovnakého záznamu pridajte hlavičku:

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

VS Code

VS Code používa server cez GitHub Copilot v režime Agent, takže musí byť Copilot zapnutý.

Na stránke MCP v aplikácii vyberte VS Code a kliknite na Add to VS Code. VS Code nainštaluje server a prihlásenie spustí za vás.

Ak ho chcete pridať ručne, otvorte Command Palette, spustite MCP: Open User Configuration a pridajte server pod servers:

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

Alternatíva s API kľúčom. Do záznamu pridajte "headers": { "Authorization": "Bearer <your-workspace-api-key>" }. Môžete tiež spustiť MCP: Add Server…, vybrať HTTP (HTTP or Server-Sent Events), vložiť URL a po výzve pridať hlavičku Authorization.

Codex

Codex sa pripája ako štandardný vzdialený klient MCP. Pridajte server a potom sa prihláste:

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

Alebo upravte ~/.codex/config.toml priamo:

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

Alternatíva s API kľúčom. Kľúč vložte do premennej prostredia a nasmerujte na ňu Codex:

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

Codex spustený s prísnymi nastaveniami schvaľovania sa cez read_tool stále dostane ku každému nástroju len na čítanie. Pozrite si toolsety a nástroje.

OAuth alebo API kľúč#

OAuth 2.1 (odporúčané)API kľúč workspaceu (záloha)
NastavenieVložte URL, schváľte v prehliadačiVložte URL plus hlavičku Authorization: Bearer
WorkspaceVybraný na obrazovke súhlasuUrčený kľúčom
Oprávneniaamicited:read na pripojenie a čítanie; na zápisy je potrebné aj amicited:writePlný prístup k workspaceu
ZrušenieConnected clients → Revoke na stránke MCPZmažte kľúč alebo nechajte vypršať

OAuth je lepšia predvolená voľba: nie je tajomstvo, ktoré treba vložiť do konfiguračného súboru, každý klient sa zobrazí menom na stránke MCP v časti Connected clients a jedného môžete zrušiť bez dotyku ostatných. Token OAuth len na čítanie môže všetko vypísať a prečítať, ale každý nástroj, ktorý vytvára, upravuje alebo maže, odmietne s hláškou, ktorá pomenúva rozsah amicited:write. Opakovanie nepomôže; pripojte sa znova s prístupom na zápis.

S API kľúčom zaobchádzajte ako s heslom

Ktokoľvek, kto drží API kľúč workspaceu, môže na dátach vášho workspaceu spúšťať každý nástroj servera, vrátane zápisov. Uprednostnite OAuth, držte kľúče mimo zdieľaných repozitárov a použite premennú prostredia, kde to váš klient podporuje.

Overte, že to funguje#

Opýtajte sa agenta na niečo malé: „List my AmICited domains.“ Mal by zavolať list_domains a vrátiť vaše domény menom. Potom vyskúšajte „Show my AI visibility for the last 30 days“, čo používa prompt_analytics.

Ak je pripojenie odmietnuté, správa zvyčajne povie prečo:

  • Plán. „requires a Pro plan or above“: plán vlastníka workspaceu nezahŕňa MCP.
  • Kredity. Zostatok workspaceu je nulový alebo záporný. Dobite a zopakujte.
  • Limit rýchlosti. Volania nástrojov sú obmedzené na workspace za hodinu: 120 v skúšobnej verzii, 600 v Pro, 2 000 v Premium, neobmedzene v Enterprise. Správa uvádza, kedy sa okno obnoví. Vypisovanie nástrojov a čítanie skills sa nepočítajú.

Súvisiace#