Verbinden Sie Qwen Code mit Tools über MCP

Qwen Code kann über das Model Context Protocol (MCP)  mit externen Tools und Datenquellen verbunden werden. MCP-Server gewähren Qwen Code Zugriff auf Ihre Tools, Datenbanken und APIs.

Was Sie mit MCP tun können

Wenn MCP-Server verbunden sind, können Sie Qwen Code auffordern, Folgendes zu tun:

• Mit Dateien und Repositories zu arbeiten (Lesen/Suchen/Schreiben – je nach den aktivierten Tools)
• Datenbanken abzufragen (Schema-Inspektion, Abfragen, Berichte)
• Interne Dienste einzubinden (Ihre APIs als MCP-Tools kapseln)
• Workflows zu automatisieren (wiederholbare Aufgaben als Tools oder Prompts bereitstellen)

Schnellstart

Qwen Code lädt MCP-Server aus dem Eintrag mcpServers in Ihrer settings.json. Sie können Server auf zwei Arten konfigurieren:

• Durch direktes Bearbeiten der settings.json
• Mithilfe der qwen mcp-Befehle (siehe CLI-Referenz)

Fügen Sie Ihren ersten Server hinzu

1. Fügen Sie einen Server hinzu (Beispiel: entfernter HTTP-MCP-Server):

qwen mcp add --transport http my-server http://localhost:3000/mcp

2. Öffnen Sie den MCP-Verwaltungsdialog, um Server anzuzeigen und zu verwalten:

qwen mcp

3. Starten Sie Qwen Code im selben Projekt neu (oder starten Sie es, falls es noch nicht läuft), und fordern Sie das Modell dann auf, Tools von diesem Server zu nutzen.

Speicherort der Konfiguration (Geltungsbereiche)

Die meisten Benutzer benötigen nur diese beiden Geltungsbereiche:

• Projekt-Geltungsbereich (Standard): .qwen/settings.json im Stammverzeichnis Ihres Projekts
• Benutzer-Geltungsbereich: ~/.qwen/settings.json für alle Projekte auf Ihrem Rechner

Schreiben Sie in den Benutzer-Geltungsbereich:

qwen mcp add --scope user --transport http my-server http://localhost:3000/mcp

Konfigurieren Sie Server

Wählen Sie ein Transportprotokoll

Konfiguration über settings.json oder qwen mcp add

Beide Ansätze erzeugen dieselben Einträge in mcpServers in Ihrer settings.json – verwenden Sie die Methode, die Ihnen besser gefällt.

Stdio-Server (lokaler Prozess)

JSON (.qwen/settings.json):

{
  "mcpServers": {
    "pythonTools": {
      "command": "python",
      "args": ["-m", "my_mcp_server", "--port", "8080"],
      "cwd": "./mcp-servers/python",
      "env": {
        "DATABASE_URL": "$DB_CONNECTION_STRING",
        "API_KEY": "${EXTERNAL_API_KEY}"
      },
      "timeout": 15000
    }
  }
}

CLI (schreibt standardmäßig im Projektkontext):

qwen mcp add pythonTools -e DATABASE_URL=$DB_CONNECTION_STRING -e API_KEY=$EXTERNAL_API_KEY \
  --timeout 15000 python -m my_mcp_server --port 8080

HTTP-Server (streamfähiger Remote-HTTP-Server)

JSON:

{
  "mcpServers": {
    "httpServerWithAuth": {
      "httpUrl": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer Ihr-API-Token"
      },
      "timeout": 5000
    }
  }
}

CLI:

qwen mcp add --transport http httpServerWithAuth http://localhost:3000/mcp \
  --header "Authorization: Bearer Ihr-API-Token" --timeout 5000

SSE-Server (Remote-Server-Sent-Events)

JSON:

{
  "mcpServers": {
    "sseServer": {
      "url": "http://localhost:8080/sse",
      "timeout": 30000
    }
  }
}

CLI:

qwen mcp add --transport sse sseServer http://localhost:8080/sse --timeout 30000

Sicherheit und Kontrolle

Vertrauen (Bestätigungen überspringen)

• Serververtrauen (trust: true): Umgeht Bestätigungsabfragen für diesen Server (nur sparsam verwenden).

Filtern von Tools (Zulassen/Verweigern von Tools pro Server)

Verwenden Sie includeTools bzw. excludeTools, um die von einem Server bereitgestellten Tools einzuschränken (aus Sicht von Qwen Code).

Beispiel: Nur einige Tools zulassen:

{
  "mcpServers": {
    "filteredServer": {
      "command": "python",
      "args": ["-m", "my_mcp_server"],
      "includeTools": ["safe_tool", "file_reader", "data_processor"],
      "timeout": 30000
    }
  }
}

Globale Zulassen-/Verweigern-Listen

Das Objekt mcp in Ihrer Datei settings.json definiert globale Regeln für alle MCP-Server:

• mcp.allowed: Liste der zulässigen MCP-Servernamen (Schlüssel in mcpServers)
• mcp.excluded: Liste der ausgeschlossenen MCP-Servernamen

Beispiel:

{
  "mcp": {
    "allowed": ["my-trusted-server"],
    "excluded": ["experimental-server"]
  }
}

Problembehandlung

• Server zeigt „Getrennt“ in qwen mcp list an: Überprüfen Sie, ob die URL bzw. der Befehl korrekt ist, und erhöhen Sie anschließend den Wert für timeout.
• Stdio-Server startet nicht: Verwenden Sie einen absoluten Pfad für command und überprüfen Sie cwd/env erneut.
• Umgebungsvariablen in JSON werden nicht aufgelöst: Stellen Sie sicher, dass sie in der Umgebung vorhanden sind, in der Qwen Code ausgeführt wird (Shell- und GUI-Anwendungsumgebungen können sich unterscheiden).

Referenz

Struktur von settings.json

Server-spezifische Konfiguration (mcpServers)

Fügen Sie ein mcpServers-Objekt zu Ihrer Datei settings.json hinzu:

// ... die Datei enthält andere Konfigurationsobjekte
{
  "mcpServers": {
    "serverName": {
      "command": "Pfad/zum/Server",
      "args": ["--arg1", "value1"],
      "env": {
        "API_KEY": "$MY_API_TOKEN"
      },
      "cwd": "./server-verzeichnis",
      "timeout": 30000,
      "trust": false
    }
  }
}

Konfigurationseigenschaften:

Erforderlich (eine der folgenden):

Optional:

MCP-Server mit qwen mcp verwalten

Sie können MCP-Server stets manuell durch Bearbeiten der Datei settings.json konfigurieren, doch die CLI ist in der Regel schneller.

Einen Server hinzufügen (qwen mcp add)

qwen mcp add [Optionen] <Name> <BefehlOderUrl> [Argumente...]

Entfernen eines Servers (qwen mcp remove)

qwen mcp remove <name>