MCP Servers : connecter Claude Code à vos outils internes

Claude Code est puissant en local. Mais quand tu le connectes à ta base de données, ton Jira et ton pipeline CI/CD, il devient un vrai copilote de projet. Le Model Context Protocol (MCP) est le pont entre Claude et le monde extérieur.

MCP en 30 secondes

MCP est un protocole standardisé (JSON-RPC 2.0) qui permet à Claude Code de se connecter à des sources de données externes. Au lieu de copier-coller des infos dans ton prompt, Claude va directement les chercher. Le flux est simple : tu poses une question, Claude identifie qu'il a besoin de données externes, interroge le serveur MCP, reçoit la réponse et formule sa réponse finale.

Les 4 types de serveurs MCP

• Database — Connecte Claude à PostgreSQL, MySQL ou MongoDB. Il peut inspecter le schéma, lancer des requêtes SELECT et comprendre la structure de tes données.
• API — Intègre des services comme Stripe, Jira, GitHub. Claude peut lire des tickets, consulter des paiements ou créer des issues.
• Web — Permet de fetcher des pages web et des documentations API pour enrichir le contexte.
• File — Accès à des fichiers distants : S3, Google Cloud Storage, SFTP.

Configuration : le fichier .mcp.json

La configuration MCP se fait via un fichier .mcp.json à la racine de ton projet (ou dans ~/.config/claude/ pour une config globale). Voici un exemple complet qui connecte Claude à PostgreSQL et Jira.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_HOST": "localhost",
        "POSTGRES_PORT": "5432",
        "POSTGRES_DB": "myapp",
        "POSTGRES_USER": "dev",
        "POSTGRES_PASSWORD": "dev"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    }
  }
}

Exemple pratique : inspection de schéma PostgreSQL

Une fois PostgreSQL connecté en MCP, tu peux demander à Claude des choses comme :

• "Liste-moi toutes les tables avec leurs colonnes"
• "Quels utilisateurs se sont inscrits cette semaine ?"
• "Trouve les requêtes N+1 potentielles dans mes repositories Doctrine en comparant avec le schéma réel"

Claude génère et exécute les requêtes SQL via MCP. Le tout en lecture seule — c'est un point crucial de sécurité que je recommande de toujours activer.

L'intérêt pour un projet Symfony est énorme : Claude peut comparer le schéma réel de ta base avec tes entités Doctrine et détecter les incohérences. Il peut aussi analyser les données réelles pour t'aider à optimiser tes requêtes.

Sécurité : les règles non négociables

Connecter une IA à ta base de données demande de la rigueur. Voici les règles que j'applique systématiquement :

• Toujours read_only — Sauf besoin explicite et contrôlé. Claude ne doit jamais pouvoir modifier ou supprimer des données en production.
• Variables d'environnement pour les credentials — Jamais de mot de passe en clair dans la config. Utilise ${POSTGRES_PASSWORD}.
• Limiter les tables accessibles — Bloque l'accès aux tables sensibles (user_passwords, api_keys, secrets).
• Activer l'audit log — Chaque requête MCP doit être tracée. Tu veux savoir exactement ce que Claude a lu.
• Limiter les résultats — Configure un max_rows pour éviter de saturer le contexte avec 100 000 lignes.

Connecter Jira pour la gestion de tickets

Le serveur MCP Jira permet à Claude de lire tes tickets, d'en créer, et de comprendre le backlog. En pratique, ça donne des interactions comme :

• "Quels tickets sont en review cette semaine ?"
• "Crée un ticket pour le bug de connexion qu'on vient de trouver, avec les détails techniques du stacktrace"
• "Résume l'avancement du sprint en cours"

La puissance de MCP, c'est que Claude a le contexte de ton code et de ton outil de gestion de projet. Il peut créer un ticket technique avec les bons détails parce qu'il vient de lire le code.

CI/CD : surveiller les builds depuis Claude Code

Avec un serveur MCP GitHub, Claude peut consulter le statut de tes pipelines CI/CD. Tu peux lui demander "Pourquoi le build de la branche feature/auth a échoué ?" et il ira chercher les logs, analyser l'erreur et te proposer un fix — le tout sans quitter ton terminal. Tu peux aussi lui demander de lister les PRs en attente de review, de résumer les changements d'une PR, ou de vérifier si les checks passent avant de merger.

Créer un serveur MCP custom

Si ton outil interne n'a pas de serveur MCP officiel, tu peux en créer un. C'est un serveur Node.js qui implémente le protocole JSON-RPC 2.0. En pratique, il suffit d'installer le SDK @modelcontextprotocol/sdk, de définir tes méthodes (handlers), et de configurer la commande de lancement dans ton .mcp.json. Un serveur MCP basique pour une API REST interne se crée en moins de 100 lignes de TypeScript.

Aller plus loin

MCP est l'une des fonctionnalités les plus sous-exploitées de Claude Code. Bien configuré, il transforme Claude d'un assistant de code en un vrai copilote de projet qui comprend ton infrastructure, tes données et ton workflow. La formation Claude Code Mastery couvre MCP en profondeur avec des configurations avancées pour les environnements Symfony, les serveurs MCP custom et les stratégies d'optimisation des tokens.