Connettore MCP

Claude Managed Agents supporta la connessione di server Model Context Protocol (MCP) ai tuoi agenti. Questo dà all'agente accesso a strumenti esterni, fonti di dati e servizi attraverso un protocollo standardizzato.

La configurazione MCP è divisa in due fasi:

Creazione dell'agente dichiara quali server MCP l'agente connette, per nome e URL.
Creazione della sessione fornisce l'autenticazione per quei server facendo riferimento a un vault pre-registrato.

Questa separazione mantiene i segreti fuori dalle definizioni di agenti riutilizzabili mentre consente a ogni sessione di autenticarsi con le proprie credenziali.

Tutte le richieste API di Managed Agents richiedono l'intestazione beta managed-agents-2026-04-01. L'SDK imposta automaticamente l'intestazione beta.

Dichiara server MCP sull'agente

Specifica i server MCP nell'array mcp_servers quando crei un agente. Ogni server ha bisogno di un type, un name univoco e un url. Nessun token di autenticazione viene fornito in questa fase.

Il name che assegni nell'array del server MCP viene utilizzato per fare riferimento alle voci mcp_toolset nell'array degli strumenti.

Il toolset MCP utilizza per impostazione predefinita una politica di autorizzazione di always_ask, che richiede l'approvazione dell'utente prima di ogni chiamata dello strumento. Vedi politiche di autorizzazione per configurare questo comportamento.

Fornisci l'autenticazione alla creazione della sessione

Quando avvii una sessione, passa vault_ids per fornire credenziali per i tuoi server MCP. I vault sono raccolte di credenziali che registri una volta e a cui fai riferimento per ID. Vedi Autenticazione con vault per come creare vault e gestire le credenziali.

Se le credenziali di autorizzazione fornite nel vault non sono valide, la creazione della sessione avrà successo e l'interazione è ancora possibile. Un evento session.error viene emesso descrivendo l'errore di autenticazione MCP. Puoi decidere se bloccare ulteriori interazioni su questo errore, attivare un aggiornamento delle credenziali o consentire alla sessione di continuare senza l'MCP. I tentativi di autenticazione avverranno alla transizione successiva da session.status_idle a session.status_running. Vedi Flusso di eventi della sessione per i dettagli sul consumo di session.error e altri eventi.

Tipi di server MCP supportati

Claude Managed Agents si connette a server MCP remoti che espongono un endpoint HTTP. Il server deve supportare il trasporto HTTP trasmissibile del protocollo MCP.

Per ulteriori informazioni su MCP e sulla creazione di server MCP, vedi la documentazione MCP.

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")