MCP-Konfiguration für Q Developer in der IDE - Amazon Q Developer
Mit der IDEHinzufü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

MCP-Konfiguration für Q Developer in der IDE

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

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 ~/.aws/amazonq/agents/default.json gespeichert und ist für all Ihre Projekte verfügbar. Wählen Sie den lokalen Bereich aus, dann wird die Konfiguration in Ihrem aktuellen Projekt in .aws/amazonq/agents/default.json gespeichert.

  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 Geltungsbereich auswählen, wird die MCP-Serverkonfiguration in ~/.aws/amazonq/mcp.json gespeichert und ist für all Ihre Projekte verfügbar. Wählen Sie den lokalen Bereich aus, dann wird die Konfiguration in Ihrem aktuellen Projekt in .amazonq/mcp.json gespeichert.

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

    Wenn wir beispielsweise den MCP-Server für die AWS-Dokumentation installieren, lautet der 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 MCP-Servers für die AWS-Dokumentation 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 MCP-Servers für die AWS-Dokumentation 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 den Namen FASTMCP_LOG_LEVEL und dann den Wert ERROR ein.

    Wir verwenden auch den Namen AWS_DOCUMENTATION_PARTITION und den Wert aws, 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.