Aller au contenu

Guides

Serveur MCP

Les serveurs MCP de Piqline, leurs outils, les outils ask_<agent> et les annotations.

Le serveur MCP expose les mêmes outils que l’API, et un outil par agent. Il utilise le transport HTTP « Streamable HTTP », sans session : chaque requête est indépendante. La clé s’envoie comme pour l’API, dans l’en-tête Authorization.

Les serveurs#

ServeurAdresseContenu
Tous les outilshttps://piqline.com/api/mcptous les outils que la clé peut appeler, et ask_<agent> pour chaque agent
Un agenthttps://piqline.com/api/mcp/{agent}les outils de cet agent, et son ask_<agent>

{agent} vaut piqline, requete, facebook, linkedin, upwork ou onboarding. Le serveur d’un seul agent convient aux clients qui limitent le nombre d’outils.

tools/list ne montre que les outils que la clé peut appeler : un outil absent demande un scope que la clé n’a pas. Les outils ask_<agent> demandent le scope agents, et ask_onboarding un rôle owner ou admin.

Brancher un client#

Chaque client a son bloc à copier, vérifié dans sa documentation officielle, dans Connecter votre client : Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Zed, Cline, Mistral Le Chat, Copilot Studio, n8n, LangChain, le SDK Vercel et un relais pour tout client local. Par exemple, dans Claude Code :

Shell
claude mcp add --transport http piqline https://piqline.com/api/mcp \
  --header "Authorization: Bearer $PIQLINE_API_KEY"

Les outils ask_<agent>#

ask_piqline, ask_requete, ask_facebook, ask_linkedin, ask_upwork et ask_onboarding confient une demande entière à l’agent correspondant, comme POST/api/v1/agents/{agent}.

ArgumentRôle
messageLa demande, en langage naturel (obligatoire).
historyLes échanges précédents avec cet agent, du plus ancien au plus récent : des objets { "role": "user" ou "assistant", "text": "…" }.

La réponse contient le texte de l’agent. Quand l’agent s’arrête pour une question ou pour une action à confirmer, elle le dit et indique l’outil à appeler.

Annotations#

Chaque outil déclare readOnlyHint, destructiveHint et openWorldHint. Un client peut s’en servir pour demander une confirmation avant les outils qui écrivent, suppriment ou lisent en direct.

Erreurs#

Un outil qui échoue répond avec isError: true et un message lisible. Les refus qui précèdent l’outil (clé, scope, limite) sont des réponses HTTP 401, 403 ou 429 en application/problem+json, décrites dans Erreurs. Les deux cas apparaissent dans l’historique des requêtes de Settings → API and MCP.

Connexion par compte#

ChatGPT n’accepte qu’une connexion OAuth ou aucune authentification : il se branche aujourd’hui sur la porte ouverte, https://piqline.com/api/open/mcp. La connexion par compte Piqline (OAuth) est en préparation ; tous les autres clients de la page Connecter votre client acceptent la clé.

Une question sur l’API, ou une erreur dans cette page ? Écrivez-nous.