MCP-Connector

Claude Managed Agents unterstützt die Verbindung von Model Context Protocol (MCP)-Servern mit Ihren Agenten. Dies gibt dem Agenten Zugriff auf externe Tools, Datenquellen und Dienste über ein standardisiertes Protokoll.

Die MCP-Konfiguration ist in zwei Schritte aufgeteilt:

Agentenerstellung deklariert, mit welchen MCP-Servern der Agent sich verbindet, nach Name und URL.
Sitzungserstellung stellt die Authentifizierung für diese Server bereit, indem auf einen vorab registrierten Vault verwiesen wird.

Diese Trennung hält Geheimnisse aus wiederverwendbaren Agentendefinitionen heraus und ermöglicht es jeder Sitzung, sich mit eigenen Anmeldedaten zu authentifizieren.

Alle Managed Agents API-Anfragen erfordern den managed-agents-2026-04-01 Beta-Header. Das SDK setzt den Beta-Header automatisch.

MCP-Server am Agenten deklarieren

Geben Sie MCP-Server im mcp_servers-Array beim Erstellen eines Agenten an. Jeder Server benötigt einen type, einen eindeutigen name und eine url. In dieser Phase werden keine Auth-Tokens angegeben.

Der name, den Sie im MCP-Server-Array vergeben, wird verwendet, um auf die mcp_toolset-Einträge im Tools-Array zu verweisen.

Das MCP-Toolset verwendet standardmäßig eine Berechtigungsrichtlinie von always_ask, die eine Benutzergenehmigung vor jedem Tool-Aufruf erfordert. Weitere Informationen zur Konfiguration dieses Verhaltens finden Sie unter Berechtigungsrichtlinien.

Authentifizierung bei der Sitzungserstellung bereitstellen

Beim Starten einer Sitzung übergeben Sie vault_ids, um Anmeldedaten für Ihre MCP-Server bereitzustellen. Vaults sind Sammlungen von Anmeldedaten, die Sie einmalig registrieren und per ID referenzieren. Informationen zum Erstellen von Vaults und zur Verwaltung von Anmeldedaten finden Sie unter Authentifizierung mit Vaults.

Wenn die im Vault angegebenen Autorisierungsdaten ungültig sind, wird die Sitzungserstellung erfolgreich abgeschlossen und eine Interaktion ist weiterhin möglich. Ein session.error-Ereignis wird ausgegeben, das den MCP-Authentifizierungsfehler beschreibt. Sie können entscheiden, ob Sie weitere Interaktionen bei diesem Fehler blockieren, eine Aktualisierung der Anmeldedaten auslösen oder die Sitzung ohne den MCP fortsetzen möchten. Authentifizierungswiederholungen erfolgen beim folgenden Übergang von session.status_idle zu session.status_running. Weitere Informationen zum Verarbeiten von session.error und anderen Ereignissen finden Sie unter Sitzungsereignisstrom.

Unterstützte MCP-Servertypen

Claude Managed Agents verbindet sich mit Remote-MCP-Servern, die einen HTTP-Endpunkt bereitstellen. Der Server muss den streamfähigen HTTP-Transport des MCP-Protokolls unterstützen.

Weitere Informationen zu MCP und zum Erstellen von MCP-Servern finden Sie in der MCP-Dokumentation.

agent_response=$(curl -sS --fail-with-body https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "GitHub Assistant",
  "model": "claude-sonnet-4-6",
  "mcp_servers": [
    {
      "type": "url",
      "name": "github",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  ],
  "tools": [
    {"type": "agent_toolset_20260401"},
    {"type": "mcp_toolset", "mcp_server_name": "github"}
  ]
}
EOF
)
agent_id=$(jq -r '.id' <<<"$agent_response")

session_response=$(curl -sS --fail-with-body https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<EOF
{
  "agent": "$agent_id",
  "environment_id": "$environment_id",
  "vault_ids": ["$vault_id"]
}
EOF
)
session_id=$(jq -r '.id' <<<"$session_response")