Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Obiettivi dei server MCP

I server MCP forniscono strumenti locali, accesso ai dati o funzioni personalizzate per le interazioni con modelli e agenti in Bedrock. AgentCore In Bedrock AgentCore, è possibile definire un server MCP preconfigurato come destinazione durante la creazione di un gateway.

I server MCP ospitano strumenti, prompt e risorse che gli agenti possono scoprire e utilizzare. In Bedrock AgentCore, si utilizza un gateway per associare gli obiettivi a queste funzionalità e collegarli al runtime dell'agente. Vi connettete a server MCP esterni tramite l'SynchronizeGatewayTargetsAPI che esegue gli handshake del protocollo e indicizza le funzionalità disponibili. Per ulteriori informazioni sull'installazione e l'utilizzo dei server MCP, consulta Amazon Bedrock AgentCore MCP Server: Vibe coding with your coding assistant.

Considerazioni e limitazioni principali

Modalità di quotazione

ListingMode può essere impostato come DYNAMIC o DEFAULT per le destinazioni del server MCP.

Sincronizzazione implicita

Per le destinazioni in modalità DEFAULT, UpdateGatewayTarget le operazioni attivano automaticamente il rilevamento CreateGatewayTarget e l'indicizzazione delle capacità. Quando viene richiamata una delle due operazioni, Gateway recupera gli strumenti disponibili utilizzando la tools/list funzionalità di MCP, ne richiede l'utilizzoprompts/list, l'utilizzo delle risorse resources/list e resources/templates/list aggiunge le funzionalità restituite al catalogo unificato.

Sincronizzazione esplicita

I cataloghi di funzionalità per Target in modalità DEFAULT possono essere aggiornati manualmente chiamando l'API. SynchronizeGatewayTargets Quando viene chiamato, aggiorna l'elenco delle funzionalità disponibili del Gateway. È necessario chiamare l'API ogni volta che le definizioni degli strumenti, del prompt e delle risorse di un server MCP cambiano.

La sincronizzazione è un meccanismo fondamentale per mantenere cataloghi di funzionalità accurati durante l'integrazione dei server MCP. La sincronizzazione implicita avviene automaticamente durante la creazione e gli aggiornamenti degli obiettivi, in cui Gateway rileva e indicizza immediatamente strumenti, prompt e risorse dal server MCP per garantire la disponibilità delle funzionalità per la ricerca semantica e l'elenco unificato. La sincronizzazione esplicita viene eseguita su richiesta tramite l'SynchronizeGatewayTargetsAPI, consentendo l'individuazione del catalogo delle funzionalità MCP quando i server MCP modificano le proprie funzionalità in modo indipendente.

Quando chiamare SynchronizeGatewayTargets

Ogni volta che una destinazione del server MCP ha la modalità di elenco impostata su DEFAULT, utilizzate l'SynchronizeGatewayTargetsAPI dopo aver aggiunto, rimosso o modificato strumenti, prompt o risorse. Poiché Gateway precalcola gli incorporamenti vettoriali per la ricerca semantica e mantiene cataloghi di funzionalità normalizzati, la sincronizzazione è necessaria per garantire che gli utenti possano scoprire e richiamare gli strumenti, i prompt e le risorse più recenti disponibili.

Come chiamare l'API

Effettua una richiesta PUT a /gateways/ {gatewayIdentifier} /synchronize con l'ID di destinazione nel corpo della richiesta. L'API restituisce immediatamente una risposta 202 ed elabora la sincronizzazione in modo asincrono. Monitora lo stato dell'obiettivo GetGatewayTarget per tenere traccia dell'avanzamento della sincronizzazione, poiché l'operazione può richiedere diversi minuti per set di funzionalità di grandi dimensioni.

Strategia di autorizzazione

Sono supportati i seguenti tipi di strategia di autorizzazione.

Considerazioni sulla configurazione per le destinazioni dei server MCP

È necessario configurare quanto segue.

On-behalf-of considerazioni sullo scambio di token

Le seguenti limitazioni si applicano quando si utilizza lo scambio di token per conto di un server MCP (il tipo di TOKEN_EXCHANGE concessione) come autorizzazione in uscita per una destinazione del server MCP:

Protezione dello stato della richiesta per l'elicitazione e il campionamento (versione 2026-07-28 e successive)

Nelle versioni successive, l'elicitazione 2026-07-28 e il campionamento utilizzano il modello MRTR (Multi Round-Trip Request). La destinazione del server MCP genera il requestState valore in un input_required risultato; il gateway considera questo valore come opaco. Il gateway non memorizza il. requestState Mantiene il valore in memoria solo mentre lo inoltra invariato tra il client e il server di destinazione MCP e lo elimina quando la richiesta viene completata.

AgentCore Gateway e la destinazione del server MCP condividono la responsabilità della protezione dello stato della richiesta:

Per proteggere lo stato della richiesta, seguite le indicazioni contenute nelle specifiche MCP. Crittografa o firma lo stato (ad esempio, con AES-GCM o un JWT firmato) per garantire riservatezza e integrità. Associa lo stato specifico dell'utente all'utente di origine, fa scadere lo stato e considera qualsiasi valore di stato in testo normale come input non attendibile. Per ulteriori informazioni, consulta Richieste multiple di andata e ritorno sul sito Web Model Context Protocol.

Connessione a un server OAuth-protected MCP utilizzando il flusso del codice di autorizzazione

Per supportare il tipo di concessione del codice di autorizzazione (OAuth a tre fasi) con destinazioni server MCP, Amazon Bedrock AgentCore Gateway offre due metodi per la creazione degli obiettivi.

Sincronizzazione implicita durante la creazione del target del server MCP

Con questo metodo, l'utente amministratore completa il flusso del codice di autorizzazione durante o durante CreateGatewayTarget le UpdateGatewayTarget SynchronizeGatewayTargets operazioni utilizzando l'URL di autorizzazione restituito nella risposta. Ciò consente ad Amazon Bedrock AgentCore Gateway di scoprire e memorizzare nella cache gli strumenti del server MCP in anticipo.

Fornisci lo schema in anticipo durante la creazione della destinazione del server MCP

Con questo metodo, gli utenti amministratori forniscono lo schema dello strumento direttamente durante CreateGatewayTarget UpdateGatewayTarget le operazioni che utilizzano il mcpToolSchema campo, anziché Amazon Bedrock AgentCore Gateway che lo recupera dinamicamente dal server MCP. Amazon Bedrock AgentCore Gateway analizza lo schema fornito e memorizza nella cache le definizioni degli strumenti.

Associazione di sessioni URL

L'associazione di sessione URL di autorizzazione OAuth 2.0 verifica che l'utente che ha avviato la richiesta di autorizzazione OAuth sia lo stesso utente che ha concesso il consenso. Dopo che l'utente ha completato il consenso, il browser reindirizza a un URL di ritorno configurato sulla destinazione con un URI di sessione univoco. L'applicazione è quindi responsabile della chiamata all'CompleteResourceTokenAuthAPI, presentando sia l'identità dell'utente che l'URI della sessione. Amazon Bedrock AgentCore Identity verifica che l'utente che ha avviato il flusso sia lo stesso utente che lo ha completato prima di scambiare il codice di autorizzazione con un token di accesso.

In questo modo si evita che un utente condivida accidentalmente l'URL di autorizzazione e qualcun altro completi il consenso, il che concederebbe i token di accesso alla parte sbagliata. L'URL di autorizzazione e l'URI di sessione sono validi solo per 10 minuti, limitando ulteriormente la finestra per un uso improprio. L'associazione di sessione si applica durante la creazione del target (sincronizzazione implicita) e durante l'invocazione dello strumento.

Configurazione delle autorizzazioni

Il ruolo IAM utilizzato per creare, aggiornare o sincronizzare le destinazioni dei server MCP deve avere le autorizzazioni mostrate nell'esempio seguente.

{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateGateway",
                "bedrock-agentcore:GetGateway",
                "bedrock-agentcore:CreateGatewayTarget",
                "bedrock-agentcore:GetGatewayTarget",
                "bedrock-agentcore:SynchronizeGatewayTargets",
                "bedrock-agentcore:UpdateGatewayTarget"
            ],
            "Resource": "arn:aws:bedrock-agentcore:*:*:*gateway*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateWorkloadIdentity",
                "bedrock-agentcore:GetWorkloadAccessToken",
                "bedrock-agentcore:GetWorkloadAccessTokenForUserId",
                "bedrock-agentcore:GetResourceOauth2Token",
                "bedrock-agentcore:GetResourceApiKey",
                "bedrock-agentcore:CompleteResourceTokenAuth",
                "secretsmanager:GetSecretValue"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "kms:EnableKeyRotation",
                "kms:Decrypt",
                "kms:Encrypt",
                "kms:GenerateDataKey*",
                "kms:ReEncrypt*",
                "kms:CreateAlias",
                "kms:DisableKey",
                "kms:*"
            ],
            "Resource": "arn:aws:kms:*:123456789012:key/*"
        }
    ]
}