Connecter Claude Desktop ou Claude Code

Pour que votre assistant IA puisse interroger votre centre, il faut le connecter une seule fois. La connexion consiste à coller un bloc de configuration dans votre assistant et à y insérer votre clé API. Cette page décrit la procédure pour Claude Desktop et pour Claude Code. Le bloc utilise un mode de connexion local (appelé stdio) : l’assistant démarre lui-même le composant et dialogue avec lui sur votre machine.

Avant de commencer

Il vous faut une clé API. Si vous n’en avez pas encore, créez-la d’abord en suivant la page Gérer les clés API. Le jeton (le texte commençant par ppmcp_) n’est affiché qu’une seule fois à sa création : gardez-le sous la main.

Connecter Claude Code

1. Ouvrez le fichier de configuration des serveurs de Claude Code (le fichier .mcp.json à la racine de votre projet, ou le fichier de configuration global de Claude Code).
2. Ajoutez le bloc ci-dessous dans la section des serveurs.
3. Remplacez les marque-place : VOTRE_CLE_API par votre jeton ppmcp_…, et VOTRE_URL_BASE_DE_DONNEES par l’adresse de connexion à votre base de données, fournie par votre intégrateur.
4. Enregistrez le fichier, puis redémarrez Claude Code.

{
  "mcpServers": {
    "votre-centre": {
      "command": "npx",
      "args": ["tsx", "src/mcp/server.ts"],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "DATABASE_URL": "VOTRE_URL_BASE_DE_DONNEES",
        "MCP_API_KEY": "VOTRE_CLE_API"
      }
    }
  }
}

Connecter Claude Desktop

1. Ouvrez le fichier de configuration de Claude Desktop (claude_desktop_config.json).
2. Ajoutez le bloc ci-dessous dans la section des serveurs.
3. Remplacez les marque-place : VOTRE_CLE_API par votre jeton ppmcp_…, VOTRE_URL_BASE_DE_DONNEES par l’adresse de connexion à votre base de données, et /chemin/absolu/vers/src/mcp/server.ts par le chemin réel du fichier sur votre machine.
4. Enregistrez le fichier, puis redémarrez Claude Desktop.

{
  "mcpServers": {
    "votre-centre": {
      "command": "npx",
      "args": ["tsx", "/chemin/absolu/vers/src/mcp/server.ts"],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "DATABASE_URL": "VOTRE_URL_BASE_DE_DONNEES",
        "MCP_API_KEY": "VOTRE_CLE_API"
      }
    }
  }
}

À quoi correspondent ces réglages

• MCP_TRANSPORT reste sur stdio : c’est le mode de connexion local décrit en haut de page.
• DATABASE_URL est l’adresse de votre base de données ; demandez-la à votre intégrateur si vous ne l’avez pas.
• MCP_API_KEY est votre clé API secrète.

Vérifier que ça marche

Une fois la configuration enregistrée et l’assistant redémarré, posez-lui une question simple de lecture, par exemple :

Liste mes dernières réservations.

Si l’assistant vous renvoie une réponse tirée de vos données, la connexion fonctionne. S’il signale une erreur d’authentification, vérifiez que la clé API collée dans le bloc est bien la bonne et qu’elle n’a pas été révoquée (voir Gérer les clés API).

Votre clé est secrète

Le bloc de configuration contient votre clé API en clair. Ne le partagez pas et ne le publiez nulle part. Si une clé a pu être vue par un tiers, révoquez-la et créez-en une nouvelle.