Connecteur MCP 🤖 — ChatGPT & Claude

Planète Serrures de Paris expose un serveur MCP (Model Context Protocol) qui permet à un assistant IA d'interroger notre catalogue de cylindres adaptables de très haute sûreté, les marques compatibles, nos zones d'intervention et nos coordonnées.

URL du serveur

https://www.planeteserruresdeparis.fr/mcp

Transport : Streamable HTTP · Authentification : OAuth 2.1 (les appels anonymes sont refusés avec un code 401). Un compte est requis : créez-le sur /auth puis approuvez la connexion depuis votre client IA.

Outils disponibles

list_cylinders

Lister les cylindres adaptables

Catalogue des cylindres SECURIER / RB-LOCKS avec compatibilité de marque et URL de fiche.

{ "brand": "Fichet" } // optionnel

search_cylinders

Recherche avancée de cylindres

Recherche filtrée (texte, marque, critère de compatibilité, zone d'intervention) avec tri et pagination.

{ "query": "trelod", "brand": "Fichet", "compatibility": "Vertipoint T", "zone": "Paris 17ème", "sort": "compat", "page": 1, "pageSize": 10 }

get_cylinder

Détail d'un cylindre

Détail complet d'un cylindre (nom, compatibilités, photos, URL).

{ "query": "forclaz" } // requis

list_brands

Les 16 marques de serrures compatibles

Liste des 16 marques compatibles (Fichet, Tordjman, Picard, Muel, VAK, Bricard…) avec recherche, gammes, compatibilités et points forts.

{ "search": "picard" } // optionnel

get_brand

Détail d'une marque compatible

Fiche détaillée d'une marque : gammes de cylindres adaptables, serrures compatibles, points forts et cylindres du catalogue associés.

{ "brand": "Fichet 787Z" } // requis

list_intervention_zones

Zones d'intervention

Arrondissements de Paris et villes limitrophes desservis, avec quartiers et URL locale.

{ "search": "17" } // optionnel

get_contact_info

Coordonnées, horaires & services

Téléphone, e-mail, adresse, horaires, sociétés du groupe et liste des services.

{}

Connexion depuis ChatGPT

  1. Ouvrez ChatGPT → Paramètres → Connecteurs → « Ajouter un connecteur ».
  2. Collez l'URL https://www.planeteserruresdeparis.fr/mcp et choisissez le type « MCP / Serveur distant ».
  3. ChatGPT ouvre la page d'autorisation OAuth : connectez-vous puis cliquez sur « Autoriser ».
  4. Testez : « Quels cylindres adaptables sont compatibles avec une serrure Fichet ? »

Connexion depuis Claude

Claude (Desktop ou Web) accepte le même serveur distant. Dans Claude Desktop, ajoutez l'entrée suivante à votre fichier de configuration MCP :

{
  "mcpServers": {
    "planete-serrures": {
      "type": "http",
      "url": "https://www.planeteserruresdeparis.fr/mcp"
    }
  }
}

Dans Claude Web : Paramètres → Connecteurs → « Ajouter un connecteur personnalisé », puis collez l'URL du serveur. L'autorisation OAuth s'ouvre automatiquement.

Exemple d'appel direct (HTTP)

Tous les appels utilisent JSON-RPC 2.0 sur POST, avec l'en-tête Accept: application/json, text/event-stream exigé par la spécification MCP.

curl -X POST https://www.planeteserruresdeparis.fr/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer <votre_jeton_oauth>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_cylinder",
      "arguments": { "query": "forclaz" }
    }
  }'

Exemple complet — get_brand

L'outil get_brand renvoie la fiche d'une marque compatible avec ses gammes, ses points forts et les cylindres associés.

Prompt ChatGPT

Quels cylindres adaptables RB-LOCKS proposez-vous pour une serrure Fichet 787Z ? Donne-moi les gammes compatibles, les points forts de la marque et les URLs des fiches produit.

Prompt Claude

Fais-moi la fiche détaillée de la marque Fichet 787Z : gammes de cylindres adaptables compatibles, serrures concernées, points forts, et liste les cylindres du catalogue qui correspondent.

Requête cURL

curl -X POST https://www.planeteserruresdeparis.fr/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer <votre_jeton_oauth>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "get_brand",
      "arguments": { "brand": "Fichet 787Z" }
    }
  }'

Manifeste MCP

Le manifeste décrit le serveur, son mode d'authentification et le schéma d'entrée de chaque outil.

{
  "version": 1,
  "path": "/mcp",
  "auth": {
    "type": "oauth",
    "issuer": "https://<projet>.supabase.co/auth/v1",
    "accepted_audiences": [
      "authenticated"
    ]
  },
  "mcp": {
    "server": {
      "name": "planete-serrures-cylindres-adaptables",
      "title": "Planète Serrures - Cylindres Adaptables",
      "version": "0.2.0"
    },
    "tools": [
      {
        "name": "list_cylinders",
        "title": "Lister les cylindres adaptables",
        "description": "Catalogue des cylindres SECURIER / RB-LOCKS avec compatibilité de marque et URL de fiche."
      },
      {
        "name": "search_cylinders",
        "title": "Recherche avancée de cylindres",
        "description": "Recherche filtrée (texte, marque, critère de compatibilité, zone d'intervention) avec tri et pagination."
      },
      {
        "name": "get_cylinder",
        "title": "Détail d'un cylindre",
        "description": "Détail complet d'un cylindre (nom, compatibilités, photos, URL)."
      },
      {
        "name": "list_brands",
        "title": "Les 16 marques de serrures compatibles",
        "description": "Liste des 16 marques compatibles (Fichet, Tordjman, Picard, Muel, VAK, Bricard…) avec recherche, gammes, compatibilités et points forts."
      },
      {
        "name": "get_brand",
        "title": "Détail d'une marque compatible",
        "description": "Fiche détaillée d'une marque : gammes de cylindres adaptables, serrures compatibles, points forts et cylindres du catalogue associés."
      },
      {
        "name": "list_intervention_zones",
        "title": "Zones d'intervention",
        "description": "Arrondissements de Paris et villes limitrophes desservis, avec quartiers et URL locale."
      },
      {
        "name": "get_contact_info",
        "title": "Coordonnées, horaires & services",
        "description": "Téléphone, e-mail, adresse, horaires, sociétés du groupe et liste des services."
      }
    ]
  }
}
Lun–Ven 7h30–23h · Sam·Dim·Fériés 14h–23hAppeler · 7J/706 67 62 19 39