MCP-Konfiguration in der CLI - Amazon Q Developer
Befehle zur KonfigurationEntfernte MCP-Server

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 in der CLI

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

Befehle zur Konfiguration

Verwendung: qchat mcp [OPTIONS] COMMAND

MCP-Konfigurationsbefehle
Befehl Description
qchat mcp add Hinzufügen oder Ersetzen eines konfigurierten Server
qchat mcp remove Entfernen eines Servers aus der MCP-Konfiguration
qchat mcp list Auflisten konfigurierter Server
qchat mcp import Importieren einer Serverkonfiguration aus einer anderen Datei
qchat mcp status Abrufen des Status eines konfigurierten Servers
qchat mcp help Drucken dieser Liste von Befehlen oder der Hilfe für die angegebenen Unterbefehle

MCP-Serverargumente

Der --args Parameter unterstützt jetzt kommahaltige Argumente im Escaping- oder JSON-Array-Format:

# Escaped commas
q mcp add --name server --command cmd --args "arg1,arg2\,with\,commas,arg3"

# JSON array format  
q mcp add --name server --command cmd --args '["arg1", "arg2,with,commas", "arg3"]'

Entfernte MCP-Server

Zusätzlich zu lokalen MCP-Servern, die als Prozesse ausgeführt werden, unterstützt Amazon Q Developer CLI Remote-MCP-Server, die über HTTP kommunizieren. Remoteserver können OAuth Authentifizierung verwenden oder offen sein (keine Authentifizierung erforderlich).

Konfiguration

Remote-MCP-Server werden in Ihrer Agent-Konfigurationsdatei mithilfe der url Felder type und konfiguriert:

{
  "mcpServers": {
    "find-a-domain": {
      "type": "http",
      "url": "https://api.findadomain.dev/mcp"
    }
  }
}

OAuth Ablauf der Authentifizierung

Bei Verwendung von Remote-MCP-Servern, für die eine OAuth Authentifizierung erforderlich ist:

  1. Starten Sie Ihre Q-CLI-Sitzung mit einem Agenten, der den Remote-MCP-Server enthält

  2. Der Server wird zunächst als „noch nicht geladen“ angezeigt

  3. Verwenden Sie den /mcp Befehl, um mit der Authentifizierung zu beginnen

  4. Q CLI zeigt an, dass der Server eine Authentifizierung benötigt, und stellt eine URL bereit.

  5. Öffnen Sie die angegebene URL in Ihrem Browser, während Sie die Q CLI-Sitzung geöffnet lassen

  6. Folgen Sie den Anweisungen zur Authentifizierung in Ihrem Browser

  7. Kehren Sie zum Q CLI-Fenster zurück — Sie werden beim MCP-Server angemeldet, wenn die Authentifizierung erfolgreich war

Die Tools des Servers werden verfügbar, sobald die Authentifizierung abgeschlossen ist.