Connettore MCP

MCP connector

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_ID=$(ant beta:agents create \
  --name "GitHub Assistant" \
  --model claude-opus-4-7 \
  --mcp-server '{type: url, name: github, url: "https://api.githubcopilot.com/mcp/"}' \
  --tool '{type: agent_toolset_20260401}' \
  --tool '{type: mcp_toolset, mcp_server_name: github}' \
  --transform id --raw-output)