Ressource Néova

Configs MCP prêtes à coller pour Claude Code

Un serveur MCP ne se code pas : il se déclare en une ligne. Voici les trois configs qu'on utilise chez Neova, prêtes à coller, avec le token de chaque outil et la commande qui va avec.

La règle qui vaut tout le reste : Un serveur MCP ne s'installe pas, il se branche. Une commande, un token, et Claude Code voit ton outil. Tant que le statut n'affiche pas connected, rien d'autre ne compte.

Où Claude Code range tes serveurs

Deux façons d'ajouter un serveur. La commande `claude mcp add` écrit la config pour toi. Ou tu édites le fichier `.mcp.json` à la racine du projet. Ce qui change vraiment, c'est la portée : qui verra ce serveur, et où le secret est écrit.

Portée	Option	Où c'est écrit	Quand l'utiliser
Local	(défaut)	Ta machine, ce projet	Un test perso
Projet	-s project	.mcp.json versionné	Partager avec l'équipe
Global	-s user	~/.claude.json	Dispo sur tous tes projets

Un token en clair dans `.mcp.json` (portée projet) part sur GitHub avec ton code, au premier commit. Pour un secret, préfère la portée global ou une variable d'environnement.

Tes 3 configs à copier-coller

« Je choisis local ou hosté ? »

→URL MCP dispo — Tu branches en hosté avec `--transport http`, puis tu t'authentifies dans le navigateur. Zéro token à copier.

→Juste un paquet npm — Tu branches en local : la commande lance le serveur, le token passe en variable d'environnement.

Outil	Type	Ce qu'il te faut
Notion	Hosté	Un compte Notion + login navigateur
Gmail	Local (npx)	Un identifiant OAuth Google (5 min)
Tes fichiers	Local (npx)	Rien — juste le chemin du dossier

Notion (hosté). Le plus simple, aucun token à gérer :

`claude mcp add --transport http notion https://mcp.notion.com/mcp`

Lance `/mcp` dans Claude Code, choisis « Authenticate », valide dans le navigateur. C'est branché.

Gmail (local). Une autorisation Google à faire une seule fois :

Sur console.cloud.google.com : nouveau projet, active l'API Gmail, crée un identifiant OAuth type « Desktop », télécharge le fichier de clés.
Autorise-toi une fois : `npx -y @gongrzhe/server-gmail-autoauth-mcp auth`
Branche le serveur : `claude mcp add gmail -- npx -y @gongrzhe/server-gmail-autoauth-mcp`

Tes fichiers (local). Le serveur officiel, activement maintenu, et le plus utile au quotidien — Claude lit et écrit dans le dossier que tu lui désignes, et rien d'autre :

`claude mcp add fichiers -- npx -y @modelcontextprotocol/server-filesystem /Users/toi/Documents/mon-projet`

Le chemin EST la limite : il ne verra jamais au-dessus. Donne un dossier précis, jamais ton dossier utilisateur entier.

Tu préfères le fichier ? Le même serveur, dans `.mcp.json` :

{ "mcpServers": { "fichiers": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/toi/Documents/mon-projet"] } } }

Les noms de paquets MCP bougent vite. Si un serveur reste en « failed », vérifie le nom exact sur sa page (npm ou le registre MCP) — la logique, elle, ne change pas.

Vérifier que c'est bien branché

`/mcp` dans Claude Code : le serveur est connected, pas « failed ».
`claude mcp list` depuis le terminal renvoie bien ton serveur.
Tu demandes une action réelle et elle passe : « Liste mes pages Notion », « Résume mes 5 derniers mails », « Combien de lignes dans la table users ? ».
Serveur hosté : le login OAuth via `/mcp` est fait, sinon Claude ne voit rien.

Les pièges qui cassent une config MCP

Secret dans un fichier versionné — Ton token en clair dans `.mcp.json` part sur GitHub au premier commit. Portée global ou variable d'environnement — jamais un secret dans un fichier d'équipe.
Le serveur PostgreSQL que tous les tutos recommandent est archivé — `@modelcontextprotocol/server-postgres` n'est plus maintenu depuis 2025 et porte une injection SQL non corrigée qui contourne le mode lecture seule. Il totalise pourtant encore des dizaines de milliers d'installations par semaine, tirées de tutoriels périmés et de réponses d'IA. Si tu branches une base, prends un serveur maintenu, donne-lui un utilisateur en lecture seule — et ne compte jamais sur le read-only comme seule protection.
Node trop vieux ou absent — Statut « failed » sans raison claire ? `npx` doit être dans ton PATH et Node en version 18 minimum, sinon le serveur ne démarre jamais.
OAuth jamais validé — Serveur hosté ajouté mais Claude ne voit rien : le `/mcp` → Authenticate a sauté. Tant que le login n'est pas fait, l'outil reste muet.

La suite

Brancher tes outils, c'est l'échauffement. Le vrai gain, c'est quand l'agent enchaîne les actions à travers eux sans que tu tiennes la barre. On montre exactement comment dans notre formation Claude Code — tu repars avec tes propres workflows branchés.

Un projet en tête ?

Nous construisons des applications sur mesure. Le diagnostic est gratuit et sans engagement.

Parlons-en →