Dokumentace

AI agenti (MCP)

Připojení MCP serveru

Připojte Claude, Claude Code, ChatGPT, Cursor, VS Code nebo Codex ke svému workspace AmICited přes MCP. Jedna URL, přihlášení přes OAuth a klíč API jako záložní varianta.

AmICited provozuje stále dostupný MCP server (Model Context Protocol). Jakmile je váš AI klient připojen, může číst vaše data o viditelnosti, spouštět reporty a se zápisovým přístupem přidávat prompty, generovat články nebo zaznamenávat anotace, to vše z běžné konverzace. Každá funkce dashboardu je dodávána i jako nástroj MCP, takže nic, co můžete dělat v aplikaci, agent dělat nemůže.

Než začnete#

  • Tarif, který zahrnuje MCP. MCP je dostupné v 7denní zkušební verzi a v tarifech Pro, Premium a Enterprise. Workspacy s tarifem Starter vidí URL serveru, ale připojení jsou odmítána, dokud se tarif nezvýší. Viz tarify a limity.
  • Oprávnění Editor nebo vyšší ve workspace. Stránka MCP členům bez nich říká, ať požádají vlastníka nebo admina workspace.
  • Kladný zůstatek kreditů. Čtení přes MCP je zdarma, ale endpoint před odpovědí kontroluje, zda má workspace kredity. Viz kredity.

URL serveru#

Pro všechny existuje jedna URL:

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

Workspace v URL není. Vychází z vašich přihlašovacích údajů: u OAuth vyberete workspace na obrazovce souhlasu a klíč API už patří k jednomu workspace. URL můžete také zkopírovat ze stránky MCP v aplikaci, která ji zobrazuje s tlačítkem Copy URL a stejnými pokyny pro jednotlivé klienty jako níže. Transport je streamable HTTP.

Připojte svého klienta#

Vyberte svého klienta. Každá záložka začíná doporučeným přihlášením OAuth a končí variantou s klíčem API.

Claude (web a Desktop)

Konektory, které přidáte na claude.ai, jsou dostupné i v aplikaci Claude Desktop.

  1. Otevřete nastavení konektorů Claude.
  2. Klikněte na + a poté na Add custom connector.
  3. Vložte https://api.flowhunt.io/mcp/amicited a klikněte na Add.
  4. Klikněte na Connect u nového konektoru a schvalte přístup v okně prohlížeče, které se otevře. Na obrazovce souhlasu zvolte svůj workspace.

V chatu otevřete nabídku nástrojů a ujistěte se, že je konektor AmICited povolen.

Varianta s klíčem API (konfigurační soubor Claude Desktop). Přidejte toto pod mcpServers v ~/Library/Application Support/Claude/claude_desktop_config.json na macOS a poté restartujte 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 jednou z terminálu:

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

Poté v Claude Code spusťte /mcp, zvolte Authenticate a schvalte přístup v okně prohlížeče, které se otevře.

Varianta s klíčem API. Přidejte server pod klíč nejvyšší úrovně mcpServers v ~/.claude.json a restartujte 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, který je dostupný v placených tarifech ChatGPT (Plus, Pro, Team, Enterprise). Ve workspacích Business, Enterprise a Edu jej pro vás možná musí povolit admin.

  1. Zapněte Developer mode podle dokumentace konektorů OpenAI.
  2. V ChatGPT otevřete Settings a poté Apps & Connectors.
  3. Přidejte vlastní konektor a vložte https://api.flowhunt.io/mcp/amicited.
  4. Schvalte přístup v okně prohlížeče, které se otevře.

Varianta s klíčem API. V kroku 4 zvolte místo toho autentizaci klíčem API a vložte klíč API svého workspace. Uložte konektor a poté jej povolte v novém chatu.

Cursor

Na stránce MCP v aplikaci vyberte Cursor a klikněte na Add to Cursor. Cursor server nainstaluje a přihlášení provede za vás.

Pokud tlačítko Cursor neotevře, přidejte server ručně v nastavení Cursoru pod MCP, nebo upravte ~/.cursor/mcp.json (případně .cursor/mcp.json pro projekt):

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

Cursor při prvním připojení otevře prohlížeč pro přihlášení. K používání nástrojů nastavte chat do režimu Agent.

Varianta s klíčem API. Přidejte do stejného záznamu hlavičku:

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

VS Code

VS Code používá server přes GitHub Copilot v režimu Agent, takže Copilot musí být povolen.

Na stránce MCP v aplikaci vyberte VS Code a klikněte na Add to VS Code. VS Code server nainstaluje a přihlášení provede za vás.

Chcete-li jej přidat ručně, otevřete Command Palette, spusťte MCP: Open User Configuration a přidejte server pod servers:

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

Varianta s klíčem API. Přidejte do záznamu "headers": { "Authorization": "Bearer <your-workspace-api-key>" }. Můžete také spustit MCP: Add Server…, zvolit HTTP (HTTP or Server-Sent Events), vložit URL a na výzvu přidat hlavičku Authorization.

Codex

Codex se připojuje jako standardní vzdálený klient MCP. Přidejte server a poté se přihlaste:

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

Nebo upravte přímo ~/.codex/config.toml:

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

Varianta s klíčem API. Vložte klíč do proměnné prostředí a nasměrujte na ni Codex:

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

Codex spuštěný s přísným nastavením schvalování se stále dostane ke každému nástroji jen pro čtení přes read_tool. Viz toolsety a nástroje.

OAuth nebo klíč API#

OAuth 2.1 (doporučeno)Klíč API workspace (záložní)
NastaveníVložte URL, schvalte v prohlížečiVložte URL plus hlavičku Authorization: Bearer
WorkspaceZvolen na obrazovce souhlasuPevně daný klíčem
Oprávněníamicited:read k připojení a čtení; pro zápisy je potřeba také amicited:writePlný přístup k workspace
OdvoláníConnected clients → Revoke na stránce MCPSmazání nebo vypršení klíče

OAuth je lepší výchozí volba: není žádné tajemství k vložení do konfiguračního souboru, každý klient se objeví jménem na stránce MCP pod Connected clients a jednoho můžete odvolat, aniž byste se dotkli ostatních. Token OAuth jen pro čtení může vše vypsat a číst, ale každý nástroj, který vytváří, upravuje nebo maže, odmítne s hlášením jmenujícím rozsah amicited:write. Opakování nepomůže; připojte se znovu se zápisovým přístupem.

S klíčem API zacházejte jako s heslem

Kdokoli, kdo drží klíč API workspace, může proti datům vašeho workspace spouštět každý nástroj na serveru, včetně zápisů. Preferujte OAuth, nedávejte klíče do sdílených repozitářů a tam, kde to váš klient podporuje, používejte proměnnou prostředí.

Ověřte, že to funguje#

Zeptejte se agenta na něco malého: “List my AmICited domains.” Měl by zavolat list_domains a vrátit vaše domény jménem. Poté zkuste “Show my AI visibility for the last 30 days”, což používá prompt_analytics.

Pokud je připojení odmítnuto, hlášení obvykle říká proč:

  • Tarif. “requires a Pro plan or above”: tarif vlastníka workspace MCP nezahrnuje.
  • Kredity. Zůstatek workspace je nulový nebo záporný. Dobijte a zkuste znovu.
  • Limit počtu volání. Volání nástrojů jsou omezena na workspace a hodinu: 120 ve zkušební verzi, 600 u Pro, 2 000 u Premium, neomezeně u Enterprise. Hlášení říká, kdy se okno obnoví. Výpis nástrojů a čtení skills se nepočítají.

Související#