Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Cibles des serveurs MCP

Les serveurs MCP fournissent des outils locaux, un accès aux données ou des fonctions personnalisées pour vos interactions avec les modèles et les agents dans AgentCore Bedrock. Dans Bedrock AgentCore, vous pouvez définir un serveur MCP préconfiguré comme cible lors de la création d'une passerelle.

Les serveurs MCP hébergent des outils, des instructions et des ressources que les agents peuvent découvrir et utiliser. Dans Bedrock AgentCore, vous utilisez une passerelle pour associer des cibles à ces fonctionnalités et les connecter à l'environnement d'exécution de votre agent. Vous vous connectez à des serveurs MCP externes via l'SynchronizeGatewayTargetsAPI qui effectue des échanges de protocoles et indexe les fonctionnalités disponibles. Pour plus d'informations sur l'installation et l'utilisation de serveurs MCP, consultez Amazon Bedrock AgentCore MCP Server : codage Vibe avec votre assistant de codage.

Principales considérations et limites

Mode de mise en vente

ListingMode peut être défini sur DYNAMIC ou DEFAULT pour les cibles des serveurs MCP.

Synchronisation implicite

Pour les cibles en mode DEFAULT, CreateGatewayTarget les UpdateGatewayTarget opérations déclenchent automatiquement la découverte et l'indexation des capacités. Lorsque l'une ou l'autre des opérations est appelée, Gateway extrait les outils disponibles à l'aide de la tools/list fonctionnalité de MCPprompts/list, invite les ressources utilisant resources/list et resources/templates/list et ajoute les fonctionnalités renvoyées au catalogue unifié.

Synchronisation explicite

Les catalogues de fonctionnalités pour les cibles en mode DEFAULT peuvent être actualisés manuellement en appelant l'SynchronizeGatewayTargetsAPI. Lorsqu'il est appelé, il met à jour la liste des fonctionnalités disponibles de la passerelle. Vous devez appeler l'API chaque fois que les définitions de ressources d'un outil, d'une invite ou d'un outil d'un serveur MCP sont modifiées.

La synchronisation est un mécanisme essentiel pour maintenir des catalogues de fonctionnalités précis lors de l'intégration de serveurs MCP. La synchronisation implicite se produit automatiquement lors de la création et des mises à jour de la cible, au cours de laquelle Gateway découvre et indexe immédiatement les outils, les invites et les ressources du serveur MCP afin de garantir la disponibilité des fonctionnalités de recherche sémantique et de liste unifiée. La synchronisation explicite est effectuée à la demande via l'SynchronizeGatewayTargetsAPI, ce qui permet de découvrir le catalogue de fonctionnalités MCP lorsque les serveurs MCP modifient leurs fonctionnalités indépendamment.

Quand appeler SynchronizeGatewayTargets

Chaque fois que le mode de liste d'une cible de serveur MCP est défini sur DEFAULT, utilisez l'SynchronizeGatewayTargetsAPI après avoir ajouté, supprimé ou modifié des outils, des invites ou des ressources. Comme Gateway précalcule les intégrations vectorielles pour la recherche sémantique et gère des catalogues de fonctionnalités normalisés, la synchronisation est nécessaire pour permettre à vos utilisateurs de découvrir et d'invoquer les derniers outils, instructions et ressources disponibles.

Comment appeler l'API

Envoyez une requête PUT à /gateways/ {gatewayIdentifier} /synchronize avec l'ID cible dans le corps de la demande. L'API renvoie immédiatement une réponse 202 et traite la synchronisation de manière asynchrone. Surveillez l'état de la cible GetGatewayTarget pour suivre la progression de la synchronisation, car l'opération peut prendre plusieurs minutes pour les ensembles de fonctionnalités volumineux.

Stratégie d'autorisation

Les types de stratégie d'autorisation suivants sont pris en charge.

Considérations relatives à la configuration pour les cibles de serveurs MCP

Les paramètres suivants doivent être configurés.

On-behalf-of considérations relatives à l'échange de jetons

Les limites suivantes s'appliquent lorsque vous utilisez un échange de jetons pour le compte (le type d'TOKEN_EXCHANGEautorisation) comme autorisation sortante pour une cible de serveur MCP :

Sécurisation de l'état de la demande pour l'élicitation et l'échantillonnage (version 2026-07-28 et versions ultérieures)

Sur les versions 2026-07-28 et les versions ultérieures, l'élicitation et l'échantillonnage utilisent le modèle MRTR (multi-demandes aller-retour). La cible de votre serveur MCP génère la requestState valeur dans un input_required résultat ; la passerelle considère cette valeur comme opaque. La passerelle ne stocke pas lerequestState. Il conserve la valeur en mémoire uniquement tout en la transférant inchangée entre votre client et la cible de votre serveur MCP, et la supprime une fois la demande terminée.

AgentCore Gateway et la cible de votre serveur MCP partagent la responsabilité de la sécurisation de l'état de la demande :

Pour protéger l'état de la demande, suivez les instructions de la spécification MCP. Chiffrez ou signez l'état (par exemple, avec AES-GCM ou un JWT signé) pour garantir la confidentialité et l'intégrité. Liez l'état spécifique à l'utilisateur d'origine, faites expirer l'état et traitez toutes les valeurs d'état en texte brut comme des entrées non fiables. Pour plus d'informations, consultez la section Demandes aller-retour multiples sur le site Web du Model Context Protocol.

Connexion à un serveur OAuth-protected MCP à l'aide du flux de code d'autorisation

Pour prendre en charge le type d'octroi de code d'autorisation (OAuth à trois branches) avec les cibles de serveur MCP, Amazon Bedrock AgentCore Gateway propose deux méthodes de création de cibles.

Synchronisation implicite lors de la création de la cible du serveur MCP

Avec cette méthode, l'utilisateur administrateur complète le flux de code d'autorisation pendant ou pendant CreateGatewayTarget les UpdateGatewayTarget SynchronizeGatewayTargets opérations à l'aide de l'URL d'autorisation renvoyée dans la réponse. Cela permet à Amazon Bedrock AgentCore Gateway de découvrir et de mettre en cache les outils du serveur MCP dès le départ.

Fournir le schéma dès le départ lors de la création de la cible du serveur MCP

Avec cette méthode, les administrateurs fournissent le schéma de l'outil directement pendant CreateGatewayTarget ou pendant les UpdateGatewayTarget opérations utilisant le mcpToolSchema champ, au lieu qu'Amazon Bedrock AgentCore Gateway ne le récupère dynamiquement depuis le serveur MCP. Amazon Bedrock AgentCore Gateway analyse le schéma fourni et met en cache les définitions des outils.

Liaison de session URL

La liaison de session d'URL d'autorisation OAuth 2.0 vérifie que l'utilisateur qui a lancé la demande d'autorisation OAuth est le même que celui qui a donné son consentement. Une fois que l'utilisateur a donné son consentement, le navigateur est redirigé vers une URL de retour configurée sur la cible avec un URI de session unique. L'application est ensuite chargée d'appeler l'CompleteResourceTokenAuthAPI, en présentant à la fois l'identité de l'utilisateur et l'URI de la session. Amazon Bedrock AgentCore Identity confirme que l'utilisateur qui a lancé le flux est le même que celui qui l'a terminé avant d'échanger le code d'autorisation contre un jeton d'accès.

Cela permet d'éviter le scénario dans lequel un utilisateur partage accidentellement l'URL d'autorisation et où quelqu'un d'autre complète le consentement, ce qui accorderait des jetons d'accès à la mauvaise partie. L'URL d'autorisation et l'URI de session ne sont valides que pendant 10 minutes, ce qui limite encore la fenêtre en cas d'utilisation abusive. La liaison de session s'applique lors de la création de la cible (synchronisation implicite) et lors de l'appel de l'outil.

Configuration des autorisations

Le rôle IAM que vous utilisez pour créer, mettre à jour ou synchroniser les cibles des serveurs MCP doit disposer des autorisations indiquées dans l'exemple suivant.

{
"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/*"
        }
    ]
}