Guides
Connecter votre client
Brancher Piqline depuis Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Zed, Mistral Le Chat, Copilot Studio, n8n, LangChain, le SDK Vercel et tout autre client MCP : un bloc à copier par client.
Piqline a deux serveurs MCP, tous deux en Streamable HTTP :
| Serveur | Adresse | Authentification |
|---|---|---|
| Complet | https://piqline.com/api/mcp | clé API en en-tête Authorization: Bearer … |
| Porte ouverte | https://piqline.com/api/open/mcp | aucune : ce que Piqline peut faire, et ses données publiques |
La clé se crée dans un compte gratuit, Réglages → API et MCP. Gardez-la dans une variable d’environnement PIQLINE_API_KEY plutôt que dans un fichier partagé.
| Client | Éditeur | Clé en en-tête |
|---|---|---|
| Claude (claude.ai, Claude Desktop) | Anthropic | oui |
| ChatGPT | OpenAI | non, porte ouverte seulement |
| Mistral Le Chat | Mistral AI | oui |
| Microsoft Copilot Studio | Microsoft | oui |
| Claude Code | Anthropic | oui |
| Codex CLI | OpenAI | oui |
| Gemini CLI | oui | |
| Cursor | Anysphere | oui |
| VS Code (GitHub Copilot) | Microsoft | oui |
| Zed | Zed Industries | oui |
| Cline | Cline | oui |
| Roo Code | Roo Code | oui |
| Continue | Continue | oui |
| Windsurf | Cognition | par le relais |
| JetBrains AI Assistant | JetBrains | par le relais |
| Goose | Block | par le relais |
| Claude API (Messages) | Anthropic | oui |
| OpenAI Responses API | OpenAI | oui |
| OpenAI Agents SDK | OpenAI | oui |
| Vercel AI SDK | Vercel | oui |
| LangChain / LangGraph | LangChain | oui |
| Google ADK | oui | |
| n8n | n8n | oui |
| CrewAI | CrewAI | par le relais |
| LlamaIndex | LlamaIndex | par le relais |
| mcp-remote (any local client) | Open source | oui |
Assistants et applications#
Claude (claude.ai, Claude Desktop)#
Où : Réglages › Connecteurs › Ajouter un connecteur personnalisé
Collez l’adresse du serveur, puis dans « En-têtes de requête » ajoutez Authorization avec la valeur Bearer suivie de votre clé. Sans clé, l’adresse de la porte ouverte marche avec « Pas de connexion ».
https://piqline.com/api/mcpAuthorization: Bearer piq_live_…Sur les offres Team et Enterprise, un en-tête posé sur le connecteur vaut pour tous les membres : créez une clé dédiée, plafonnée.
Source : support.claude.com, lue le 20 nov. 2026 (bloc de la documentation officielle). Pas encore essayé ici avec une vraie clé.
ChatGPT#
Où : Réglages › Applications › Mode développeur › Créer
ChatGPT n’accepte pas de clé en en-tête : seulement OAuth ou aucune authentification. Branchez aujourd’hui la porte ouverte, sans clé ; le serveur complet arrive avec la connexion par compte Piqline.
https://piqline.com/api/open/mcpSource : developers.openai.com, lue le 20 nov. 2026 (bloc de la documentation officielle). Pas encore essayé ici avec une vraie clé.
Mistral Le Chat#
Où : Connecteurs › Ajouter un connecteur MCP (administrateur)
Collez l’adresse du serveur et choisissez l’authentification par jeton Bearer, puis collez votre clé.
https://piqline.com/api/mcpSource : docs.mistral.ai, lue le 20 nov. 2026 (assemblé depuis la documentation officielle). Pas encore essayé ici avec une vraie clé.
Microsoft Copilot Studio#
Où : Agent › Outils › Ajouter un outil › Nouvel outil › Model Context Protocol
Collez l’adresse du serveur, choisissez « Clé API », emplacement « En-tête », nom Authorization. À la connexion, saisissez Bearer suivi de votre clé.
https://piqline.com/api/mcpSource : learn.microsoft.com, lue le 20 nov. 2026 (assemblé depuis la documentation officielle). Pas encore essayé ici avec une vraie clé.
Agents de code et éditeurs#
Claude Code#
Où : Terminal
Une commande. Ajoutez --scope project pour l’écrire dans .mcp.json et la partager avec l’équipe.
claude mcp add --transport http piqline https://piqline.com/api/mcp \
--header "Authorization: Bearer $PIQLINE_API_KEY"{
"mcpServers": {
"piqline": {
"type": "http",
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer ${PIQLINE_API_KEY}" }
}
}
}Source : code.claude.com, lue le 20 nov. 2026 (bloc de la documentation officielle). Essayé avec une vraie clé le 2026-11-20.
Codex CLI#
Où : ~/.codex/config.toml
Codex lit la clé dans une variable d’environnement : exportez PIQLINE_API_KEY, puis ajoutez le serveur à la configuration.
[mcp_servers.piqline]
url = "https://piqline.com/api/mcp"
bearer_token_env_var = "PIQLINE_API_KEY"Source : learn.chatgpt.com, lue le 20 nov. 2026 (bloc de la documentation officielle). Pas encore essayé ici avec une vraie clé.
Gemini CLI#
Où : Terminal ou ~/.gemini/settings.json
Une commande, ou le bloc dans settings.json. La clé httpUrl désigne le transport HTTP (url désignerait l’ancien SSE).
gemini mcp add --transport http \
--header "Authorization: Bearer $PIQLINE_API_KEY" piqline https://piqline.com/api/mcp{
"mcpServers": {
"piqline": {
"httpUrl": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Source : geminicli.com, lue le 20 nov. 2026 (bloc de la documentation officielle). Essayé avec une vraie clé le 2026-11-20.
Cursor#
Où : ~/.cursor/mcp.json ou .cursor/mcp.json
Le bloc lit la clé dans une variable d’environnement.
{
"mcpServers": {
"piqline": {
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer ${env:PIQLINE_API_KEY}" }
}
}
}Source : cursor.com, lue le 20 nov. 2026 (bloc de la documentation officielle). Pas encore essayé ici avec une vraie clé.
VS Code (GitHub Copilot)#
Où : .vscode/mcp.json
VS Code demande la clé à la première connexion et la garde dans son coffre. Le format .vscode/mcp.json est annoncé comme remplacé en février 2027 par un .mcp.json à la racine, au format de Claude Code.
{
"inputs": [
{ "type": "promptString", "id": "piqline-key", "description": "Piqline API key", "password": true }
],
"servers": {
"piqline": {
"type": "http",
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer ${input:piqline-key}" }
}
}
}Source : code.visualstudio.com, lue le 20 nov. 2026 (assemblé depuis la documentation officielle). Pas encore essayé ici avec une vraie clé.
Zed#
Où : settings.json de Zed
Ajoutez le serveur dans context_servers.
{
"context_servers": {
"piqline": {
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Source : zed.dev, lue le 20 nov. 2026 (bloc de la documentation officielle). Pas encore essayé ici avec une vraie clé.
Cline#
Où : cline_mcp_settings.json
Le champ type est obligatoire : sans lui, Cline retombe sur l’ancien SSE.
{
"mcpServers": {
"piqline": {
"type": "streamableHttp",
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Source : docs.cline.bot, lue le 20 nov. 2026 (bloc de la documentation officielle). Pas encore essayé ici avec une vraie clé.
Roo Code#
Où : .roo/mcp.json
Ajoutez le serveur au fichier du projet.
{
"mcpServers": {
"piqline": {
"type": "streamable-http",
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Source : roocodeinc.github.io, lue le 20 nov. 2026 (bloc de la documentation officielle). Pas encore essayé ici avec une vraie clé.
Continue#
Où : config.yaml de Continue
La clé reste dans les secrets de Continue.
mcpServers:
- name: piqline
type: streamable-http
url: https://piqline.com/api/mcp
requestOptions:
headers:
Authorization: "Bearer ${{ secrets.PIQLINE_API_KEY }}"Source : docs.continue.dev, lue le 20 nov. 2026 (assemblé depuis la documentation officielle). Pas encore essayé ici avec une vraie clé.
Windsurf#
Où : ~/.codeium/windsurf/mcp_config.json
Windsurf accepte le transport HTTP et des en-têtes. Si votre version refuse ce bloc, utilisez le relais mcp-remote plus bas.
{
"mcpServers": {
"piqline": {
"serverUrl": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Source : docs.devin.ai, lue le 20 nov. 2026 (en-têtes non documentés, relais conseillé). Pas encore essayé ici avec une vraie clé.
JetBrains AI Assistant#
Où : Réglages › Outils › AI Assistant › Model Context Protocol
La documentation ne montre pas d’en-tête pour un serveur distant : passez par le relais mcp-remote plus bas.
Voir le relais mcp-remote.
Source : www.jetbrains.com, lue le 20 nov. 2026 (en-têtes non documentés, relais conseillé). Pas encore essayé ici avec une vraie clé.
Goose#
Où : goose configure › Ajouter une extension › Distante
Ajoutez une extension distante en HTTP avec l’adresse du serveur et l’en-tête Authorization. Sinon, le relais mcp-remote plus bas.
https://piqline.com/api/mcpSource : goose-docs.ai, lue le 20 nov. 2026 (en-têtes non documentés, relais conseillé). Pas encore essayé ici avec une vraie clé.
API et cadres d’agents#
Claude API (Messages)#
Où : Requête à l’API Messages
Le connecteur MCP de l’API appelle Piqline pour le modèle. La clé passe dans authorization_token. Reportez-vous à la page source pour l’en-tête bêta en vigueur.
{
"mcp_servers": [
{ "type": "url", "url": "https://piqline.com/api/mcp", "name": "piqline", "authorization_token": "piq_live_…" }
]
}Source : platform.claude.com, lue le 20 nov. 2026 (bloc de la documentation officielle). Pas encore essayé ici avec une vraie clé.
OpenAI Responses API#
Où : Outil mcp d’une requête Responses
La clé passe dans headers.
{
"type": "mcp",
"server_label": "piqline",
"server_url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" },
"require_approval": "never"
}Source : developers.openai.com, lue le 20 nov. 2026 (bloc de la documentation officielle). Pas encore essayé ici avec une vraie clé.
OpenAI Agents SDK#
Où : Python
Un serveur Streamable HTTP avec l’en-tête.
import os
from agents.mcp import MCPServerStreamableHttp
piqline = MCPServerStreamableHttp(params={
"url": "https://piqline.com/api/mcp",
"headers": {"Authorization": f"Bearer {os.environ['PIQLINE_API_KEY']}"},
})Source : openai.github.io, lue le 20 nov. 2026 (bloc de la documentation officielle). Essayé avec une vraie clé le 2026-11-20.
Vercel AI SDK#
Où : TypeScript
Le client MCP donne les outils à generateText ou streamText.
import { createMCPClient } from "@ai-sdk/mcp";
const piqline = await createMCPClient({
transport: {
type: "http",
url: "https://piqline.com/api/mcp",
headers: { Authorization: `Bearer ${process.env.PIQLINE_API_KEY}` },
},
});
const tools = await piqline.tools();Source : ai-sdk.dev, lue le 20 nov. 2026 (bloc de la documentation officielle). Essayé avec une vraie clé le 2026-11-20.
LangChain / LangGraph#
Où : Python
Les outils Piqline deviennent des outils LangChain.
import os
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({
"piqline": {
"transport": "http",
"url": "https://piqline.com/api/mcp",
"headers": {"Authorization": f"Bearer {os.environ['PIQLINE_API_KEY']}"},
}
})
tools = await client.get_tools()Source : github.com, lue le 20 nov. 2026 (bloc de la documentation officielle). Essayé avec une vraie clé le 2026-11-20.
Google ADK#
Où : Python
Un jeu d’outils MCP pour un agent ADK.
import os
from google.adk.tools.mcp_tool import McpToolset, StreamableHTTPConnectionParams
piqline = McpToolset(connection_params=StreamableHTTPConnectionParams(
url="https://piqline.com/api/mcp",
headers={"Authorization": f"Bearer {os.environ['PIQLINE_API_KEY']}"},
))Source : adk.dev, lue le 20 nov. 2026 (assemblé depuis la documentation officielle). Pas encore essayé ici avec une vraie clé.
n8n#
Où : Nœud « MCP Client Tool » d’un agent IA
Collez l’adresse du serveur, transport HTTP, authentification « Bearer », puis votre clé.
https://piqline.com/api/mcpSource : docs.n8n.io, lue le 20 nov. 2026 (assemblé depuis la documentation officielle). Pas encore essayé ici avec une vraie clé.
CrewAI#
Où : Python
CrewAI se branche en Streamable HTTP ; la documentation ne montre pas d’en-tête. Passez par le relais mcp-remote, ou par LangChain.
Voir le relais mcp-remote.
Source : docs.crewai.com, lue le 20 nov. 2026 (en-têtes non documentés, relais conseillé). Pas encore essayé ici avec une vraie clé.
LlamaIndex#
Où : Python
LlamaIndex se branche sur un serveur HTTP ; la documentation ne montre pas d’en-tête. Passez par le relais mcp-remote.
Voir le relais mcp-remote.
Source : developers.llamaindex.ai, lue le 20 nov. 2026 (en-têtes non documentés, relais conseillé). Pas encore essayé ici avec une vraie clé.
Tout autre client#
mcp-remote (any local client)#
Où : Le fichier de configuration MCP de votre client
Pour un client qui ne parle qu’à un processus local (stdio) : mcp-remote relaie le serveur HTTP. La valeur de l’en-tête est dans env, sans espace dans les arguments (certains clients coupent sur les espaces).
{
"mcpServers": {
"piqline": {
"command": "npx",
"args": ["mcp-remote", "https://piqline.com/api/mcp", "--transport", "http-only", "--header", "Authorization:${AUTH_HEADER}"],
"env": { "AUTH_HEADER": "Bearer piq_live_…" }
}
}
}Source : github.com, lue le 20 nov. 2026 (assemblé depuis la documentation officielle). Essayé avec une vraie clé le 2026-11-20.