Connecter un serveur MCP
Comment ajouter un serveur de mcp.tc à Claude Code, claude.ai, Claude Desktop, ChatGPT, Cursor, VS Code et d’autres clients. Chaque étape utilise l’URL ou le paquet du serveur lui-même, comme les boutons de chaque fiche.
Avant de commencer
Chaque fiche indique en haut de sa page avec quoi vous connecter : l’URL du serveur pour un serveur distant, ou la commande d’installation pour un serveur local. Quand nous n’avons pu confirmer ni l’une ni l’autre, elle renvoie aux instructions du projet. Les badges sous le nom indiquent ce dont le serveur a besoin.
Les étapes ci-dessous sont celles qu’affiche la section Configuration de chaque fiche, ici pour quatre serveurs d’exemple. Choisissez-en un avec les onglets ; le choix s’applique à tous les clients de cette page.
- Sans compte : DeepWiki, vérifié, un serveur distant que tout le monde peut utiliser, à
https://mcp.deepwiki.com/mcp. - Connexion : Notion, vérifié, un serveur distant qui vous demande de vous connecter avec OAuth.
- Clé API : un serveur fictif sur
mcp.example.comqui demande une clé dans l’en-têteAuthorization. - Local : Memory, vérifié, que votre client lance avec
npx -y @modelcontextprotocol/server-memory.
Sur la page d’une fiche, les mêmes étapes sont déjà remplies pour ce serveur, et les boutons Ajouter à font la première étape pour vous.
Claude Code
Claude Code ajoute des serveurs depuis le terminal avec claude mcp add. Sur une fiche, Ajouter à Claude Code copie la commande.
Sans compte
- Lancez ceci dans un terminal, dans le dossier de votre projet :
claude mcp add --transport http deepwiki https://mcp.deepwiki.com/mcp- Démarrez Claude Code et tapez
/mcp. deepwiki devrait apparaître comme connecté.
Ajoutez --scope user pour le rendre disponible dans tous vos projets, pas seulement celui-ci.
Connexion
- Lancez ceci dans un terminal, dans le dossier de votre projet :
claude mcp add --transport http notion https://mcp.notion.com/mcp- Démarrez Claude Code, tapez
/mcp, choisissez notion puis Authenticate. Une fenêtre de navigateur s’ouvre pour la connexion à Notion.
Ajoutez --scope user pour le rendre disponible dans tous vos projets, pas seulement celui-ci.
Clé API
- Lancez ceci dans un terminal, dans le dossier de votre projet :
claude mcp add --transport http example https://mcp.example.com/mcp --header "Authorization: Bearer <YOUR_API_KEY>"- Remplacez l’espace réservé par votre clé avant de lancer la commande, puis vérifiez avec
/mcpdans Claude Code.
Ajoutez --scope user pour le rendre disponible dans tous vos projets, pas seulement celui-ci.
Local
- Lancez ceci dans un terminal, dans le dossier de votre projet :
claude mcp add --transport stdio memory -- npx -y @modelcontextprotocol/server-memory- Démarrez Claude Code et tapez
/mcp. memory devrait apparaître comme connecté.
Ajoutez --scope user pour le rendre disponible dans tous vos projets.
claude.ai
claude.ai ajoute les serveurs distants comme connecteurs personnalisés. Ajouter à claude.ai ouvre le formulaire du connecteur avec le nom et l’URL remplis. Il ne peut ni lancer de serveurs locaux ni envoyer l’en-tête d’une clé API, donc ces fiches ne le proposent pas.
Sans compte
- Ouvrez le formulaire des connecteurs sur claude.ai. Ce bouton remplit le nom et l’URL pour vous :
Ajouter à claude.ai (s’ouvre dans un nouvel onglet)
- Vérifiez que l’URL est
https://mcp.deepwiki.com/mcpet cliquez sur Add. - Activez-le dans une conversation depuis le menu des outils.
Les offres gratuites permettent un connecteur personnalisé. Sur les offres Team et Enterprise, un propriétaire l’ajoute dans Organization settings → Connectors.
Connexion
- Ouvrez le formulaire des connecteurs sur claude.ai. Ce bouton remplit le nom et l’URL pour vous :
Ajouter à claude.ai (s’ouvre dans un nouvel onglet)
- Vérifiez que l’URL est
https://mcp.notion.com/mcpet cliquez sur Add. - Cliquez sur Connect et connectez-vous quand Notion le demande.
Les offres gratuites permettent un connecteur personnalisé. Sur les offres Team et Enterprise, un propriétaire l’ajoute dans Organization settings → Connectors.
Claude Desktop
Les serveurs distants passent par les Connectors, les mêmes que sur claude.ai. Les serveurs locaux vont dans son fichier de configuration JSON. Un serveur qui demande l’en-tête d’une clé passe par la passerelle mcp-remote, qui tourne sur votre ordinateur.
Sans compte
- Ouvrez Settings → Connectors et cliquez sur Add custom connector.
- Nommez-le DeepWiki et collez cette URL :
https://mcp.deepwiki.com/mcp- Cliquez sur Add. Ses outils apparaissent dans le menu des outils de la conversation.
Le fichier de configuration JSON de Claude Desktop ne lance que des serveurs locaux. Les serveurs distants passent par les Connectors, et les connecteurs ajoutés sur claude.ai apparaissent aussi ici.
Connexion
- Ouvrez Settings → Connectors et cliquez sur Add custom connector.
- Nommez-le Notion et collez cette URL :
https://mcp.notion.com/mcp- Cliquez sur Add, puis sur Connect, et connectez-vous quand Notion le demande.
Le fichier de configuration JSON de Claude Desktop ne lance que des serveurs locaux. Les serveurs distants passent par les Connectors, et les connecteurs ajoutés sur claude.ai apparaissent aussi ici.
Clé API
- Les connecteurs personnalisés ne peuvent pas envoyer l’en-tête de clé de ce serveur : utilisez la passerelle
mcp-remote. Ouvrez Settings → Developer → Edit Config et ajoutez :
{
"mcpServers": {
"example": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.example.com/mcp",
"--header",
"Authorization: Bearer <YOUR_API_KEY>"
]
}
}
}- Remplacez l’espace réservé par votre clé et redémarrez Claude Desktop.
La passerelle nécessite Node.js sur votre ordinateur.
Local
- Ouvrez Settings → Developer → Edit Config. Cela ouvre
claude_desktop_config.json. Ajoutez :
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
]
}
}
}- Enregistrez le fichier et redémarrez Claude Desktop.
Nécessite Node.js sur votre ordinateur. Le fichier se trouve dans ~/Library/Application Support/Claude/ sous macOS et dans %APPDATA%\Claude\ sous Windows.
ChatGPT
ChatGPT se connecte aux serveurs distants en mode développeur. Comme claude.ai, il ne peut ni lancer de serveurs locaux ni envoyer l’en-tête d’une clé API.
Sans compte
- Sur chatgpt.com, ouvrez Settings → Security and login et activez Developer mode.
- Allez sur
chatgpt.com/pluginset cliquez sur + pour créer une application pour un serveur MCP distant. - Collez
https://mcp.deepwiki.com/mcpcomme URL du serveur et choisissez No authentication.
Le mode développeur est disponible sur le web pour les comptes Plus, Pro, Business, Enterprise et Education.
Connexion
- Sur chatgpt.com, ouvrez Settings → Security and login et activez Developer mode.
- Allez sur
chatgpt.com/pluginset cliquez sur + pour créer une application pour un serveur MCP distant. - Collez
https://mcp.notion.com/mcpcomme URL du serveur et choisissez OAuth. ChatGPT vous envoie chez Notion pour vous connecter.
Le mode développeur est disponible sur le web pour les comptes Plus, Pro, Business, Enterprise et Education.
Cursor
Ajouter à Cursor ouvre la page d’installation de Cursor avec le serveur déjà rempli. Vous pouvez aussi l’ajouter à la main dans mcp.json.
Sans compte
Ajouter à Cursor (s’ouvre dans un nouvel onglet)
Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :
{
"mcpServers": {
"deepwiki": {
"url": "https://mcp.deepwiki.com/mcp"
}
}
}Connexion
Ajouter à Cursor (s’ouvre dans un nouvel onglet)
Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :
{
"mcpServers": {
"notion": {
"url": "https://mcp.notion.com/mcp"
}
}
}Cursor affiche Needs login à côté du serveur. Cliquez dessus pour vous connecter.
Clé API
Ajouter à Cursor (s’ouvre dans un nouvel onglet)
Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :
{
"mcpServers": {
"example": {
"url": "https://mcp.example.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}Local
Ajouter à Cursor (s’ouvre dans un nouvel onglet)
Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
]
}
}
}Nécessite Node.js sur votre ordinateur.
VS Code
Ajouter à VS Code ouvre l’invite d’installation de VS Code. Vous pouvez aussi lancer code --add-mcp, ou committer .vscode/mcp.json pour que tous ceux qui travaillent sur le projet aient le serveur.
Sans compte
Installer dans VS Code (s’ouvre dans un nouvel onglet)
Ou depuis un terminal :
code --add-mcp '{"name":"deepwiki","type":"http","url":"https://mcp.deepwiki.com/mcp"}'Ou committez-le dans le dépôt, dans .vscode/mcp.json :
{
"servers": {
"deepwiki": {
"type": "http",
"url": "https://mcp.deepwiki.com/mcp"
}
}
}Connexion
Installer dans VS Code (s’ouvre dans un nouvel onglet)
Ou depuis un terminal :
code --add-mcp '{"name":"notion","type":"http","url":"https://mcp.notion.com/mcp"}'Ou committez-le dans le dépôt, dans .vscode/mcp.json :
{
"servers": {
"notion": {
"type": "http",
"url": "https://mcp.notion.com/mcp"
}
}
}VS Code vous demande de vous connecter au premier démarrage du serveur.
Clé API
Ajoutez-le à .vscode/mcp.json. VS Code demande la clé la première fois et la stocke de façon sécurisée :
{
"servers": {
"example": {
"type": "http",
"url": "https://mcp.example.com/mcp",
"headers": {
"Authorization": "Bearer ${input:api-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "api-key",
"description": "API key",
"password": true
}
]
}Local
Installer dans VS Code (s’ouvre dans un nouvel onglet)
Ou depuis un terminal :
code --add-mcp '{"name":"memory","type":"stdio","command":"npx","args":["-y","@modelcontextprotocol/server-memory"]}'Ou committez-le dans le dépôt, dans .vscode/mcp.json :
{
"servers": {
"memory": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
]
}
}
}Nécessite Node.js sur votre ordinateur.
Autres clients
Devin Desktop (anciennement Windsurf)
Sans compte
- Ajoutez-le à
~/.config/devin/mcp_config.json(macOS et Linux) ou%APPDATA%\devin\mcp_config.json(Windows) :
{
"mcpServers": {
"deepwiki": {
"serverUrl": "https://mcp.deepwiki.com/mcp"
}
}
}- Actualisez la liste des serveurs MCP dans Cascade.
Devin Desktop est le nouveau nom de Windsurf. Pour les serveurs distants, il lit serverUrl (ou url).
Connexion
- Ajoutez-le à
~/.config/devin/mcp_config.json(macOS et Linux) ou%APPDATA%\devin\mcp_config.json(Windows) :
{
"mcpServers": {
"notion": {
"serverUrl": "https://mcp.notion.com/mcp"
}
}
}- Actualisez la liste des serveurs MCP dans Cascade et connectez-vous quand c’est demandé.
Devin Desktop est le nouveau nom de Windsurf. Pour les serveurs distants, il lit serverUrl (ou url).
Clé API
- Ajoutez-le à
~/.config/devin/mcp_config.json(macOS et Linux) ou%APPDATA%\devin\mcp_config.json(Windows) :
{
"mcpServers": {
"example": {
"serverUrl": "https://mcp.example.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}- Actualisez la liste des serveurs MCP dans Cascade.
Devin Desktop est le nouveau nom de Windsurf. Pour les serveurs distants, il lit serverUrl (ou url).
Local
- Ajoutez-le à
~/.config/devin/mcp_config.json(macOS et Linux) ou%APPDATA%\devin\mcp_config.json(Windows) :
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
]
}
}
}- Actualisez la liste des serveurs MCP dans Cascade.
Devin Desktop est le nouveau nom de Windsurf.
Codex
Sans compte
codex mcp add deepwiki --url https://mcp.deepwiki.com/mcpOu modifiez directement ~/.codex/config.toml :
[mcp_servers.deepwiki]
url = "https://mcp.deepwiki.com/mcp"Connexion
codex mcp add notion --url https://mcp.notion.com/mcp
codex mcp login notionOu modifiez directement ~/.codex/config.toml :
[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"Clé API
codex mcp add example --url https://mcp.example.com/mcp --bearer-token-env-var EXAMPLE_API_KEYOu modifiez directement ~/.codex/config.toml :
[mcp_servers.example]
url = "https://mcp.example.com/mcp"
bearer_token_env_var = "EXAMPLE_API_KEY"Définissez EXAMPLE_API_KEY avec votre clé dans le shell qui lance Codex.
Local
codex mcp add memory -- npx -y @modelcontextprotocol/server-memoryOu modifiez directement ~/.codex/config.toml :
[mcp_servers.memory]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-memory"]Nécessite Node.js sur votre ordinateur.
Gemini CLI
Sans compte
gemini mcp add --transport http deepwiki https://mcp.deepwiki.com/mcpCela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.
Connexion
gemini mcp add --transport http notion https://mcp.notion.com/mcpPuis, dans Gemini CLI, lancez /mcp auth notion pour vous connecter.
Cela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.
Clé API
gemini mcp add --transport http --header "Authorization: Bearer <YOUR_API_KEY>" example https://mcp.example.com/mcpCela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.
Local
gemini mcp add memory npx -- -y @modelcontextprotocol/server-memoryCela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.
Tout autre client
Sans compte
La plupart des clients acceptent cette forme. Certains nomment autrement le champ de l’URL : serverUrl dans Devin Desktop, httpUrl dans le fichier de réglages de Gemini CLI.
{
"mcpServers": {
"deepwiki": {
"type": "http",
"url": "https://mcp.deepwiki.com/mcp"
}
}
}Zed place les serveurs sous context_servers dans ses réglages. Cline a besoin de "type": "streamableHttp", sinon il suppose SSE.
Votre client ne lance que des serveurs locaux ? Reliez-le avec npx -y mcp-remote https://mcp.deepwiki.com/mcp.
Connexion
La plupart des clients acceptent cette forme. Certains nomment autrement le champ de l’URL : serverUrl dans Devin Desktop, httpUrl dans le fichier de réglages de Gemini CLI.
{
"mcpServers": {
"notion": {
"type": "http",
"url": "https://mcp.notion.com/mcp"
}
}
}Zed place les serveurs sous context_servers dans ses réglages. Cline a besoin de "type": "streamableHttp", sinon il suppose SSE.
Votre client ne lance que des serveurs locaux ? Reliez-le avec npx -y mcp-remote https://mcp.notion.com/mcp.
Clé API
La plupart des clients acceptent cette forme. Certains nomment autrement le champ de l’URL : serverUrl dans Devin Desktop, httpUrl dans le fichier de réglages de Gemini CLI.
{
"mcpServers": {
"example": {
"type": "http",
"url": "https://mcp.example.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}Zed place les serveurs sous context_servers dans ses réglages. Cline a besoin de "type": "streamableHttp", sinon il suppose SSE.
Votre client ne lance que des serveurs locaux ? Reliez-le avec npx -y mcp-remote https://mcp.example.com/mcp.
Local
La plupart des clients qui lancent des serveurs locaux acceptent cette forme :
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
]
}
}
}Zed place les serveurs sous context_servers dans ses réglages, avec les mêmes champs command, args et env.
Nécessite Node.js sur votre ordinateur.
Connexion, clés API et serveurs locaux
Connexion (OAuth)
La première fois que votre client se connecte, le serveur demande qui vous êtes. Votre client ouvre la page de connexion de l’éditeur dans un navigateur, vous y autorisez l’accès, et le client garde le jeton. Dans Claude Code, cela passe par /mcp et Authenticate, dans Cursor par Needs login, dans Codex par codex mcp login et dans Gemini CLI par /mcp auth.
Le jeton est émis pour l’URL du serveur lui-même, et votre client ne l’envoie qu’à elle : la connexion MCP lie chaque jeton à un seul serveur (indicateurs de ressource OAuth, RFC 8707). C’est l’une des raisons pour lesquelles chaque configuration sur mcp.tc utilise l’URL du serveur lui-même, et pour lesquelles mcp.tc ne voit jamais vos identifiants.
Clé API
Obtenez une clé auprès de l’éditeur. Les extraits placent un espace réservé comme <YOUR_API_KEY> dans l’en-tête attendu par le serveur, le plus souvent Authorization: Bearer <YOUR_API_KEY>. Remplacez-le dans votre propre configuration et gardez ce fichier hors des dépôts partagés. VS Code demande la clé la première fois et la stocke de façon sécurisée, et Codex la lit dans une variable d’environnement. claude.ai et ChatGPT ne peuvent pas envoyer l’en-tête d’une clé, et Claude Desktop a besoin de la passerelle mcp-remote.
Certains serveurs fonctionnent sans clé et en acceptent une pour un accès étendu. Leur badge indique Connexion facultative, leurs commandes omettent la clé, et la note sous les étapes nomme l’en-tête dans lequel l’envoyer.
Serveurs locaux
Votre client lance un serveur local comme un programme sur votre ordinateur, avec la commande d’installation de sa page. La commande détermine ce que vous devez avoir installé :
npxnécessite Node.js.uvxnécessite uv (Python).pipxnécessite pipx (Python).dockernécessite Docker.dnxnécessite .NET 10.
Un serveur local s’exécute avec les droits de votre compte utilisateur, donc lisez sa liste d’outils avant de l’ajouter. Les réglages dont il a besoin, clés comprises, sont des variables d’environnement, et les extraits les montrent comme espaces réservés. claude.ai et ChatGPT ne se connectent qu’à des serveurs distants, ils ne peuvent donc pas utiliser les serveurs locaux.
Connexion non confirmée
Un anneau gris et Connexion non confirmée signifient que notre vérification n’a pas pu déterminer si le serveur demande une connexion. Les étapes utilisent l’URL simple. Si le serveur demande des identifiants, la documentation de l’éditeur dit lesquels.
Ce que fait un lien mcp.tc dans un client
Le lien mcp.tc est la page de la fiche, pas l’adresse d’un serveur. Un navigateur reçoit la page. Un client MCP qui s’y connecte reçoit à la place une erreur : HTTP 409 avec un message JSON-RPC qui indique l’URL du serveur (ou, pour un serveur local, sa commande d’installation) et la page. Certains clients affichent le message, ce qui vous permet d’y copier la bonne adresse ; Claude Code signale seulement « Failed to connect ». Voici la réponse qu’un client reçoit à mcp.tc/i/deepwiki (le message est toujours en anglais, la langue qu’attendent les clients) :
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32001,
"message": "mcp.tc: this link is a page, not an MCP endpoint. Connect to DeepWiki directly with its own URL: https://mcp.deepwiki.com/mcp (no sign-in needed). Setup for each client: https://mcp.tc/i/deepwiki",
"data": {
"listing": "https://mcp.tc/i/deepwiki",
"endpoint": "https://mcp.deepwiki.com/mcp"
}
}
}data.endpoint contient l’URL du serveur, data.command la commande d’installation d’un serveur local et data.listing la page. Un lien non référencé répond 404, et une fiche retirée répond 410.
Pourquoi le lien ne renvoie-t-il pas votre client vers le serveur, ou ne relaie-t-il pas les requêtes ? Les SDK MCP actuels (TypeScript 1.32 et ultérieurs, Python 1.30 et ultérieurs) refusent d’être renvoyés vers un autre site, et de toute façon un jeton de connexion ne fonctionne qu’à l’URL du serveur lui-même. Relayer les requêtes rendrait aussi votre client dépendant de mcp.tc ; chaque lien mcp.tc n’est donc qu’une page.
Dépannage
Mon client affiche « this link is a page, not an MCP endpoint »
Vous avez ajouté le lien mcp.tc. Remplacez-le par l’URL indiquée dans ce message, ou copiez l’URL depuis l’encadré en haut de la fiche. Pour un serveur local, utilisez plutôt la commande d’installation.
Le serveur ne se connecte pas
Si l’URL ajoutée commence par https://mcp.tc/i/, c’est le lien de la page : remplacez-la par l’URL du serveur indiquée sur la fiche. Sinon, vérifiez que l’URL correspond exactement à celle de la fiche, chemin compris : https://mcp.deepwiki.com/mcp et https://mcp.deepwiki.com sont des adresses différentes. Redémarrez le client après avoir modifié un fichier de configuration. Un badge Dernière vérification échouée sur la fiche signifie que nos vérifications quotidiennes échouent aussi : le problème vient peut-être de l’éditeur.
Il me redemande sans cesse de me connecter, ou répond 401
Le serveur demande une connexion et votre client ne l’a pas terminée. Dans Claude Code, tapez /mcp, choisissez le serveur puis Authenticate. Dans Cursor, cliquez sur Needs login. Dans Codex, lancez codex mcp login avec le nom du serveur, et dans Gemini CLI /mcp auth. Avec une clé API, vérifiez que vous avez remplacé l’espace réservé et que l’en-tête correspond à la documentation de l’éditeur.
Un serveur local ne démarre pas
Lancez d’abord sa commande d’installation dans un terminal. Si elle échoue là, le client ne peut pas le démarrer non plus, et en général il manque l’environnement d’exécution : Node.js pour npx, uv pour uvx, Docker pour docker. Remplacez chaque espace réservé, comme <YOUR_API_KEY> ou /path/to/allowed/dir, par une vraie valeur.
Mon client ne lance que des serveurs locaux
Reliez le serveur distant avec npx -y mcp-remote suivi de l’URL du serveur. La passerelle tourne sur votre ordinateur et nécessite Node.js.
La fiche indique SSE
Le serveur utilise l’ancien transport SSE, que certains clients ne prennent plus en charge. Claude Code accepte --transport sse, VS Code "type": "sse", et Codex a besoin de la passerelle mcp-remote. Les étapes de configuration de la fiche utilisent déjà la bonne option.
Quelque chose est faux sur la fiche
Utilisez Signaler cette fiche sur sa page. Le texte est rédigé avec l’aide de l’IA à partir des métadonnées du serveur, des erreurs arrivent donc, et une personne lit chaque signalement.