Die Fin Agent API stellt einen entfernten Model Context Protocol (MCP)-Server bereit, der externen KI-Agenten ermöglicht, Fin als Werkzeug aufzurufen. Anstatt die Support-Logik in Ihrem eigenen Agenten neu zu erstellen, können Sie die knowledge base, Verfahren und Multi-Turn-Konversationsfähigkeiten von Fin direkt aus jedem MCP-kompatiblen Client nutzen, einschließlich Claude, Claude Code, Cursor oder Ihrem eigenen Agenten-Framework.

Möchten Sie Ihren Workspace von Claude Code aus einrichten oder konfigurieren? Dieser MCP-Server ermöglicht einem Agenten, Fin zu verwenden (Fragen zu stellen, Gespräche zu führen und Verfahren auszuführen). Er ändert Ihre Intercom- oder Fin-Konfiguration nicht. Um Ihren Workspace von Claude Code oder einem anderen KI-Coding-Agenten aus zu erstellen, konfigurieren oder verwalten (zum Beispiel Verfahren, Anleitungen, Zielgruppen, Datenanschlüsse, workflows, den Messenger oder Help Center-Artikel), verwenden Sie stattdessen die Fin CLI.

Anwendungsfälle

Der Fin Agent API MCP Server ist für Multi-Agenten-Szenarien konzipiert, bei denen Ihr eigener Agent Zugriff auf die Fähigkeiten von Fin benötigt:

Eingebetteter Support in Produktagenten. Geben Sie dem KI-Assistenten Ihres Produkts die Möglichkeit, Supportfragen mit Ihrem konfigurierten Fin-Wissen zu beantworten, ohne Ihre knowledge base oder Inhalte zu duplizieren.
Automatisierung von Verfahren. Lassen Sie einen orchestrierenden Agenten Fin-Verfahren (Rückerstattungen, Upgrades, Kündigungen) im Namen von users auslösen und Multi-Turn-Interaktionen programmatisch steuern.
Fähigkeitsgesteuertes Routing. Verwenden Sie list_fin_capabilities, um zu bestimmen, welche Aktionen für einen bestimmten user verfügbar sind, und leiten Sie dann im Entscheidungslogik Ihres Agenten zum richtigen Werkzeug weiter.
Entwickler-Tools. Stellen Sie Ihr Fin-Wissen in Entwickler-Tools wie Claude Code oder Cursor bereit, damit interne users Ihre Supportinhalte aus ihrem bestehenden workflow abfragen können. Um Fin oder Ihren Workspace von diesen Tools aus zu konfigurieren, verwenden Sie die Fin CLI.

Voraussetzungen

Ihr Fin-Workspace muss den Fin Agent API-Schlüssel generiert und verfügbar haben.

Endpunkt

https://api.intercom.io/fin/mcp

Verwenden Sie dies, wenn ein vertrauenswürdiger Backend-Dienst Fin im Namen eines users aufruft. Der Aufrufer authentifiziert sich mit dem Fin Agent API-Schlüssel für den Workspace. Die Endbenutzeridentität wird im Anforderungstext vom aufrufenden Dienst bereitgestellt. Dieses Modell eignet sich für Server-zu-Server-Integrationen, bei denen Ihr Backend steuert, wer die Anfrage stellt.

Authentifizierung

Übergeben Sie Ihren Fin Agent API api-Schlüssel als Bearer-Token im Authorization-Header:

Authorization: Bearer YOUR_FIN_AGENT_API_KEY

Verbindung von Claude herstellen

Claude Desktop

Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "fin": {
      "command": "npx",
 "args": [
   "-y",
   "mcp-remote",
    "https://api.intercom.io/fin/mcp",
   "--header",
        "Authorization: Bearer {YOUR_FIN_AGENT_API_KEY}"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add intercom-fin \
  --transport http \
  https://api.intercom.io/fin/mcp \
  --header "Authorization: Bearer YOUR_FIN_AGENT_API_KEY"

Werkzeuge

Sobald verbunden, stellt der MCP-Server dem Client fünf Werkzeuge zur Verfügung.

list_fin_capabilities

Gibt die Fin Agent API-Fähigkeiten zurück, die für einen bestimmten user verfügbar sind: die zielgruppenabgestimmten Verfahren, die der user auslösen kann, sowie die statischen Aktionen, die allen users zur Verfügung stehen (Frage stellen, auf ein Gespräch antworten).

Rufen Sie dies zuerst auf, um herauszufinden, was Fin für einen bestimmten user tun kann, bevor Sie andere Werkzeuge aufrufen. Der Zugriff auf Verfahren ist zielgruppenabgestimmt – nicht jeder user hat Zugriff auf jedes Verfahren.

Eingabe: user_id – die externe ID des users.

Rückgabe: Ein JSON-Dokument, das verfügbare Fähigkeiten mit Typ, ID und Name auflistet.

ask_fin

Sendet eine einmalige Frage an Fin und gibt eine Antwort zurück. Fin durchsucht Ihre konfigurierten Wissensquellen und liefert eine direkte Antwort, ohne eine dauerhafte Konversation zu starten.

Verwenden Sie dies für Informationsabfragen, bei denen Sie eine direkte Antwort wünschen und keinen Multi-Turn-Fluss benötigen.

Eingaben: user_id, message (die zu stellende Frage).

get_fin_response

Fragt nach der Antwort von Fin auf eine laufende Konversation oder einen Verfahrensablauf. Verwenden Sie dies, nachdem Sie eine Konversation oder ein Verfahren gestartet haben, um die neueste Antwort von Fin abzurufen.

Eingabe: conversation_id.

reply_to_fin_conversation

Sendet eine Folge-Nachricht in einer bestehenden Fin-Konversation. Verwenden Sie dies, um eine Multi-Turn-Interaktion fortzusetzen – zum Beispiel, um zusätzliche Informationen bereitzustellen, die Fin während eines Verfahrens angefordert hat.

Eingaben: conversation_id, message.

run_fin_procedure

Löst ein bestimmtes Fin-Verfahren für einen user aus. Ein Verfahren ist ein konfigurierter mehrstufiger workflow – zum Beispiel die Bearbeitung einer Rückerstattung oder die Aktualisierung eines Abonnements. Fin startet das Verfahren, kann zusätzliche Informationen anfordern und führt die Interaktion bis zum Abschluss.

Verwenden Sie zuerst list_fin_capabilities, um die Verfahrens-ID für die Aktion zu finden, die Sie ausführen möchten.

Eingaben: procedure_id, user_id.

Fin Agent API: MCP Server