MCP-Connector
Verbinden Sie sich direkt mit MCP-Servern über die Messages API
Claudes Model Context Protocol (MCP) Connector-Funktion ermöglicht es Ihnen, direkt von der Messages API aus eine Verbindung zu entfernten MCP-Servern herzustellen, ohne einen separaten MCP-Client zu benötigen.
Diese Funktion erfordert den Beta-Header: "anthropic-beta": "mcp-client-2025-04-04"
Hauptfunktionen
- Direkte API-Integration: Verbindung zu MCP-Servern ohne Implementierung eines MCP-Clients
- Tool-Calling-Unterstützung: Zugriff auf MCP-Tools über die Messages API
- OAuth-Authentifizierung: Unterstützung für OAuth Bearer-Tokens für authentifizierte Server
- Mehrere Server: Verbindung zu mehreren MCP-Servern in einer einzigen Anfrage
Einschränkungen
- Von den Funktionen der MCP-Spezifikation werden derzeit nur Tool-Aufrufe unterstützt.
- Der Server muss öffentlich über HTTP zugänglich sein. Lokale STDIO-Server können nicht direkt verbunden werden.
- Der MCP-Connector wird derzeit nicht auf Amazon Bedrock und Google Vertex unterstützt.
Verwendung des MCP-Connectors in der Messages API
Um eine Verbindung zu einem entfernten MCP-Server herzustellen, fügen Sie den Parameter mcp_servers
in Ihre Messages API-Anfrage ein:
MCP-Server-Konfiguration
Jeder MCP-Server im mcp_servers
-Array unterstützt die folgende Konfiguration:
Feldbeschreibungen
Eigenschaft | Typ | Erforderlich | Beschreibung |
---|---|---|---|
type | string | Ja | Derzeit wird nur “url” unterstützt |
url | string | Ja | Die URL des MCP-Servers. Muss mit https:// beginnen |
name | string | Ja | Eine eindeutige Kennung für diesen MCP-Server. Sie wird in mcp_tool_call -Blöcken verwendet, um den Server zu identifizieren und Tools für das Modell zu unterscheiden. |
tool_configuration | object | Nein | Konfigurieren der Tool-Nutzung |
tool_configuration.enabled | boolean | Nein | Ob Tools von diesem Server aktiviert werden sollen (Standard: true) |
tool_configuration.allowed_tools | array | Nein | Liste zur Einschränkung der erlaubten Tools (standardmäßig sind alle Tools erlaubt) |
authorization_token | string | Nein | OAuth-Autorisierungstoken, falls vom MCP-Server benötigt. Siehe MCP-Spezifikation. |
Antwort-Inhaltstypen
Wenn Claude MCP-Tools verwendet, enthält die Antwort zwei neue Inhaltsblocktypen:
MCP Tool Use Block
MCP Tool Result Block
Mehrere MCP-Server
Sie können eine Verbindung zu mehreren MCP-Servern herstellen, indem Sie mehrere Objekte im mcp_servers
-Array einfügen:
Authentifizierung
Für MCP-Server, die eine OAuth-Authentifizierung erfordern, müssen Sie ein Zugriffstoken erhalten. Die MCP-Connector-Beta unterstützt die Übergabe eines authorization_token
-Parameters in der MCP-Server-Definition.
Von API-Nutzern wird erwartet, dass sie den OAuth-Flow handhaben und das Zugriffstoken vor dem API-Aufruf erhalten sowie das Token bei Bedarf aktualisieren.
Erhalt eines Zugriffstokens für Testzwecke
Der MCP-Inspector kann Sie durch den Prozess des Erhalts eines Zugriffstokens für Testzwecke führen.
-
Führen Sie den Inspector mit dem folgenden Befehl aus. Sie benötigen Node.js auf Ihrem Computer.
-
Wählen Sie in der Seitenleiste links für “Transport type” entweder “SSE” oder “Streamable HTTP”.
-
Geben Sie die URL des MCP-Servers ein.
-
Klicken Sie im rechten Bereich auf die Schaltfläche “Open Auth Settings” nach “Need to configure authentication?”.
-
Klicken Sie auf “Quick OAuth Flow” und autorisieren Sie auf dem OAuth-Bildschirm.
-
Folgen Sie den Schritten im Abschnitt “OAuth Flow Progress” des Inspectors und klicken Sie auf “Continue”, bis Sie “Authentication complete” erreichen.
-
Kopieren Sie den Wert
access_token
. -
Fügen Sie ihn in das Feld
authorization_token
in Ihrer MCP-Server-Konfiguration ein.
Verwendung des Zugriffstokens
Sobald Sie ein Zugriffstoken mit einem der oben genannten OAuth-Flows erhalten haben, können Sie es in Ihrer MCP-Server-Konfiguration verwenden:
Für detaillierte Erklärungen des OAuth-Flows siehe den Abschnitt zur Autorisierung in der MCP-Spezifikation.