Connecteur MCP Kelki

MCP en deux phrases

Le Model Context Protocol (MCP) est un protocole ouvert qui permet à un assistant IA (ChatGPT, Claude, Le Chat, Cursor, VS Code…) d’utiliser des outils et des données fournis par un service extérieur. L’assistant découvre la liste des outils du serveur, puis les appelle au fil de la conversation, en JSON‑RPC 2.0 sur HTTPS.

Ce que fait le connecteur Kelki

Vous écrivez à votre assistant: « Trouve‑moi un plombier à Créteil pour une fuite sous l’évier ». Avec le connecteur, l’assistant:

1. trouve le bon métier parmi les 89 métiers proposés (trouver_service);
2. vous propose les prestations du métier et les délais, dans les mêmes listes que le formulaire « Rappelez‑moi » de kelki.fr (lister_prestations);
3. vérifie votre ville et son code postal (verifier_lieu);
4. vous montre le récapitulatif et le texte d’accord, puis enregistre la demande après votre oui (demander_rappel).

Vous recevez alors un e‑mail « Confirmer ma demande »: un clic, et votre demande part vers un ou plusieurs professionnels du métier de votre secteur, qui vous rappellent. Le service est gratuit pour vous.

À qui il sert: aux personnes qui utilisent un assistant IA au quotidien, et aux plateformes, développeurs et agents IA qui veulent proposer « être rappelé par un professionnel près de chez soi ». Pour la présentation grand public, voyez Kelki dans votre assistant IA; pour la conversation sur le site et en A2A, l’Agent Kelki.

Adresse, protocole et limites

Essai en une ligne (liste des outils):

curl -s https://kelki.fr/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Les 4 outils

Définitions exactes renvoyées par tools/list, exemples exécutés sur les listes réelles. Requêtes en version 2025-11-25 (en‑tête MCP-Protocol-Version: 2025-11-25). Chaque résultat contient un texte lisible, le même contenu en JSON et structuredContent conforme à outputSchema.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "trouver_service",
    "arguments": {
      "besoin": "fuite sous l’évier"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Métiers correspondant à « fuite sous l’évier » (le plus probable d'abord) :\n1. Plombier (metier = plombier) — correspond à : Recherche et réparation de fuites\n   Prestations : Recherche et réparation de fuites ; Débouchage de canalisations ; Installation et remplacement de robinetterie ; Installation et réparation de chauffe-eau ; Entretien et réparation de chaudière ; Rénovation de salle de bain ; Intervention après dégât des eaux ; Installation et raccordement électroménager ; Autre besoin\n…"
      },
      {
        "type": "text",
        "text": "{\"ok\": true, \"besoin\": \"fuite sous l’évier\", \"metiers\": [{\"metier\": \"plombier\", \"nom\": \"Plombier\", \"activite\": \"plomberie\", \"famille\": \"Réparations et urgences\", \"prestations\": [\"Recherche et réparation de fuites\", \"Débouchage de canalisations\", \"Installation et remplacement de robinetterie\", \"Installation et réparation de chauffe-eau\", \"Entretien et réparation de chaudière\", \"Rénovation de salle de bain\", \"Intervention après dégât des eaux\", \"Installation et raccordement électroménager\", \"Autre besoin\"], \"prestations_correspondantes\": [\"Recherche et réparation de fuites\"], \"page\": \"https://kelki.fr/plombier/\"}]}"
      }
    ],
    "structuredContent": {
      "ok": true,
      "besoin": "fuite sous l’évier",
      "metiers": [
        {
          "metier": "plombier",
          "nom": "Plombier",
          "activite": "plomberie",
          "famille": "Réparations et urgences",
          "prestations": [
            "Recherche et réparation de fuites",
            "Débouchage de canalisations",
            "Installation et remplacement de robinetterie",
            "Installation et réparation de chauffe-eau",
            "Entretien et réparation de chaudière",
            "Rénovation de salle de bain",
            "Intervention après dégât des eaux",
            "Installation et raccordement électroménager",
            "Autre besoin"
          ],
          "prestations_correspondantes": [
            "Recherche et réparation de fuites"
          ],
          "page": "https://kelki.fr/plombier/"
        }
      ]
    },
    "isError": false
  }
}

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "lister_prestations",
    "arguments": {
      "metier": "plombier"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Plombier — prestations (une au choix) :\n- Recherche et réparation de fuites\n- Débouchage de canalisations\n…"
      },
      {
        "type": "text",
        "text": "{\"ok\": true, \"texte_accord\": \"J'accepte que ma demande et mes coordonnées soient transmises à un ou plusieurs professionnels du métier de mon secteur, qui pourront me rappeler à ce sujet.\", \"metier\": \"plombier\", \"nom\": \"Plombier\", \"activite\": \"plomberie\", \"famille\": \"Réparations et urgences\", \"prestations\": [\"Recherche et réparation de fuites\", \"Débouchage de canalisations\", \"Installation et remplacement de robinetterie\", \"Installation et réparation de chauffe-eau\", \"Entretien et réparation de chaudière\", \"Rénovation de salle de bain\", \"Intervention après dégât des eaux\", \"Installation et raccordement électroménager\", \"Autre besoin\"], \"delais\": [{\"libelle\": \"C’est urgent\", \"precision\": \"Dès que possible\"}, {\"libelle\": \"Cette semaine\", \"precision\": \"Dans les prochains jours\"}, {\"libelle\": \"Ce mois-ci\", \"precision\": \"Sans urgence\"}, {\"libelle\": \"Je me renseigne\", \"precision\": \"Pour un projet à venir\"}], \"page\": \"https://kelki.fr/plombier/\"}"
      }
    ],
    "structuredContent": {
      "ok": true,
      "texte_accord": "J'accepte que ma demande et mes coordonnées soient transmises à un ou plusieurs professionnels du métier de mon secteur, qui pourront me rappeler à ce sujet.",
      "metier": "plombier",
      "nom": "Plombier",
      "activite": "plomberie",
      "famille": "Réparations et urgences",
      "prestations": [
        "Recherche et réparation de fuites",
        "Débouchage de canalisations",
        "Installation et remplacement de robinetterie",
        "Installation et réparation de chauffe-eau",
        "Entretien et réparation de chaudière",
        "Rénovation de salle de bain",
        "Intervention après dégât des eaux",
        "Installation et raccordement électroménager",
        "Autre besoin"
      ],
      "delais": [
        {
          "libelle": "C’est urgent",
          "precision": "Dès que possible"
        },
        {
          "libelle": "Cette semaine",
          "precision": "Dans les prochains jours"
        },
        {
          "libelle": "Ce mois-ci",
          "precision": "Sans urgence"
        },
        {
          "libelle": "Je me renseigne",
          "precision": "Pour un projet à venir"
        }
      ],
      "page": "https://kelki.fr/plombier/"
    },
    "isError": false
  }
}

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "verifier_lieu",
    "arguments": {
      "ville_ou_code_postal": "Créteil"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "1 ville(s) pour « Créteil » :\n- Créteil (94000), Val-de-Marne (94) : ville = Créteil, code_postal = 94000"
      },
      {
        "type": "text",
        "text": "{\"ok\": true, \"recherche\": \"Créteil\", \"villes\": [{\"ville\": \"Créteil\", \"code_postal\": \"94000\", \"libelle\": \"Créteil (94000)\", \"departement\": \"Val-de-Marne\", \"departement_code\": \"94\"}]}"
      }
    ],
    "structuredContent": {
      "ok": true,
      "recherche": "Créteil",
      "villes": [
        {
          "ville": "Créteil",
          "code_postal": "94000",
          "libelle": "Créteil (94000)",
          "departement": "Val-de-Marne",
          "departement_code": "94"
        }
      ]
    },
    "isError": false
  }
}

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "demander_rappel",
    "arguments": {
      "metier": "plombier",
      "prestation": "Recherche et réparation de fuites",
      "delai": "C’est urgent",
      "ville": "Créteil",
      "code_postal": "94000",
      "nom": "Camille Exemple",
      "telephone": "06 00 00 00 00",
      "email": "camille@exemple.fr",
      "message": "Joignable après 18 h",
      "accord": true
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 5,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Demande enregistrée. Dernière étape : un e-mail vient d'être envoyé à c•••@exemple.fr. La personne clique sur « Confirmer ma demande » dans les 48 heures pour la transmettre à un ou plusieurs professionnels du métier de son secteur, qui la rappelleront. Sans ce clic, la demande s'efface."
      },
      {
        "type": "text",
        "text": "{\"ok\": true, \"statut\": \"a_confirmer\", \"email_masque\": \"c•••@exemple.fr\", \"expire_le\": \"2026-11-02T09:30:00Z\", \"message\": \"Demande enregistrée. Dernière étape : un e-mail vient d'être envoyé à c•••@exemple.fr. La personne clique sur « Confirmer ma demande » dans les 48 heures pour la transmettre à un ou plusieurs professionnels du métier de son secteur, qui la rappelleront. Sans ce clic, la demande s'efface.\", \"demande\": {\"metier\": \"Plombier\", \"prestation\": \"Recherche et réparation de fuites\", \"delai\": \"C’est urgent\", \"lieu\": \"Créteil (94000)\"}}"
      }
    ],
    "structuredContent": {
      "ok": true,
      "statut": "a_confirmer",
      "email_masque": "c•••@exemple.fr",
      "expire_le": "2026-11-02T09:30:00Z",
      "message": "Demande enregistrée. Dernière étape : un e-mail vient d'être envoyé à c•••@exemple.fr. La personne clique sur « Confirmer ma demande » dans les 48 heures pour la transmettre à un ou plusieurs professionnels du métier de son secteur, qui la rappelleront. Sans ce clic, la demande s'efface.",
      "demande": {
        "metier": "Plombier",
        "prestation": "Recherche et réparation de fuites",
        "delai": "C’est urgent",
        "lieu": "Créteil (94000)"
      }
    },
    "isError": false
  }
}

Une valeur hors liste renvoie un résultat d’erreur explicite (isError: true) avec le paramètre en cause, pour que l’assistant corrige son appel:

{
  "jsonrpc": "2.0",
  "id": 9,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Métier inconnu : « plombie ». Utilisez un identifiant renvoyé par trouver_service."
      }
    ],
    "structuredContent": {
      "ok": false,
      "erreur": "Métier inconnu : « plombie ». Utilisez un identifiant renvoyé par trouver_service.",
      "champ": "metier"
    },
    "isError": true
  }
}

Texte d’accord accepté par la personne avant demander_rappel: « J'accepte que ma demande et mes coordonnées soient transmises à un ou plusieurs professionnels du métier de mon secteur, qui pourront me rappeler à ce sujet. »

Ressources, prompt et interface à choix

• ui://kelki/demande-v1.html — Formulaire de demande Kelki (text/html;profile=mcp-app): Parcours à choix: prestation, délai, ville, coordonnées, accord.
• kelki://metiers — Les métiers de Kelki (application/json): Identifiant, nom, activité et famille de chaque métier.
• kelki://accord — Texte d'accord et confirmation par e‑mail (text/plain): Texte accepté par la personne et déroulé de la confirmation.
• kelki://metier/{metier} — Prestations et délais d'un métier (text/markdown): Prestations, délais et questions fréquentes publiées pour un métier. Une ressource par métier (89).

Prompt trouver_un_professionnel — « Être rappelé par un professionnel près de chez moi »: Préparer une demande de rappel Kelki: métier, prestation, délai, ville, puis confirmation. Arguments: besoin (obligatoire, Ce dont vous avez besoin, ex. « fuite sous l’évier »); ville (facultatif, Ville ou code postal du lieu).

Complétions (completion/complete): villes pour l’argument ville du prompt, noms des métiers pour besoin, identifiants des métiers pour le paramètre metier des ressources.

Interface à choix (MCP Apps): extension io.modelcontextprotocol/ui, ressource ui://kelki/demande-v1.html (text/html;profile=mcp-app), rattachée à trouver_service et lister_prestations par _meta.ui.resourceUri. Dans les assistants compatibles, la personne choisit la prestation, le délai et sa ville dans des boutons, saisit ses coordonnées, coche l’accord et envoie; le composant appelle verifier_lieu et demander_rappel par l’assistant, sans requête réseau directe. Les autres assistants gardent le mode texte.

Consignes envoyées à l’assistant (champ instructions):

Kelki (kelki.fr) transmet une demande de rappel à un ou plusieurs professionnels du métier choisi, dans la ville de la personne : dépannage, travaux, beauté, conseil, auto, événementiel…, partout en France. Kelki ne publie ni classement ni avis de professionnels : la demande part vers les professionnels du secteur, qui rappellent la personne.
Déroulé d'une demande, avec les mêmes listes de choix que le formulaire « Rappelez-moi » du site :
1. trouver_service : métiers correspondant au besoin décrit ; la personne choisit le sien.
2. lister_prestations : prestations du métier (plus « Autre besoin », à décrire en quelques mots), délais possibles et texte d'accord. La personne choisit une prestation et un délai dans ces listes ; elle peut ajouter un commentaire libre.
3. verifier_lieu : villes et codes postaux existants ; si plusieurs correspondent, la personne choisit.
4. Nom, téléphone (numéro français) et e-mail sont ceux que la personne donne elle-même.
5. Avant demander_rappel : récapitulatif de la demande et texte d'accord exact présentés à la personne ; accord = true après son oui explicite.
6. demander_rappel enregistre la demande et envoie un e-mail à la personne : la demande est transmise aux professionnels après son clic sur « Confirmer ma demande » (lien valable 48 h ; sans clic, elle est effacée).
Le service est gratuit pour la personne. Données et fonctionnement : https://kelki.fr/assistant-ia/

Installer le connecteur

Partout, la même adresse: https://kelki.fr/mcp, en accès libre.

Claude (claude.ai, Claude Desktop, applications mobiles)

1. Personnaliser › Connecteurs › « + Ajouter » › « Ajouter un connecteur personnalisé ».
2. Nom: Kelki; URL: https://kelki.fr/mcp; connexion: « sans connexion ». Validez avec « Ajouter ».
3. Dans une conversation: « + » › Connecteurs › activez Kelki.

Offres Team et Enterprise: le propriétaire de l’organisation ajoute le connecteur dans Paramètres de l’organisation › Connecteurs, puis chaque membre l’active.

ChatGPT (web)

1. Page Plugins (chatgpt.com/plugins) › bouton « + » › « Add custom MCP server ».
2. Nom: Kelki; Server URL: https://kelki.fr/mcp; authentification: « No authentication ».
3. « Create as a plugin », puis installez le plugin et utilisez‑le dans une conversation.

Disponibilité selon votre formule ChatGPT et les réglages de votre espace de travail.

Le Chat (Mistral)

1. Intelligence › Connecteurs › « + Ajouter un connecteur » › onglet « Connecteur MCP personnalisé ».
2. Nom: kelki; URL du serveur: https://kelki.fr/mcp; « Connecter » (accès libre).
3. Dans une conversation, activez le connecteur dans la liste des outils.

L’ajout est fait par l’administrateur de l’espace (sur les offres Free, Pro et Student: le titulaire du compte).

Claude Code

claude mcp add --transport http kelki https://kelki.fr/mcp

Pour tous vos projets: ajoutez --scope user. Fichier de projet .mcp.json:

{
  "mcpServers": {
    "kelki": {
      "type": "http",
      "url": "https://kelki.fr/mcp"
    }
  }
}

Cursor

Fichier ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (un projet):

{
  "mcpServers": {
    "kelki": {
      "url": "https://kelki.fr/mcp"
    }
  }
}

VS Code

Commande « MCP: Add Server » › HTTP, ou fichier .vscode/mcp.json:

{
  "servers": {
    "kelki": {
      "type": "http",
      "url": "https://kelki.fr/mcp"
    }
  }
}

Autres clients MCP

Tout client compatible Streamable HTTP: adresse https://kelki.fr/mcp, en accès libre. Carte du serveur: /mcp/server‑card.

Exemple de conversation complète

Conversation fictive (personne et coordonnées inventées), avec les vraies listes de Kelki.

Liens utiles

• Kelki dans votre assistant IA: la présentation pour tous.
• Agent Kelki: la conversation sur kelki.fr et pour les agents IA (A2A).
• Carte du serveur MCP: /mcp/server‑card (JSON).
• Manifeste de découverte ARD: /.well‑known/ard.json.
• Carte de l’Agent Kelki (A2A): /.well‑known/agent‑card.json.
• Version texte complète de cette page pour les IA: /connecteur‑mcp/llms.txt.
• Vos données avec le connecteur · Conditions d’utilisation · contact@kelki.fr · Rappelez‑moi