MCP-Konfiguration für Q Developer in der IDE - Amazon Q Developer
MCP IDE-KonfigurationsdateienZugriff auf die BenutzeroberflächeHinzufügen eines MCP-ServersFehlerbehebung bei der MCP-KonfigurationAktivieren eines MCP-ServersDeaktivieren eines MCP-ServersLöschen eines MCP-Servers, der derzeit aktiviert istLöschen eines MCP-Servers, der derzeit deaktiviert istÜberprüfen und Anpassen der Toolberechtigungen

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.

MCP-Konfiguration für Q Developer in der IDE

Diese Seite behandelt IDE-spezifische Optionen für die Konfiguration von MCP-Servern.

Grundlegendes zu MCP-Konfigurationsdateien für Q Developer in der IDE

Wenn Sie die GUI verwenden, um Q Developer in der IDE einen MCP-Server hinzuzufügen, wird die Konfiguration in einer von zwei Dateien gespeichert:

  • Im globalen Bereich: ~/. aws/amazonq/default.json

  • Im lokalen Bereich: .amazonq/default.json

Aus älteren Gründen ist es jedoch auch möglich, MCP-Konfigurationsinformationen an zwei anderen Orten zu speichern:

  • Auf globaler Ebene: ~/. aws/amazonq/mcp.json

  • Auf lokaler Ebene: .amazonq/mcp.json

Q Developer räumt Konfigurationen auf Workspace-Ebene für MCP-Server, deren Berechtigungen und gespeicherten Einstellungen Vorrang ein.

Anmerkung

Wenn Sie bereits eine MCP-Konfiguration in einer mcp.json-Datei eingerichtet haben und die MCP-Konfigurations-GUI zum ersten Mal verwenden, wird Ihnen diese Konfiguration in der GUI angezeigt.

Die Support für ältere mcp.json-Dateien wird durch das useLegacyMcp Json-Feld in Ihrer globalen default.json-Konfigurationsdatei aktiviert. Standardmäßig ist dieses Feld auf true gesetzt. Weitere Informationen finden Sie unter UseLegacyMcpJson Field im Q Developer CLI GitHub Repo.

Beachten Sie, dass die mcp.json-Dateien auch von der Q-CLI verwendet werden können.

Informationen zum Einstellen detaillierter Steuerungen für MCP-Tools finden Sie in der Referenz zu integrierten Tools.

Zugriff auf die MCP-Konfigurationsoberfläche

So greifen Sie auf die MCP-Konfigurationsoberfläche in Q Developer in der IDE zu:

  1. Öffnen Sie Ihre IDE (VS Code JetBrains usw.).

  2. Öffnen Sie das Q-Developer-Panel.

  3. Öffnen Sie das Chat-Panel.

  4. Wählen Sie das Symbol Werkzeuge aus. tools icon

Hinzufügen eines MCP-Servers

Es gibt zwei primäre Transportmechanismen für die Kommunikation zwischen KI-Clients und MCP-Servern: STDIO und HTTP.

Hinzufügen eines HTTP-MCP-Servers

So fügen Sie der IDE einen HTTP-MCP-Server hinzu:

  1. Greifen Sie auf die MCP-Konfigurationsoberfläche zu.

  2. Wählen Sie das Pluszeichen (+) aus.

  3. Wählen Sie den Geltungsbereich aus: global oder lokal.

    Wenn Sie den globalen Geltungsbereich auswählen, wird die MCP-Serverkonfiguration in ~/ gespeichert. aws/amazonq/default.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/default.json in Ihrem aktuellen Projekt.

  4. Geben Sie im Feld Name den Namen des MCP-Servers ein.

  5. Wählen Sie http als Transportprotokoll aus.

  6. Geben Sie im Feld URL die URL ein, die der MCP-Server bei der Initialisierung aufruft.

  7. Unter Header – optional können Sie Schlüssel-Wert-Paare eingeben, die als HTTP-Anforderungsheader gesendet werden müssen.

  8. Geben Sie gegebenenfalls einen Timeout-Wert ein.

  9. Wählen Sie Speichern.

    Das Konfigurationsfenster wird durch das Fenster mit den Werkzeugberechtigungen ersetzt.

  10. Folgen Sie dem Verfahren unter Überprüfen und Anpassen der Toolberechtigungen.

Anmerkung

Wenn der MCP-HTTP-Endpunkt eine Autorisierung erfordert, öffnet Amazon Q automatisch eine Browserseite, sodass Sie Amazon Q autorisieren können, auf den MCP-Server zuzugreifen.

Hinzufügen eines STDIO-MCP-Servers

So fügen Sie der IDE einen STDIO-MCP-Server hinzu:

  1. Greifen Sie auf die MCP-Konfigurationsoberfläche zu.

  2. Wählen Sie das Pluszeichen (+) aus.

  3. Wählen Sie den Geltungsbereich aus: global oder lokal.

    Wenn Sie den globalen Bereich auswählen, wird die MCP-Serverkonfiguration in ~/ gespeichert. aws/amazonq/default.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/default.json in Ihrem aktuellen Projekt.

  4. Geben Sie im Feld Name den Namen des MCP-Servers ein.

    Wenn wir beispielsweise den AWS Documentation MCP Server installieren würden, könnte der Name lauten. AWS DocMCPServer

  5. Wählen Sie stdio als Transportprotokoll aus.

  6. Geben Sie im Feld Befehl den Shell-Befehl ein, den der MCP-Server bei seiner Initialisierung ausführen soll.

    Im Fall des AWS Documentation MCP Servers lautet der Befehl. uvx Dies ist ein Alias für uv tool run, mit dem eine flüchtige Python-Umgebung erstellt wird.

  7. Geben Sie im Feld Argumente ein Argument ein, das dem Shell-Befehl übergeben werden soll, falls zutreffend.

    Im Fall des AWS Documentation MCP Servers lautet das Argument. awslabs.aws-documentation-mcp-server@latest Dies ist eine Python-Paketkennung, die auf ein Paket verweist, das auf PyPI (Python Package Index) gehostet wird.

    Fügen Sie nach Bedarf weitere Argumente hinzu.

  8. Füllen Sie die Umgebungsvariablen nach Bedarf aus.

    In unserem Beispiel geben wir zuerst Name: FASTMCP_LOG_LEVEL und Value: ERROR ein.

    Wir werden den Namen AWS_DOCUMENTATION_PARTITION und den Wert auch verwendenaws, um die Partition anzugeben, mit der wir arbeiten werden.

  9. Geben Sie gegebenenfalls einen Timeout-Wert ein.

    In unserem Beispiel behalten wir den empfohlenen Wert von 60 (Sekunden) bei.

  10. Wählen Sie Speichern.

    Das Konfigurationsfenster wird durch das Fenster mit den Werkzeugberechtigungen ersetzt.

  11. Folgen Sie dem Verfahren unter Überprüfen und Anpassen der Toolberechtigungen.

Fehlerbehebung bei der MCP-Konfiguration

Nachdem Sie der IDE einen MCP-Server hinzugefügt haben, versucht Amazon Q, eine Verbindung mit diesem Server herzustellen.

Bei Verbindungsproblemen wird oben im Panel eine Warnung angezeigt. Die Tools dieses MCP-Servers funktionieren nicht ordnungsgemäß, solange die Warnung nicht behoben ist.

Wählen Sie Konfiguration korrigieren aus, um zum MCP-Konfigurationsbildschirm zurückzukehren, sodass Sie die entsprechenden Änderungen vornehmen können.

Aktivieren eines MCP-Servers

Beim folgenden Verfahren wird davon ausgegangen, dass der betreffende MCP-Server nicht bereits aktiviert ist.

So aktivieren Sie einen MCP-Server in der IDE:

  1. Öffnen Sie das MCP-Server-Panel.

  2. Wählen Sie neben dem Server, den Sie aktivieren möchten, die Option Aktivieren aus.

Deaktivieren eines MCP-Servers

So deaktivieren Sie einen MCP-Server in der IDE:

  1. Öffnen Sie das MCP-Server-Panel.

  2. Wählen Sie den Server aus, den Sie deaktivieren möchten.

  3. Wählen Sie die drei Punkte neben Konfiguration bearbeiten aus.

  4. Wählen Sie MCP-Server deaktivieren aus.

Löschen eines MCP-Servers, der derzeit aktiviert ist

So löschen Sie einen MCP-Server, der derzeit aktiviert ist, aus der IDE:

  1. Öffnen Sie das MCP-Server-Panel.

  2. Wählen Sie den Server aus, den Sie löschen möchten.

    Ein Fenster mit Details zu diesem Server wird geöffnet.

  3. Wählen Sie die drei Punkte neben Konfiguration bearbeiten aus.

  4. Wählen Sie MCP-Server löschen aus.

  5. Bestätigen Sie den Löschvorgang, wenn Sie dazu aufgefordert werden.

Löschen eines MCP-Servers, der derzeit deaktiviert ist

So löschen Sie einen MCP-Server, der derzeit deaktiviert ist, aus der IDE:

  1. Öffnen Sie das MCP-Server-Panel.

  2. Wählen Sie neben dem Server, den Sie löschen möchten, Löschen aus.

  3. Bestätigen Sie den Löschvorgang, wenn Sie dazu aufgefordert werden.

Überprüfen und Anpassen der Toolberechtigungen

So überprüfen Sie Toolberechtigungen und passen sie an:

  1. Öffnen Sie das MCP-Server-Panel.

  2. Wählen Sie den MCP-Server aus, für den Sie die Berechtigungen überprüfen und anpassen möchten.

  3. Für jedes Tool können Sie eine der folgenden Berechtigungsstufen festlegen:

    • Fragen: Jedes Mal, wenn das Tool verwendet wird, nach der Berechtigung fragen.

    • Immer zulassen: Das Tool darf ohne Prompt ausgeführt werden.

    • Verweigern: Dieses Tool darf nicht verwendet werden.