Deux méthodes simples pour connecter un serveur MCP à Claude Cowork : un connecteur personnalisé distant pour les services cloud, et une configuration locale pour les outils installés sur votre ordinateur. Menus, options OAuth, autorisations, bonnes pratiques de sécurité et solutions aux erreurs qui bloquent une première connexion.
Vous collez une URL de serveur dans Claude Cowork, cliquez sur Ajouter, et rien d’utile ne se passe. Ou le connecteur apparaît, mais Claude n’appelle jamais aucun de ses outils. Presque chaque configuration ratée vient d’une même erreur : choisir le mauvais type de serveur MCP pour la façon dont Cowork fonctionne. Un serveur distant réside sur l’internet public et est joint par les serveurs d’Anthropic. Un serveur local réside sur votre ordinateur et est lancé par Claude Desktop. Les menus, les règles et les messages d’erreur diffèrent pour chacun.
Cet article présente les deux parcours à partir des noms de menus de la documentation d’assistance d’Anthropic, un fichier de configuration à copier, une liste de contrôles de sécurité et un tableau de dépannage. La dernière section montre un exemple concret : connecter PicassoIA pour que Claude génère des images et des vidéos dans le cadre d’une tâche Cowork.
MCP, pour Model Context Protocol, est le standard ouvert qui permet à Claude d’appeler des outils externes. Un serveur publie une liste d’outils, chacun avec un nom et un schéma, et Claude décide quand une tâche en a besoin. Lire une ligne de base de données, publier un message Slack, ouvrir un ticket, générer une image : chacune de ces actions est un appel d’outil.
Cowork est la partie de Claude Desktop conçue pour les travaux en plusieurs étapes sur votre propre machine. Selon la présentation de l’architecture publiée par Anthropic, le code que vous demandez à Claude d’exécuter tourne dans une machine virtuelle isolée, via Apple Virtualization.framework sur macOS et Hyper-V sous Windows. Ce détail compte pour MCP, car il détermine où un serveur peut tourner et qui peut l’atteindre.
La documentation d’Anthropic décrit trois façons distinctes d’attacher un serveur, et les confondre est la première source de confusion.
| Type | Ce que c’est | Où il s’exécute | Idéal pour |
|---|---|---|---|
| Connecteur personnalisé | Une URL de serveur MCP distant | Joint par les serveurs d’Anthropic via internet | Services cloud comme Slack, Notion, Linear, GitHub |
| Extension de bureau | Un ensemble .mcpb avec un manifest.json | Sur votre ordinateur, via stdio | Fichiers locaux, base de données localhost, applications de bureau |
| Entrée du fichier de configuration | Une commande dans claude_desktop_config.json | Sur votre ordinateur, lancée par Claude Desktop | Serveurs démarrés avec npx, Python ou un binaire |
Les connecteurs personnalisés distants fonctionnent sur Claude, Cowork et Claude Desktop, avec les forfaits Free, Pro, Max, Team et Enterprise. Les comptes Free n’ont droit qu’à un seul connecteur personnalisé : choisissez donc celui que vous utilisez le plus.
Basez-vous sur la forme de ce qui vous a été fourni :
https:// désigne un connecteur personnalisé. Ne la placez pas dans le fichier de configuration.npx some-server désigne une entrée dans le fichier de configuration, ou une extension si l’auteur en fournit une..mcpb désigne une extension de bureau. Installez-la depuis les Paramètres.💡 Règle empirique : si le serveur doit accéder à des fichiers ou à des applications de votre ordinateur, il doit tourner en local. S’il communique avec un service cloud auquel vous êtes déjà connecté, un connecteur distant est presque toujours la voie la plus simple.
Deux vérifications évitent l’essentiel du temps perdu : qui est autorisé à ajouter des connecteurs sur votre forfait, et si Anthropic peut réellement atteindre votre serveur.
Si vous êtes membre d’un forfait d’équipe et que vous ne pouvez pas ajouter de connecteur, c’est un comportement normal, pas un bug. Demandez à un Owner de l’ajouter, puis connectez-vous avec votre propre compte.
C’est la règle qui piège le plus souvent les développeurs. Pour un connecteur distant, la connexion « provient des serveurs d’Anthropic, et non de l’interface réseau de votre machine ». Cela a trois conséquences :
http://localhost:3000/mcp ne fonctionnera jamais comme connecteur personnalisé, car les serveurs d’Anthropic ne peuvent pas voir votre localhost.
Si votre serveur n’existe que sur votre ordinateur portable, passez à la voie locale. Elle est conçue précisément pour ce cas.
Les Owners ajoutent le connecteur une seule fois pour toute l’organisation :
Choisissez Sans connexion uniquement si le serveur n’a réellement aucune connexion. Pour OAuth, l’identité publiée recommandée est le choix raisonnable par défaut, sauf si votre éditeur vous demande d’enregistrer votre propre client.
Chaque membre ouvre ensuite Personnaliser, puis Connecteurs, repère l’entrée marquée Personnalisé, et clique sur Connecter pour s’authentifier avec son propre compte.
Ajouter un connecteur ne signifie pas que chaque conversation l’utilise. La documentation d’Anthropic décrit le bouton + en bas à gauche de la zone de saisie, puis Connecteurs, puis un interrupteur par conversation. Cowork s’appuie sur la même liste de connecteurs : ouvrez donc ce menu dans votre tâche et vérifiez que l’interrupteur est activé avant de saisir votre demande.
Demandez ensuite quelque chose qui ne peut être traité que par l’outil, par exemple : « Utilisez le connecteur Linear pour lister vos tickets ouverts qui vous sont assignés, regroupés par projet. » Si Claude répond de mémoire au lieu d’appeler l’outil, l’interrupteur est désactivé ou la connexion a expiré.
Une seconde vérification vaut bien trente secondes. Demandez à Claude quels outils le connecteur expose, et lisez la liste. Un serveur de recherche ne devrait pas proposer d’outil de suppression, et un serveur de prise de notes ne devrait pas proposer d’actions de facturation. Si la liste paraît plus large que la mission, retirez le connecteur et cherchez-en un plus ciblé.
Les serveurs locaux gèrent les cas qu’un connecteur distant ne peut jamais atteindre : des fichiers dans un dossier, une base de données sur localhost, une application de bureau. Ils tournent sur votre machine et communiquent avec Claude Desktop via stdio, et non via internet.
Un fichier .mcpb est une archive zip contenant un serveur local et un manifest.json. Il fonctionne comme une extension de navigateur : quelques clics suffisent pour l’installer.
.mcpb.Claude Desktop embarque son propre environnement Node.js : les extensions basées sur Node n’ont donc pas besoin d’installation séparée. Attention toutefois : le comparatif des connecteurs de bureau et web d’Anthropic répertorie les extensions pour Claude Desktop et Claude Code. Faites donc un test rapide dans une tâche Cowork avant de construire un flux de travail autour d’une extension.
Pour un serveur stdio lancé par une commande, le fichier de configuration est le bon emplacement. Son chemin dépend du système d’exploitation :
| Système | Chemin |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
Voici une entrée minimale utilisant le serveur de système de fichiers de référence :
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"C:\\Users\\you\\Documents\\notes"
]
}
}
}
Trois détails provoquent la plupart des échecs en local :
\\ dans le JSON.npx, car npx s’exécute depuis votre PATH système.Des articles communautaires indiquent que Claude Desktop transmet les serveurs de ce fichier vers la machine virtuelle de Cowork, où ils apparaissent avec le type sdk. La page d’architecture d’Anthropic confirme l’autre moitié de l’histoire : les serveurs MCP locaux tournent sur votre appareil dans les sessions locales, et ne tournent pas du tout dans les sessions cloud. Les administrateurs peuvent les désactiver avec les paramètres isLocalDevMcpEnabled et isDesktopExtensionEnabled, si bien qu’un ordinateur professionnel verrouillé peut bloquer les deux.
Un connecteur permet à Claude d’agir dans un autre service, et pas seulement d’y lire. La liste d’avertissements d’Anthropic est courte et mérite d’être suivie : ne vous connectez qu’à des serveurs de confiance, vérifiez les autorisations demandées par un connecteur, surveillez les injections de prompt et suivez les changements de comportement des outils. Les connecteurs personnalisés peuvent pointer vers des services qu’Anthropic n’a pas vérifiés : la décision de confiance vous revient.
| Risque | Habitude utile |
|---|---|
| Auteur de serveur inconnu | Lisez la documentation ou le code source de l’éditeur avant de coller une URL |
| Outils qui écrivent ou suppriment | Gardez les outils capables d’écriture à l’écart des tâches de recherche ; Anthropic recommande de les désactiver pour la fonctionnalité Recherche |
| Changements silencieux des outils | Revérifiez la liste des outils après une mise à jour du serveur |
| Injection de prompt via du contenu récupéré | Traitez le texte renvoyé par un outil comme une donnée non fiable, jamais comme une instruction de votre part |
| Autorisations trop larges | Les administrateurs peuvent désactiver l’autorisation persistante « toujours autoriser » pour exiger une nouvelle approbation à chaque appel soumis à autorisation |
L’injection de prompt, en termes simples : une page web, un document ou un ticket que Claude lit peut contenir des phrases rédigées pour ressembler à des ordres. Un connecteur avec accès en écriture transforme cette ruse de gênante en coûteuse. Limitez les outils d’écriture aux tâches où vous relisez le plan avant que Claude n’agisse.
Un détail d’architecture est rassurant. Anthropic indique que les jetons d’autorisation des connecteurs n’entrent jamais dans le bac à sable, et que les appels de connecteurs sont effectués côté serveur. Le code qui s’exécute dans la VM de Cowork ne peut pas lire vos jetons.
Procédez dans cet ordre :
https:// doivent figurer dans un connecteur personnalisé.| Symptôme | Cause probable | Correctif |
|---|---|---|
| La connexion expire | Le serveur est sur localhost ou sur un réseau privé | Hébergez-le publiquement ou autorisez les plages d’adresses IP d’Anthropic |
| Connecteur ajouté mais jamais appelé | L’interrupteur est désactivé pour cette conversation | Utilisez +, puis Connecteurs, et activez-le |
| La connexion revient au début | Incompatibilité du client OAuth | Choisissez Utiliser votre propre client OAuth et saisissez l’ID et le secret de l’éditeur |
| Serveur local absent dans une tâche | Session cloud, ou administrateur ayant désactivé les serveurs locaux | Lancez une session locale ; demandez à votre administrateur au sujet de isLocalDevMcpEnabled |
Commande npx introuvable | Node.js absent du PATH | Installez Node.js, puis redémarrez Claude Desktop |
💡 Test rapide : demandez à Claude de lister les outils fournis par un connecteur. Une liste vide signifie que le serveur s’est connecté mais n’a rien exposé ; une erreur signifie que la connexion elle-même a échoué. Ces deux résultats renvoient à des corrections différentes.
Un bon premier connecteur est celui qui produit quelque chose que vous pouvez voir. PicassoIA expose ses modèles via MCP, et la référence de l’API de PicassoIA cite Claude parmi les clients pris en charge. Les limites à connaître : chaque compte peut avoir 5 prédictions en file d’attente ou en cours à la fois, et ce quota est partagé entre toutes les clés API et toutes les connexions MCP. Les règles du forfait varient selon le type d’accès : consultez la page tarifaire pour savoir ce que votre forfait inclut avant de lancer un gros lot.
Les outils du connecteur sont simples : generate_image, edit_image, generate_video_picassoia, generate_video_seedance, get_generation, list_generations, list_models, get_account et cancel_generation. Les tâches sont asynchrones. Un appel de génération renvoie un ID de prédiction, puis Claude interroge get_generation jusqu’à ce que le statut indique succeeded ou failed.
get_account pour confirmer la liaison.
Choisissez le modèle selon la tâche, puis donnez à Claude une consigne précise.
| Tâche | Modèle | Exemple de prompt |
|---|---|---|
| Texte vers image | PicassoIA Image | « Générez trois photos au format 16:9 d’une tasse en céramique sur un bureau en chêne, sous une lumière matinale. » |
| Modifier une image existante | PicassoIA Image Editor Pro | « Modifiez cette photo de produit pour que l’arrière-plan devienne un mur gris uni. » |
| Courte vidéo | PicassoIA Video | « Animez cette photo avec un lent travelling avant et une lumière douce de fenêtre. » |
| Vidéo avec son | Seedance 2.5 Lite | « Créez un clip de 10 secondes de pluie sur la vitre d’un café, avec une ambiance calme. » |
Trois habitudes assurent des lots fluides :
Traitez le premier résultat comme un brouillon. Demandez à Claude de conserver le sujet et de ne modifier qu’un seul élément à la fois, comme l’angle de prise de vue, l’heure de la journée ou l’arrière-plan. De courtes suites comme « même scène, angle plus bas » donnent des résultats comparables et permettent de voir clairement quel changement a fait la différence.
Vous disposez maintenant des deux voies : un connecteur distant pour les services cloud, et une entrée locale pour les outils de votre machine. Le plus rapide pour voir l’intérêt est de connecter quelque chose de visuel et de regarder Cowork l’utiliser. Ouvrez PicassoIA, générez une image test avec PicassoIA Image, puis reliez le connecteur et demandez à Claude trois variations dans une tâche.
Testez un seul sujet, un seul éclairage et quelques variations de formulation. De petites modifications d’un prompt donnent des résultats étonnamment différents, et le moyen le plus rapide de trouver votre style est de générer, comparer et ajuster. Votre première image connectée n’est plus qu’à une tâche.
Choisissez votre langue
