MCP Quickstart

1. Passe à Pylote Plus

   Le MCP est réservé à Pylote Plus (19 €/mois). Pas de trial — si tu as juste besoin de l’API REST pour tester, le plan gratuit suffit.

2. Récupère ta clé API

   Ouvre l’extension Pylote → Settings → Clé API → bouton reveal → copie. La clé commence toujours par pylk_.

3. Configure ton client

   Claude Code

   Une seule commande dans ton terminal :

   claude mcp add --transport http pylote https://api-prod.pylote.io/mcp \
     --header "Authorization: Bearer pylk_xxx_xxxxxxxxxxxxxxxxxxxxxxxx"

   Vérifie avec claude mcp list — tu dois voir pylote ✓ Connected.

   Cursor

   Settings → MCP → Add Server :

   {
     "pylote": {
       "url": "https://api-prod.pylote.io/mcp",
       "headers": {
         "Authorization": "Bearer pylk_xxx_xxxxxxxxxxxxxxxxxxxxxxxx"
       }
     }
   }

   claude.ai / Desktop / Cowork

   Connecteur personnalisé en 1 clic (OAuth — aucune commande) :

   1. Réglages → Connecteurs → Ajouter un connecteur personnalisé
   2. URL : https://api-prod.pylote.io/mcp — laisse Client ID / Secret vides (l’enregistrement est automatique).
   3. Clique Connecter : une page Pylote s’ouvre.
   4. Colle ta clé pylk_ (extension → Settings → Clé API) et clique Autoriser.
   5. Les outils Pylote apparaissent. C’est tout.

   Ta clé n'est jamais partagée avec l'assistant

   La clé sert uniquement à confirmer ton identité au moment du consent. L’assistant, lui, reçoit un token OAuth (jamais ta clé), révocable et limité dans le temps.

   ChatGPT / Codex

   Active le Developer mode (Settings → Connectors), puis ajoute un connecteur avec l’URL https://api-prod.pylote.io/mcp. Même flux OAuth : laisse Client ID / Secret vides, colle ta clé pylk_ sur la page de consent Pylote, autorise. Les tools Pylote deviennent disponibles.

4. Lance ton premier prompt

   Une fois la config en place, tape dans ta conversation :

   « Liste mes leads recruteurs de la semaine et prépare un message LinkedIn pour chacun. »

   L’agent appellera get_leads (tool Pylote), récupérera les données, et rédigera les messages.

5. Explore les 13 outils

   Voir la référence des tools pour la liste complète avec exemples. Les usages les plus courants sont dans les exemples.

Troubleshooting

401 Unauthorized

Ta clé est mal formée. Vérifie qu’elle commence par pylk_ et qu’elle fait bien ~60 caractères (pas tronquée).

403 Forbidden — MCP is a Pylote Plus feature

Ton compte est en gratuit. Le MCP est réservé à Pylote Plus. La REST API reste accessible sur le gratuit avec un quota de 60 req/h.

429 Rate limit exceeded

Tu as dépassé ton quota Plus (1000 req/min). Attends quelques secondes, ou contacte-nous si tu as un cas d’usage qui nécessite plus.

La page de consent ne reconnaît pas ta clé

Recopie ta clé actuelle depuis l’extension (Settings → Clé API). Si tu l’as régénérée, l’ancienne ne marche plus. La clé doit commencer par pylk_ et être complète (~60 caractères).

Le connecteur demande un Client ID / Secret

Laisse ces champs vides : Pylote enregistre le client automatiquement (DCR). Renseigne juste l’URL https://api-prod.pylote.io/mcp.