Connecter Qwen Code à des outils via MCP

Qwen Code peut se connecter à des outils externes et à des sources de données via le Model Context Protocol (MCP) . Les serveurs MCP donnent à Qwen Code un accès à vos outils, bases de données et API.

Ce que vous pouvez faire avec MCP

Une fois des serveurs MCP connectés, vous pouvez demander à Qwen Code d’effectuer les actions suivantes :

• Travailler avec des fichiers et des dépôts (lecture/recherche/écriture, selon les outils que vous activez)
• Interroger des bases de données (inspection du schéma, requêtes, rapports)
• Intégrer des services internes (en encapsulant vos API sous forme d’outils MCP)
• Automatiser des workflows (tâches répétables exposées sous forme d’outils ou de invites)

Démarrage rapide

Qwen Code charge les serveurs MCP depuis la propriété mcpServers de votre fichier settings.json. Vous pouvez configurer ces serveurs de deux manières :

• En modifiant directement le fichier settings.json
• En utilisant les commandes qwen mcp (voir la référence CLI)

Ajoutez votre premier serveur

1. Ajoutez un serveur (exemple : serveur MCP HTTP distant) :

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

2. Ouvrez la boîte de dialogue de gestion MCP pour afficher et gérer les serveurs :

qwen mcp

3. Redémarrez Qwen Code dans le même projet (ou démarrez-le s’il n’était pas encore en cours d’exécution), puis demandez au modèle d’utiliser les outils provenant de ce serveur.

Emplacement du stockage de la configuration (portées)

La plupart des utilisateurs n’ont besoin que de ces deux portées :

• Portée projet (par défaut) : .qwen/settings.json à la racine de votre projet
• Portée utilisateur : ~/.qwen/settings.json pour tous les projets de votre machine

Écrivez dans la portée utilisateur :

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

Configurer les serveurs

Choisir un protocole de transport

Configuration via settings.json ou via qwen mcp add

Les deux approches produisent les mêmes entrées mcpServers dans votre fichier settings.json : utilisez celle qui vous convient le mieux.

Serveur Stdio (processus local)

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 (écrit dans la portée du projet par défaut) :

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

Serveur HTTP (flux HTTP distant pouvant être diffusé en continu)

JSON :

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

CLI :

qwen mcp add --transport http httpServerWithAuth http://localhost:3000/mcp \
  --header "Authorization: Bearer votre-jeton-api" --timeout 5000

Serveur SSE (événements envoyés par le serveur distants)

JSON :

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

CLI :

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

Sécurité et contrôle

Confiance (ignorer les confirmations)

• Confiance accordée au serveur (trust: true) : contourne les invites de confirmation pour ce serveur (à utiliser avec parcimonie).

Filtrage des outils (autorisation/refus des outils par serveur)

Utilisez includeTools / excludeTools pour restreindre les outils exposés par un serveur (du point de vue de Qwen Code).

Exemple : n’inclure que quelques outils :

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

Listes globales d’autorisation/refus

L’objet mcp de votre fichier settings.json définit les règles globales applicables à tous les serveurs MCP :

• mcp.allowed : liste blanche des noms de serveurs MCP (clés de mcpServers)
• mcp.excluded : liste noire des noms de serveurs MCP

Exemple :

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

Résolution des problèmes

• Le serveur affiche « Déconnecté » dans qwen mcp list : vérifiez que l’URL ou la commande est correcte, puis augmentez la valeur de timeout.
• Le serveur stdio ne parvient pas à démarrer : utilisez un chemin absolu pour command, et vérifiez soigneusement les valeurs de cwd et env.
• Les variables d’environnement dans le fichier JSON ne sont pas résolues : assurez-vous qu’elles existent dans l’environnement où Qwen Code s’exécute (les environnements shell et applications graphiques peuvent différer).

Référence

Structure du fichier settings.json

Configuration spécifique au serveur (mcpServers)

Ajoutez un objet mcpServers à votre fichier settings.json :

// ... le fichier contient d'autres objets de configuration
{
  "mcpServers": {
    "serverName": {
      "command": "chemin/vers/le/serveur",
      "args": ["--arg1", "valeur1"],
      "env": {
        "API_KEY": "$MY_API_TOKEN"
      },
      "cwd": "./repertoire-du-serveur",
      "timeout": 30000,
      "trust": false
    }
  }
}

Propriétés de configuration :

Requises (l’une des suivantes) :

Facultatives :

Gérer les serveurs MCP avec qwen mcp

Vous pouvez toujours configurer les serveurs MCP en modifiant manuellement le fichier settings.json, mais l’interface en ligne de commande est généralement plus rapide.

Ajout d’un serveur (qwen mcp add)

qwen mcp add [options] <nom> <commandeOuUrl> [arguments...]

Suppression d’un serveur (qwen mcp remove)

qwen mcp remove <nom>