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 Desktop

   Pas encore supporté nativement

   Claude Desktop n’autorise que l’OAuth 2.1 pour les connecteurs remote custom — l’UI n’expose pas de champ pour les headers Authorization qu’on utilise (clé API pylk_). Le support OAuth est en cours côté Pylote (ETA quelques semaines).

   Workaround pour utilisateurs avancés : passe par mcp-remote (bridge stdio→HTTP, non officiel Anthropic) dans ~/Library/Application Support/Claude/claude_desktop_config.json :

   {
     "mcpServers": {
       "pylote": {
         "command": "npx",
         "args": [
           "-y", "mcp-remote",
           "https://api-prod.pylote.io/mcp",
           "--header", "Authorization: Bearer pylk_xxx_xxxxxxxxxxxxxxxxxxxxxxxx"
         ]
       }
     }
   }

   Nécessite Node.js installé. Redémarre Claude Desktop complètement (quitte depuis le dock / systray).

   ChatGPT

   ChatGPT ne supporte pas encore MCP nativement. Utilise plutôt la REST API via un Custom GPT avec Actions.

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 7 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.

Claude Desktop ne voit pas le serveur

Si tu utilises le workaround mcp-remote, relance Claude Desktop complètement (quitte depuis le dock / systray, pas juste ferme la fenêtre). Vérifie aussi que node et npx sont dans ton PATH.