MCP-Server

Verbinde Claude Code, Cursor und andere KI-Tools über den Remote-MCP-Server mit deinem intoCHAT-Konto: Endpunkt, API-Schlüssel und Scopes, Einrichtung für jeden Client, die Tools und die Grenzen.

intoCHAT hat einen Remote-MCP-Server. MCP (Model Context Protocol) ist der Standard, über den KI-Tools wie Claude Code und Cursor sich mit anderen Diensten verbinden. Hast du dein Tool verbunden, kannst du es in normalen Worten bitten, deine Agenten aufzulisten, ihre Gespräche und Leads zu lesen, Textbausteine und Q&A-Paare hinzuzufügen, Quellen zu löschen oder einem Agenten eine Testnachricht zu senden, und es ruft intoCHAT für dich auf.

Der MCP-Server nutzt dieselben API-Schlüssel, Scopes, Pläne und dasselbe Ratenlimit wie die REST-API, und seine Tools tun genau das, was die passenden REST-Endpunkte tun.

Endpunkt

https://www.intochat.ai/api/mcp

Der Server nutzt den Transport Streamable HTTP. Jede Anfrage braucht deinen API-Schlüssel im Header Authorization:

Authorization: Bearer ic_live_YOUR_KEY

Nutze die Adresse mit www, wie oben.

Bevor du loslegst

Der MCP-Server ist wie die REST-API in Starter, Pro und Enterprise enthalten. Im Plan Free kannst du keine API-Schlüssel erstellen, und ein Konto, das zurück zu Free wechselt, bekommt bei jeder Anfrage einen Fehler, bis es wieder im Plan Starter oder höher ist.

Du brauchst einen API-Schlüssel. Nur der Owner des Kontos und Admins können einen erstellen.

API-Schlüssel erstellen

Klicke in der Seitenleiste unter Settings auf API keys.
Gib dem Schlüssel unter Create a key einen Name, zum Beispiel Claude Code.
Wähle unter Access, was das KI-Tool darf. Every scope, including ones added later erlaubt jedes Tool. Soll es nur lesen dürfen, wähle Only the scopes I choose und hake nur die :read-Scopes an. Welchen Scope jedes Tool braucht, steht unter Tools.
Klicke auf Create key, dann auf Copy, und klicke auf I've saved it. Der Schlüssel wird nur einmal angezeigt.

Ein Schlüssel funktioniert für jeden Agenten im Konto. Behandle ihn wie ein Passwort: Halte ihn aus Dateien heraus, die du committest oder teilst, und widerrufe ihn auf der Seite API keys, wenn jemand anderes ihn haben könnte. Mehr dazu unter API-Schlüssel erstellen in der Dokumentation der REST-API.

Claude Code verbinden

Führe das in einem Terminal aus, mit deinem Schlüssel statt ic_live_YOUR_KEY:

claude mcp add --transport http intochat https://www.intochat.ai/api/mcp \
  --header "Authorization: Bearer ic_live_YOUR_KEY"

Damit fügst du den Server für das aktuelle Projekt hinzu, nur auf deinem Computer. Um ihn in jedem Projekt zu nutzen, füge --scope user vor --transport ein.

Um die Einrichtung in der .mcp.json des Projekts mit deinem Team zu teilen, ohne den Schlüssel selbst, lies den Schlüssel aus einer Umgebungsvariablen:

{
  "mcpServers": {
    "intochat": {
      "type": "http",
      "url": "https://www.intochat.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${INTOCHAT_API_KEY}"
      }
    }
  }
}

Tippe dann in Claude Code /mcp, um zu prüfen, ob intochat verbunden ist, und frag zum Beispiel: „Liste meine intoCHAT-Agenten auf.“

Cursor verbinden

Öffne in den Einstellungen von Cursor den Bereich MCP und füge einen Server hinzu, oder bearbeite ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json in einem Projekt:

{
  "mcpServers": {
    "intochat": {
      "url": "https://www.intochat.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ic_live_YOUR_KEY"
      }
    }
  }
}

Die intoCHAT-Tools erscheinen dann in der Liste der MCP-Tools, und der Agent von Cursor kann sie nutzen.

Andere Clients

Jeder MCP-Client, der den Transport Streamable HTTP unterstützt und in dem du einen Header hinzufügen kannst, kann sich verbinden. Gib ihm den Endpunkt und den Header Authorization.

Claude-Desktop-App. Ihre Einstellungen unter Connectors brauchen OAuth, was noch nicht unterstützt wird. Füge den Server stattdessen über die Open-Source-Bridge mcp-remote in claude_desktop_config.json hinzu. Dafür brauchst du Node.js auf deinem Computer:

{
  "mcpServers": {
    "intochat": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.intochat.ai/api/mcp", "--header", "Authorization:${INTOCHAT_AUTH}"],
      "env": {
        "INTOCHAT_AUTH": "Bearer ic_live_YOUR_KEY"
      }
    }
  }
}

MCP Inspector. Führe npx @modelcontextprotocol/inspector aus, wähle Streamable HTTP, gib den Endpunkt ein und füge den Header Authorization hinzu. Verbinde dich über den Proxy des Inspectors: Der Server lehnt Anfragen ab, die direkt von einer Webseite auf einer anderen Website kommen.

Test mit curl. Jede Anfrage ist eine JSON-RPC-Nachricht in einem POST:

curl https://www.intochat.ai/api/mcp \
  -H "Authorization: Bearer ic_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

Der Server spricht die MCP-Versionen 2026-07-28 und 2025-03-26 bis 2025-11-25, beantwortet jede Anfrage mit JSON und hält zwischen Anfragen keine Sitzung.

Tools

Tool	Scope	Was es tut
`list_agents`	`agents:read`	Listet die Agenten des Kontos mit ihren IDs, ihrem Trainingsstatus und ihren Zahlen auf.
`get_agent`	`agents:read`	Ruft einen Agenten ab.
`chat_with_agent`	`chat`	Sendet eine Nachricht an einen Agenten und liefert seine Antwort. Jede Antwort zählt als eine Nachricht deines Plans.
`list_conversations`	`conversations:read`	Listet die Gespräche eines Agenten auf, die neuesten zuerst, ohne Verläufe.
`get_conversation`	`conversations:read`	Ruft ein Gespräch mit seinem Verlauf ab.
`list_leads`	`leads:read`	Listet die Leads auf, die ein Agent erfasst hat, die neuesten zuerst.
`list_contacts`	`leads:read`	Listet die Kontakte eines Agenten auf, die neuesten zuerst, oder sucht einen anhand von `email` oder `external_id`.
`upsert_contact`	`contacts:write`	Legt einen Kontakt anhand von `external_id`, sonst `email` an oder aktualisiert ihn, mit `phone`, `name` und `attributes` (ein Objekt; `null` entfernt ein Attribut).
`list_sources`	`sources:read`	Listet die Wissensquellen eines Agenten, seinen Trainingsfortschritt und die belegten Zeichen auf.
`add_text_source`	`sources:write`	Fügt einen Textbaustein mit Titel hinzu und startet das Training.
`add_qa_pair`	`sources:write`	Fügt eine Frage mit Antwort hinzu und startet das Training. Hat der Agent dieselbe Frage schon, wird ihre Antwort ersetzt.
`delete_source`	`sources:write`	Löscht eine Quelle und das, was der Agent daraus gelernt hat. Das lässt sich nicht rückgängig machen.

Jedes Tool liefert dieselben Daten wie sein REST-Endpunkt, als JSON. list_conversations, list_leads und list_contacts nehmen optional limit (1 bis 100), cursor und since an, wie unter Paginierung beschrieben.

Die Tools sind als nur lesend oder nicht gekennzeichnet, und delete_source, add_qa_pair und upsert_contact zusätzlich als Tools, die Bestehendes ändern können, damit dein KI-Tool dich fragen kann, bevor es sie nutzt. Viele KI-Tools fragen ohnehin nach deiner Bestätigung, bevor sie ein Tool ausführen.

Fehlt dem Schlüssel der Scope, den ein Tool braucht, antwortet das Tool mit einem Fehler, der den Scope nennt, und es passiert nichts. Ein Agent, ein Gespräch oder eine Quelle aus einem anderen Konto ist „nicht gefunden“, genau wie etwas, das es nicht gibt.

Tools zum Erstellen von Agenten oder zum Ändern ihrer Einstellungen oder Anweisungen gibt es nicht. Das machst du im Dashboard.

Mit einem Agenten chatten

chat_with_agent sendet eine echte Nachricht, beantwortet mit demselben Code wie im Chat-Widget, aus dem Wissen, den Anweisungen und den Aktionen des Agenten. Nutze es, um zu testen, wie ein Agent antwortet.

Jede Antwort zählt als eine Nachricht deines Plans und auf das monatliche Nachrichtenlimit des Agenten, falls du eines festgelegt hast. Siehe Was als Nachricht zählt.
Lass conversationId weg, um ein neues Gespräch zu beginnen. Um eines fortzusetzen, übergib die conversationId der früheren Antwort.
Die Gespräche erscheinen im Tab Conversations des Agenten wie alle anderen.
Ein privater Agent ist auf diesem Weg nicht erreichbar. Siehe Private Agenten.

Bitte dein KI-Tool, nicht viele Nachrichten hintereinander zu senden, wenn du das nicht willst: Jede verbraucht Nachrichten deines Plans.

Grenzen

Plan: Starter, Pro oder Enterprise. Im Plan Free werden Anfragen abgelehnt.
Ratenlimit: 60 Anfragen pro Minute und Schlüssel, geteilt mit der REST-API. Das Verbinden braucht ein paar Anfragen, ebenso jeder Tool-Aufruf. Über dem Limit werden Anfragen für den Rest der Minute abgelehnt. Ein eigener Schlüssel für dein KI-Tool verhindert, dass es die Anfragen deines Servers verbraucht.
Nachrichten: Jede Antwort von chat_with_agent zählt als eine Nachricht deines Plans. Eine Antwort muss innerhalb von 55 Sekunden fertig sein.
Anmeldung: nur API-Schlüssel. OAuth wird noch nicht unterstützt, Clients, die es brauchen, können sich also nicht verbinden.
Quellen: nur Textbausteine und Q&A-Paare. Website-Seiten, Dateien und Notion-Seiten fügst du im Dashboard hinzu.
Keine Live-Updates: Der Server beantwortet jede Anfrage und schickt keine Benachrichtigungen von sich aus.

Kann sich dein Client nicht verbinden, prüfe den Fehler, den er zeigt: Ein ungültiger oder widerrufener Schlüssel wird mit 401 abgelehnt, ein Konto im Plan Free mit 403 und zu viele Anfragen mit 429.

Wie es weitergeht

intoCHAT aus deinem eigenen Code aufrufen: REST-API.
Lass dir Leads und Übergaben an deinen Server schicken, sobald sie passieren: Webhooks.
Schreib gute Textbausteine und Q&A-Paare: Text und Q&A.