MCP-Serverziele

MCP-Server bieten lokale Tools, Datenzugriff oder benutzerdefinierte Funktionen für Ihre Interaktionen mit Modellen und Agenten in Bedrock. AgentCore In Bedrock AgentCore können Sie bei der Erstellung eines Gateways einen vorkonfigurierten MCP-Server als Ziel definieren.

MCP-Server hosten Tools, Eingabeaufforderungen und Ressourcen, die Agenten erkennen und verwenden können. In Bedrock verwenden Sie ein Gateway AgentCore, um Ziele mit diesen Funktionen zu verknüpfen und sie mit Ihrer Agenten-Laufzeit zu verbinden. Sie stellen eine Verbindung zu externen MCP-Servern über die SynchronizeGatewayTargets API her, die Protokoll-Handshakes durchführt und verfügbare Funktionen indexiert. Weitere Informationen zur Installation und Verwendung von MCP-Servern finden Sie unter Amazon Bedrock AgentCore MCP Server: Vibe-Codierung mit Ihrem Programmierassistenten.

Wichtigste Überlegungen und Einschränkungen

Auflistungsmodus

ListingMode kann für MCP-Serverziele entweder als DYNAMIC oder DEFAULT festgelegt werden.

Implizite Synchronisation

Bei Zielen im DEFAULT-Modus lösen UpdateGatewayTarget Operationen automatisch die Erkennung CreateGatewayTarget und Indizierung von Fähigkeiten aus. Wenn einer der beiden Operationen aufgerufen wird, ruft Gateway die verfügbaren Tools mithilfe der tools/list MCP-Fähigkeiten ab, fordert die Verwendung von prompts/list Ressourcen mit und auf resources/list und resources/templates/list fügt die zurückgegebenen Funktionen dem einheitlichen Katalog hinzu.

Explizite Synchronisation

Funktionskataloge für Ziele im DEFAULT-Modus können manuell aktualisiert werden, indem die SynchronizeGatewayTargets API aufgerufen wird. Wenn sie aufgerufen wird, aktualisiert sie die Liste der verfügbaren Funktionen des Gateways. Sie sollten die API jederzeit aufrufen, wenn sich das Tool, die Eingabeaufforderung oder die Ressourcendefinitionen eines MCP-Servers ändern.

Die Synchronisation ist bei der Integration von MCP-Servern ein entscheidender Mechanismus für die Aufrechterhaltung genauer Funktionskataloge. Die implizite Synchronisation erfolgt automatisch bei der Erstellung und Aktualisierung von Zielen. Dabei erkennt und indexiert Gateway sofort Tools, Eingabeaufforderungen und Ressourcen vom MCP-Server, um sicherzustellen, dass Funktionen für die semantische Suche und die einheitliche Auflistung verfügbar sind. Die explizite Synchronisation erfolgt bei Bedarf über die SynchronizeGatewayTargets API, sodass der MCP-Fähigkeitskatalog erkannt werden kann, wenn MCP-Server ihre Funktionen unabhängig voneinander ändern.

Wann sollte ich anrufen SynchronizeGatewayTargets

Immer wenn der Listing-Modus eines MCP-Serverziels auf DEFAULT gesetzt ist, verwenden Sie die SynchronizeGatewayTargets API, nachdem Tools, Eingabeaufforderungen oder Ressourcen hinzugefügt, entfernt oder geändert wurden. Da Gateway Vektoreinbettungen für die semantische Suche im Voraus berechnet und normalisierte Funktionskataloge verwaltet, ist eine Synchronisation erforderlich, um sicherzustellen, dass Ihre Benutzer die neuesten verfügbaren Tools, Eingabeaufforderungen und Ressourcen finden und aufrufen können.

Wie ruft man die API auf

Stellen Sie eine PUT-Anfrage an /gateways/ {gatewayIdentifier} /synchronize mit der Ziel-ID im Anfragetext. Die API gibt sofort eine 202-Antwort zurück und verarbeitet die Synchronisation asynchron. Überwachen Sie den Zielstatus, GetGatewayTarget um den Fortschritt der Synchronisation nachzuverfolgen, da der Vorgang bei großen Funktionsumfängen mehrere Minuten dauern kann.

Autorisierungsstrategie

Die folgenden Arten der Autorisierungsstrategie werden unterstützt.

Überlegungen zur Konfiguration von MCP-Serverzielen

Folgendes muss konfiguriert werden.

Mithilfe des Autorisierungscodeflusses eine Verbindung zu einem OAuth-protected MCP-Server herstellen

Um den Gewährungstyp Autorisierungscode (dreibeiniges OAuth) für MCP-Serverziele zu unterstützen, bietet Amazon Bedrock AgentCore Gateway zwei Methoden für die Zielerstellung.

Implizite Synchronisierung bei der Erstellung des MCP-Serverziels

Bei dieser Methode schließt der Admin-Benutzer den Ablauf des Autorisierungscodes bei CreateGatewayTarget SynchronizeGatewayTargets Vorgängen ab und verwendet dabei die in der Antwort zurückgegebene Autorisierungs-URL. UpdateGatewayTarget Auf diese Weise kann Amazon Bedrock AgentCore Gateway die Tools des MCP-Servers im Voraus erkennen und zwischenspeichern.

Stellen Sie das Schema bei der Erstellung des MCP-Serverziels im Voraus bereit

Bei dieser Methode geben Admin-Benutzer das Tool-Schema direkt während der CreateGatewayTarget UpdateGatewayTarget Operationen, die das mcpToolSchema Feld verwenden, an, anstatt dass Amazon Bedrock AgentCore Gateway es dynamisch vom MCP-Server abruft. Amazon Bedrock AgentCore Gateway analysiert das bereitgestellte Schema und speichert die Tooldefinitionen im Cache.

URL-Sitzungsbindung

Durch die URL-Sitzungsbindung für die OAuth 2.0-Autorisierung wird überprüft, ob der Benutzer, der die OAuth-Autorisierungsanfrage initiiert hat, derselbe Benutzer ist, der die Zustimmung erteilt hat. Nachdem der Benutzer seine Zustimmung erteilt hat, leitet der Browser zurück zu einer Rückgabe-URL, die auf dem Ziel mit einer eindeutigen Sitzungs-URI konfiguriert ist. Die Anwendung ist dann für den Aufruf der CompleteResourceTokenAuthAPI verantwortlich und präsentiert sowohl die Identität des Benutzers als auch den Sitzungs-URI. Amazon Bedrock AgentCore Identity überprüft, ob der Benutzer, der den Flow gestartet hat, derselbe Benutzer ist, der ihn abgeschlossen hat, bevor der Autorisierungscode gegen ein Zugriffstoken ausgetauscht wurde.

Dies verhindert ein Szenario, in dem ein Benutzer versehentlich die Autorisierungs-URL weitergibt und eine andere Person die Zustimmung abschließt, wodurch der falschen Partei Zugriffstoken gewährt würden. Die Autorisierungs-URL und der Sitzungs-URI sind nur für 10 Minuten gültig, wodurch das Zeitfenster für Missbrauch weiter eingeschränkt wird. Die Sitzungsbindung gilt während der Zielerstellung (implizite Synchronisierung) und beim Aufruf des Tools.

Konfigurieren von Berechtigungen

Die IAM-Rolle, die Sie zum Erstellen, Aktualisieren oder Synchronisieren von MCP-Serverzielen verwenden, sollte über die im folgenden Beispiel gezeigten Berechtigungen verfügen.

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