Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Verwenden von MCP mit Amazon Q Developer
Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Assistenten ermöglicht, mit externen Tools und Services zu interagieren. Amazon Q Developer CLI unterstützt jetzt MCP, sodass Sie die Funktionen von Q erweitern können, indem Sie es mit benutzerdefinierten Tools und Services verbinden.
Themen
MCP-Konfiguration
Deaktivieren von MCP für Ihre Organisation
Abhängig von Ihrer Konfiguration haben Sie möglicherweise die Möglichkeit, MCP-Server für Ihr AWS Konto oder Ihre Organisation in der Amazon Q Developer Console zu deaktivieren. Dies gilt in folgenden Fällen:
Sie verwalten eine Organisation von Ihrem Verwaltungskonto aus oder verwenden ein eigenständiges Konto.
Sie verwenden Amazon Q Developer in einer unterstützten IDE.
Anmerkung
Diese Einstellung wird auf der Clientseite erzwungen. Seien Sie sich bewusst, dass Ihre Endbenutzer sie umgehen könnten.
So deaktivieren Sie MCP in Ihrem Konto oder Ihrer Organisation:
Öffnen Sie die Konsole von Amazon Q Developer.
Wählen Sie Einstellungen aus.
Wählen Sie unter Einstellungen die Option Bearbeiten aus.
Schalten Sie im Popup-Fenster Einstellungen bearbeiten die Option Model Context Protocol (MCP) um.
Wählen Sie Speichern.
Einrichten von MCP-Servern mit der Q CLI
Die global definierte MCP-Konfiguration für Amazon Q CLI wird unter folgender Adresse abgewickelt:
~/.aws/amazonq/cli-agents
Amazon Q Developer CLI unterstützt sowohl lokale MCP-Server (die als Prozesse ausgeführt werden) als auch Remote-MCP-Server (die über HTTP kommunizieren). Remoteserver können OAuth Authentifizierung verwenden oder geöffnet sein, ohne dass eine Authentifizierung erforderlich ist.
Weitere Informationen finden Sie im Leitfaden zur Konfiguration benutzerdefinierter Agenten im Q CLI Github-Repo
Einrichten von MCP-Servern mit Q in der IDE
Die global definierte MCP-Konfiguration für Amazon Q in der IDE wird wie folgt verwaltet:
~/.aws/amazonq/agents/default.json
Weitere Informationen finden Sie unter MCP-Konfiguration für Q Developer in der IDE.
Der MCP-Server wird geladen.
Amazon Q lädt MCP-Server im Hintergrund, sodass Sie sofort mit der Interaktion beginnen können, ohne auf die Initialisierung aller Server warten zu müssen. Tools werden nach und nach verfügbar, sobald der Ladevorgang der jeweiligen Server abgeschlossen ist.
Überprüfen des Serverstatus
Sie können den Befehl /tools verwenden, um zu sehen, welche Server noch geladen werden und welche Tools bereits verfügbar sind.
Konfigurieren der Serverinitialisierung
Sie können das Timeout für die Serverinitialisierung wie folgt anpassen:
$ q settings mcp.initTimeout [value]
Wobei [value] das Timeout in Millisekunden ist. Diese Einstellung steuert, wie lange Amazon Q auf die Initialisierung der Server wartet, bevor Sie mit der Interaktion beginnen können.
Tools und Prompts
In diesem Abschnitt wird beschrieben, wie Sie MCP-Tools und -Prompts mit Amazon Q Developer CLI verwenden.
Grundlegendes zu MCP-Tools
MCP-Tools sind ausführbare Funktionen, die MCP-Server der Amazon Q Developer CLI zur Verfügung stellen. Sie ermöglichen es Amazon Q Developer, in Ihrem Namen Aktionen durchzuführen, Daten zu verarbeiten und mit externen Systemen zu interagieren.
Jedes Tool in MCP weist folgende Eigenschaften auf:
-
Name: eine eindeutige Kennung für das Tool
-
Beschreibung: eine für Menschen lesbare Beschreibung der Funktionen des Tools
-
Eingabeschema: ein JSON-Schema, das die Parameter definiert, die das Tool akzeptiert
-
Anmerkungen: optionale Hinweise zum Verhalten und zu den Auswirkungen des Tools
Entdecken von verfügbaren Tools
So sehen Sie, welche Tools in Ihrer Q-CLI-Sitzung verfügbar sind:
/tools
Mit diesem Befehl werden alle verfügbaren Tools angezeigt, einschließlich der integrierten Tools und der Tools, die von MCP-Servern bereitgestellt werden.
Tools können unterschiedliche Berechtigungsstufen haben, die bestimmen, wie sie verwendet werden:
-
Automatisch genehmigt: Diese Tools können ohne ausdrückliche Genehmigung für jeden Aufruf verwendet werden.
-
Genehmigung erforderlich: Für diese Tools ist bei jeder Verwendung Ihre ausdrückliche Genehmigung erforderlich.
-
Gefährlich: Diese Tools sind als potenziell riskant gekennzeichnet und müssen vor der Genehmigung sorgfältig geprüft werden.
Verwenden von Tools
Sie können MCP-Tools auf zwei Arten verwenden:
-
Abfragen in natürlicher Sprache: Beschreiben Sie einfach, was Sie tun möchten, und Q bestimmt, welches Tool Sie verwenden.
-
Direkter Toolaufruf: Sie können Q auch explizit auffordern, ein bestimmtes Tool zu verwenden.
Arbeiten mit Prompts
MCP-Server können vordefinierte Prompts bereitstellen, die Q bei bestimmten Aufgaben unterstützen:
-
Auflisten verfügbarer Prompts:
/prompts -
Verwenden eines Prompts:
-
@prompt-namearg1 arg2
-
Beispiel für die Verwendung eines Prompts mit Argumenten:
@fetch https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html
Wichtigste Vorteile
-
Erweiterbarkeit: Verbinden Sie Amazon Q mit speziellen Tools für bestimmte Domains oder Workflows.
-
Anpassung: Erstellen Sie maßgeschneiderte Tools, die auf Ihre spezifischen Bedürfnisse zugeschnitten sind.
-
Ökosystemintegration: Nutzen Sie das wachsende Ökosystem MCP-kompatibler Tools.
-
Standardisierung: Verwenden Sie ein konsistentes Protokoll, das von mehreren KI-Assistenten unterstützt wird.
-
Flexibilität: MCP ermöglicht es Ihnen, zwischen verschiedenen LLM-Anbietern zu wechseln und gleichzeitig dieselben Toolintegrationen beizubehalten
-
Sicherheit: Behalten Sie Ihre Daten mit lokalen MCP-Servern innerhalb Ihrer Infrastruktur.
MCP-Architektur
MCP folgt einer Client-Server-Architektur:
-
MCP-Hosts: Programme wie Amazon Q Developer CLI, die über MCP auf Daten zugreifen möchten
-
MCP-Clients: Protokollclients, die 1:1-Verbindungen mit Servern aufrechterhalten
-
MCP-Server: einfache Programme, die jeweils über das standardisierte Model Context Protocol spezifische Funktionen bereitstellen
-
Lokale Datenquellen: die Dateien, Datenbanken und Services Ihres Computers, auf die MCP-Server sicher zugreifen können
-
Remote-Services: Externe Systeme, die über das Internet verfügbar sind (z. B. über APIs) und mit denen MCP-Server eine Verbindung herstellen können
Beispiel MCP-Kommunikationsfluss
User | v +------------------+ +-----------------+ +------------------+ | | | | | | | Amazon Q Dev | --> | MCP Client API | --> | MCP Server | | | | | | | +------------------+ +-----------------+ +------------------+ | v +------------------+ | | | External Service | | | +------------------+
Kommunikationsfluss zwischen dem Benutzer, der Amazon Q Developer CLI und externen Services über MCP
MCP-Schlüsselkonzepte
Tools
Tools sind ausführbare Funktionen, die MCP-Server den Clients zur Verfügung stellen. Sie ermöglichen Amazon Q Folgendes:
-
Ausführen von Aktionen in externen Systemen
-
Verarbeiten von Daten auf spezielle Weise
-
Interagieren Sie mit APIs und Diensten
-
Ausführen von Befehlen in Ihrem Namen
Tools werden mit einem eindeutigen Namen, einer Beschreibung, einem Eingabeschema (unter Verwendung des JSON-Schemas) und optionalen Anmerkungen zum Verhalten des Tools definiert.
Prompts
Prompts sind vordefinierte Vorlagen, die Amazon Q bei bestimmten Aufgaben unterstützen. Sie können Folgendes:
-
Akzeptieren von dynamischen Argumenten
-
Einbeziehen von Kontext aus Ressourcen
-
Verketten mehrerer Interaktionen
-
Leiten spezifischer Workflows
-
Erscheinen als Benutzeroberflächenelemente (wie Slash-Befehle)
Ressourcen
Ressourcen stellen Daten dar, die MCP-Server Amazon Q zur Verfügung stellen können, z. B.:
-
Dateiinhalte
-
Datensätze in der Datenbank
-
API-Antworten
-
Dokumentation
-
Konfigurationsdaten
