MCP Neon : Gérer PostgreSQL avec Claude Code

devops
tutorial
claude
database
Author

Sylvain Pham

Published

December 28, 2025

Voici comment ajouter le serveur MCP Neon à Claude Code pour gérer vos bases PostgreSQL en langage naturel.

Méthode rapide (recommandée)

La méthode la plus simple avec configuration automatique :

npx neonctl@latest init

Cette commande s’authentifie via OAuth, crée une API key, et configure Claude Code automatiquement.

Méthode manuelle avec OAuth

claude mcp add --transport http neon https://mcp.neon.tech/mcp

Ensuite, démarre une nouvelle session de Claude pour déclencher le flux d’authentification OAuth. Tu peux aussi déclencher l’authentification avec /mcp dans Claude Code.

Méthode avec API Key

Si tu préfères utiliser une clé API Neon :

claude mcp add --transport http neon https://mcp.neon.tech/mcp \
  --header "Authorization: Bearer <TA_CLE_API_NEON>"

L’authentification OAuth se connecte par défaut à ton compte Neon personnel. Pour accéder à une organisation, utilise l’authentification par API key.

Vérification

Une fois configuré :

  1. Tape /mcp pour voir les serveurs MCP disponibles
  2. Teste avec : List my Neon projects

Ce que ça permet

Le serveur MCP Neon expose des outils comme list_projects pour lister les projets, get_database_tables pour voir les tables, et permet de gérer tes bases PostgreSQL en langage naturel.

⚠️ Le serveur MCP Neon est prévu pour le développement local et les intégrations IDE uniquement. Il n’est pas recommandé pour les environnements de production.