Verbinde Qwen Code über MCP mit Tools

Qwen Code kann sich über das Model Context Protocol (MCP)  mit externen Tools und Datenquellen verbinden. MCP-Server geben Qwen Code Zugriff auf deine Tools, Datenbanken und APIs.

Was du mit MCP machen kannst

Wenn MCP-Server verbunden sind, kannst du Qwen Code bitten:

• Mit Dateien und Repositories zu arbeiten (Lesen/Suchen/Schreiben, je nach aktivierten Tools)
• Datenbanken abzufragen (Schema-Inspektion, Abfragen, Berichte)
• Interne Services zu integrieren (Eigene APIs als MCP-Tools bereitstellen)
• Workflows zu automatisieren (Wiederholbare Aufgaben als Tools/Prompts bereitstellen)

Schnellstart

Qwen Code lädt MCP-Server aus dem Eintrag mcpServers in deiner settings.json. Du kannst Server konfigurieren, indem du entweder:

• Die settings.json direkt bearbeitest
• Die qwen mcp Befehle verwendest (siehe CLI Referenz)

Fügen Sie Ihren ersten Server hinzu

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

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

2. Überprüfen Sie, ob er angezeigt wird:

qwen mcp list

3. Starten Sie Qwen Code im selben Projekt neu (oder starten Sie es, falls es noch nicht lief), und bitten Sie dann das Modell, Tools von diesem Server zu verwenden.

Wo die Konfiguration gespeichert wird (Bereiche)

Die meisten Benutzer benötigen nur diese zwei Bereiche:

• Projektbereich (Standard): .qwen/settings.json im Stammverzeichnis Ihres Projekts
• Benutzerbereich: ~/.qwen/settings.json für alle Projekte auf Ihrem Rechner

In den Benutzerbereich schreiben:

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

Server konfigurieren

Wähle einen Transport

Konfiguration über settings.json vs qwen mcp add

Beide Methoden erzeugen dieselben mcpServers-Einträge in deiner settings.json—verwende die Methode, die dir 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 in den Projektscope):

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 (Remote Streamable HTTP)

JSON:

{
  "mcpServers": {
    "httpServerWithAuth": {
      "httpUrl": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer your-api-token"
      },
      "timeout": 5000
    }
  }
}

CLI:

qwen mcp add --transport http httpServerWithAuth http://localhost:3000/mcp \
  --header "Authorization: Bearer your-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)

• Server-Vertrauen (trust: true): umgeht Bestätigungsabfragen für diesen Server (sparsam verwenden).

Tool-Filterung (Tools pro Server zulassen/ablehnen)

Verwende includeTools / excludeTools, um die von einem Server bereitgestellten Tools einzuschränken (aus der Sicht von Qwen Code).

Beispiel: Nur einige wenige Tools zulassen:

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

Globale Zulassungs-/Ablehnungslisten

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

• mcp.allowed: Liste der erlaubten MCP-Server-Namen (Schlüssel in mcpServers)
• mcp.excluded: Liste der abgelehnten MCP-Server-Namen

Beispiel:

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

Fehlerbehebung

• Server zeigt „Disconnected“ in qwen mcp list: Überprüfen Sie, ob die URL/das Kommando korrekt ist, und erhöhen Sie dann den timeout-Wert.
• Stdio-Server startet nicht: Verwenden Sie einen absoluten Pfad für das command, und überprüfen Sie sorgfältig cwd/env.
• 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- gegenüber GUI-Anwendungsumgebungen können unterschiedlich sein).

Referenz

Struktur von settings.json

Server-spezifische Konfiguration (mcpServers)

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

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

Konfigurationseigenschaften:

Erforderlich (eine der folgenden):

Optional:

Verwalten von MCP-Servern mit qwen mcp

Sie können MCP-Server jederzeit konfigurieren, indem Sie settings.json manuell bearbeiten, aber die CLI ist in der Regel schneller.

Hinzufügen eines Servers (qwen mcp add)

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

Server auflisten (qwen mcp list)

qwen mcp list

Server entfernen (qwen mcp remove)

qwen mcp remove <name>