Skip to content

Brancher un outil d'IA

Kalepin est un serveur MCP (Model Context Protocol) : les outils d’IA compatibles y lisent vos notes, vos transcriptions et votre agenda, avec votre accord.

Adresse https://api.kalepin.tech/mcp
Transport Streamable HTTP, sans session : une requête JSON-RPC par POST, une réponse JSON
Autorisation OAuth, PKCE obligatoire, jeton porté par l’outil
Offre MCP (Pilote, Pro, Business)
  1. Vous ajoutez l’adresse ci-dessus dans votre outil. Sans jeton, le serveur répond 401 avec l’adresse de ses métadonnées : l’outil s’en sert pour découvrir comment s’authentifier.
  2. L’outil s’enregistre lui-même, puis ouvre une page de connexion : Google ou Microsoft. Chaque branchement passe par le fournisseur, même si une session Kalepin est déjà ouverte dans votre navigateur.
  3. Vient la page d’autorisation. Elle montre le compte que l’outil verra (le nom de l’entreprise ou « Compte personnel », et l’adresse) et liste les droits demandés, une case par droit : la lecture est cochée, l’écriture ne l’est pas. Vous pouvez refuser un droit.
  4. L’outil reçoit un jeton et n’a plus besoin de vous jusqu’à ce que vous retiriez l’accès.

L’adresse de retour d’une application native (http://localhost:<port>) est acceptée ; sinon l’outil doit revenir sur une adresse https.

Demandez à l’outil quelque chose de simple : « Qu’est-ce que j’ai noté cette semaine ? » ou « Qui ai-je vu en réunion en octobre ? ». S’il répond sans rien voir, c’est presque toujours un droit manquant (voir Droits et outils) : le rebrancher en cochant ce qu’il faut est plus rapide que de chercher ailleurs.

Pour essayer depuis un poste de développement, l’inspecteur officiel suffit : npx @modelcontextprotocol/inspector, transport Streamable HTTP, adresse http://localhost:8787/mcp sur un serveur local.

Un connecteur donne accès à un seul compte Kalepin. Pour utiliser plusieurs comptes dans la même IA (un par entreprise, un personnel), ajoutez un connecteur par compte : chez Google ou Microsoft, vous choisissez le compte au moment du branchement. Dans les outils où les serveurs MCP sont attachés à un profil, un profil par compte suffit, et chaque agent ne voit que les notes de son compte.

Bureau : Paramètres > Connecteurs > Applications connectées. iPhone : la feuille Compte, sous « Applications connectées ». Le retrait est immédiat : le jeton de l’outil cesse de répondre, sans redémarrage ni confirmation de l’autre côté.

Réponse Cause probable
401 à répétition L’accès a été retiré, ou l’outil n’a jamais terminé son autorisation
403 plan_required L’offre du compte ne comprend pas le MCP (Free)
403 insufficient_scope L’outil demande un outil dont le droit n’a pas été coché au consentement
Rien ne remonte L’outil est branché sur un autre compte Kalepin que celui que vous croyez