Dokumentation

KI-Agenten (MCP)

MCP-Server verbinden

Verbinden Sie Claude, Claude Code, ChatGPT, Cursor, VS Code oder Codex über MCP mit Ihrem AmICited-Workspace. Eine URL, OAuth-Anmeldung und ein API-Schlüssel als Alternative.

AmICited betreibt einen dauerhaft erreichbaren MCP-Server (Model Context Protocol). Sobald Ihr KI-Client verbunden ist, kann er Ihre Sichtbarkeitsdaten lesen, Berichte ausführen und, mit Schreibzugriff, Prompts hinzufügen, Artikel generieren oder Anmerkungen protokollieren, alles in einer normalen Unterhaltung. Jede Dashboard-Funktion gibt es auch als MCP-Tool, es gibt also nichts, was Sie in der App tun können und ein Agent nicht.

Bevor Sie starten#

  • Ein Tarif, der MCP enthält. MCP ist in der 7-tägigen Testphase sowie bei Pro, Premium und Enterprise verfügbar. Starter-Workspaces sehen die Server-URL, aber Verbindungen werden abgelehnt, bis der Tarif hochgestuft wird. Siehe Tarife und Limits.
  • Editor-Berechtigungen oder höher im Workspace. Die Seite MCP weist Mitglieder ohne diese an, einen Workspace-Owner oder Admin zu fragen.
  • Ein positives Credit-Guthaben. Lesezugriffe über MCP sind kostenlos, aber der Endpunkt prüft, ob der Workspace Credits hat, bevor er antwortet. Siehe Credits.

Die Server-URL#

Es gibt eine URL für alle:

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

Der Workspace steckt nicht in der URL. Er stammt aus Ihren Zugangsdaten: Bei OAuth wählen Sie den Workspace auf dem Zustimmungsbildschirm, und ein API-Schlüssel gehört bereits zu einem Workspace. Sie können die URL auch von der Seite MCP in der App kopieren, die sie mit einer Schaltfläche URL kopieren und denselben Anleitungen pro Client wie unten zeigt. Der Transport ist Streamable HTTP.

Ihren Client verbinden#

Wählen Sie Ihren Client. Jeder Tab beginnt mit der empfohlenen OAuth-Anmeldung und endet mit der Alternative per API-Schlüssel.

Claude (Web und Desktop)

Connectors, die Sie auf claude.ai hinzufügen, sind auch in der Claude-Desktop-App verfügbar.

  1. Öffnen Sie die Connector-Einstellungen von Claude.
  2. Klicken Sie auf +, dann auf Add custom connector.
  3. Fügen Sie https://api.flowhunt.io/mcp/amicited ein und klicken Sie auf Add.
  4. Klicken Sie beim neuen Connector auf Connect und genehmigen Sie den Zugriff im sich öffnenden Browserfenster. Wählen Sie auf dem Zustimmungsbildschirm Ihren Workspace.

Öffnen Sie in einem Chat das Tools-Menü und stellen Sie sicher, dass der AmICited-Connector aktiviert ist.

Alternative per API-Schlüssel (Konfigurationsdatei von Claude Desktop). Fügen Sie dies unter mcpServers in ~/Library/Application Support/Claude/claude_desktop_config.json unter macOS hinzu und starten Sie Claude Desktop neu:

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

Claude Code

Registrieren Sie den Server einmal in Ihrem Terminal:

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

Führen Sie dann in Claude Code /mcp aus, wählen Sie Authenticate und genehmigen Sie den Zugriff im sich öffnenden Browserfenster.

Alternative per API-Schlüssel. Fügen Sie den Server unter dem obersten Schlüssel mcpServers in ~/.claude.json hinzu und starten Sie Claude Code neu:

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

ChatGPT

Benutzerdefinierte MCP-Connectors benötigen den Developer Mode, der in kostenpflichtigen ChatGPT-Tarifen verfügbar ist (Plus, Pro, Team, Enterprise). In Business-, Enterprise- und Edu-Workspaces muss ihn möglicherweise ein Admin für Sie aktivieren.

  1. Aktivieren Sie den Developer Mode wie in der Connector-Dokumentation von OpenAI beschrieben.
  2. Öffnen Sie in ChatGPT Settings, dann Apps & Connectors.
  3. Fügen Sie einen benutzerdefinierten Connector hinzu und fügen Sie https://api.flowhunt.io/mcp/amicited ein.
  4. Genehmigen Sie den Zugriff im sich öffnenden Browserfenster.

Alternative per API-Schlüssel. Wählen Sie in Schritt 4 stattdessen die Authentifizierung per API-Schlüssel und fügen Sie Ihren Workspace-API-Schlüssel ein. Speichern Sie den Connector und aktivieren Sie ihn dann in einem neuen Chat.

Cursor

Wählen Sie auf der Seite MCP der App Cursor und klicken Sie auf Add to Cursor. Cursor installiert den Server und führt die Anmeldung für Sie durch.

Öffnet die Schaltfläche Cursor nicht, fügen Sie den Server von Hand in den Cursor-Einstellungen unter MCP hinzu oder bearbeiten Sie ~/.cursor/mcp.json (oder eine projektbezogene .cursor/mcp.json):

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

Cursor öffnet beim ersten Verbinden einen Browser zur Anmeldung. Stellen Sie den Chat auf den Modus Agent, um die Tools zu nutzen.

Alternative per API-Schlüssel. Fügen Sie demselben Eintrag einen Header hinzu:

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

VS Code

VS Code nutzt den Server über GitHub Copilot im Agent-Modus, Copilot muss also aktiviert sein.

Wählen Sie auf der Seite MCP der App VS Code und klicken Sie auf Add to VS Code. VS Code installiert den Server und führt die Anmeldung für Sie durch.

Um ihn von Hand hinzuzufügen, öffnen Sie die Command Palette, führen Sie MCP: Open User Configuration aus und fügen Sie den Server unter servers hinzu:

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

Alternative per API-Schlüssel. Fügen Sie dem Eintrag "headers": { "Authorization": "Bearer <your-workspace-api-key>" } hinzu. Sie können auch MCP: Add Server… ausführen, HTTP (HTTP or Server-Sent Events) wählen, die URL einfügen und auf Nachfrage den Header Authorization hinzufügen.

Codex

Codex verbindet sich als Standard-Remote-MCP-Client. Fügen Sie den Server hinzu und melden Sie sich dann an:

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

Oder bearbeiten Sie ~/.codex/config.toml direkt:

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

Alternative per API-Schlüssel. Legen Sie den Schlüssel in einer Umgebungsvariablen ab und verweisen Sie Codex darauf:

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

Codex-Läufe mit strengen Freigabeeinstellungen erreichen jedes schreibgeschützte Tool weiterhin über read_tool. Siehe Toolsets und Tools.

OAuth oder API-Schlüssel#

OAuth 2.1 (empfohlen)Workspace-API-Schlüssel (Alternative)
EinrichtungURL einfügen, im Browser genehmigenURL plus einen Authorization: Bearer-Header einfügen
WorkspaceAuf dem Zustimmungsbildschirm gewähltDurch den Schlüssel festgelegt
Berechtigungenamicited:read zum Verbinden und Lesen; für Schreibzugriffe zusätzlich amicited:writeVoller Workspace-Zugriff
WiderrufenConnected clients → Revoke auf der Seite MCPSchlüssel löschen oder ablaufen lassen

OAuth ist der bessere Standard: Es gibt kein Geheimnis, das in eine Konfigurationsdatei gehört, jeder Client erscheint mit Namen auf der Seite MCP unter Connected clients, und Sie können einen widerrufen, ohne die anderen anzufassen. Ein schreibgeschütztes OAuth-Token kann alles auflisten und lesen, aber jedes Tool, das erstellt, bearbeitet oder löscht, lehnt mit einer Meldung ab, die den Scope amicited:write nennt. Ein erneuter Versuch hilft nicht; verbinden Sie sich erneut mit Schreibzugriff.

Behandeln Sie einen API-Schlüssel wie ein Passwort

Jeder, der einen Workspace-API-Schlüssel besitzt, kann jedes Tool auf dem Server gegen Ihre Workspace-Daten ausführen, einschließlich Schreibzugriffen. Bevorzugen Sie OAuth, halten Sie Schlüssel aus gemeinsam genutzten Repositories heraus und verwenden Sie eine Umgebungsvariable, wo Ihr Client eine unterstützt.

Prüfen, ob es funktioniert#

Fragen Sie Ihren Agenten etwas Kleines: „Liste meine AmICited-Domains auf.“ Er sollte list_domains aufrufen und Ihre Domains mit Namen zurückgeben. Versuchen Sie dann „Zeige meine KI-Sichtbarkeit für die letzten 30 Tage“, was prompt_analytics nutzt.

Wird die Verbindung abgelehnt, sagt die Meldung meist, warum:

  • Tarif. „requires a Pro plan or above“: Der Tarif des Workspace-Owners enthält MCP nicht.
  • Credits. Das Workspace-Guthaben ist null oder negativ. Laden Sie auf und versuchen Sie es erneut.
  • Rate Limit. Tool-Aufrufe sind pro Workspace und Stunde begrenzt: 120 in der Testphase, 600 bei Pro, 2.000 bei Premium, unbegrenzt bei Enterprise. Die Meldung sagt, wann das Fenster zurückgesetzt wird. Das Auflisten von Tools und das Lesen von Skills zählen nicht.

Verwandte Themen#