Aller au contenu

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 :

ServeurAdresseAuthentification
Complethttps://piqline.com/api/mcpclé API en en-tête Authorization: Bearer …
Porte ouvertehttps://piqline.com/api/open/mcpaucune : 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ÉditeurClé en en-tête
Claude (claude.ai, Claude Desktop)Anthropicoui
ChatGPTOpenAInon, porte ouverte seulement
Mistral Le ChatMistral AIoui
Microsoft Copilot StudioMicrosoftoui
Claude CodeAnthropicoui
Codex CLIOpenAIoui
Gemini CLIGoogleoui
CursorAnysphereoui
VS Code (GitHub Copilot)Microsoftoui
ZedZed Industriesoui
ClineClineoui
Roo CodeRoo Codeoui
ContinueContinueoui
WindsurfCognitionpar le relais
JetBrains AI AssistantJetBrainspar le relais
GooseBlockpar le relais
Claude API (Messages)Anthropicoui
OpenAI Responses APIOpenAIoui
OpenAI Agents SDKOpenAIoui
Vercel AI SDKVerceloui
LangChain / LangGraphLangChainoui
Google ADKGoogleoui
n8nn8noui
CrewAICrewAIpar le relais
LlamaIndexLlamaIndexpar le relais
mcp-remote (any local client)Open sourceoui

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/mcp

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.

Texte
https://piqline.com/api/open/mcp

Source : 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é.

Texte
https://piqline.com/api/mcp

Source : 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é.

Texte
https://piqline.com/api/mcp

Source : 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"

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.

TOML
[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

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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

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

JSON
{
  "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.

Texte
https://piqline.com/api/mcp

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

JSON
{
  "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.

JSON
{
  "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.

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

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

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

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

Texte
https://piqline.com/api/mcp

Source : 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).

JSON
{
  "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.

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