Guides
Connect your client
Connect Piqline from Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Zed, Mistral Le Chat, Copilot Studio, n8n, LangChain, the Vercel SDK and any other MCP client: one block to copy per client.
Piqline has two MCP servers, both over Streamable HTTP:
| Server | URL | Authentication |
|---|---|---|
| Full | https://piqline.com/api/mcp | API key in the Authorization: Bearer … header |
| Open door | https://piqline.com/api/open/mcp | none: what Piqline can do, and its public data |
Create the key in a free account, Settings → API and MCP. Keep it in a PIQLINE_API_KEY environment variable rather than in a shared file.
| Client | Vendor | Key in a header |
|---|---|---|
| Claude (claude.ai, Claude Desktop) | Anthropic | yes |
| ChatGPT | OpenAI | no, open door only |
| Mistral Le Chat | Mistral AI | yes |
| Microsoft Copilot Studio | Microsoft | yes |
| Claude Code | Anthropic | yes |
| Codex CLI | OpenAI | yes |
| Gemini CLI | yes | |
| Cursor | Anysphere | yes |
| VS Code (GitHub Copilot) | Microsoft | yes |
| Zed | Zed Industries | yes |
| Cline | Cline | yes |
| Roo Code | Roo Code | yes |
| Continue | Continue | yes |
| Windsurf | Cognition | through the relay |
| JetBrains AI Assistant | JetBrains | through the relay |
| Goose | Block | through the relay |
| Claude API (Messages) | Anthropic | yes |
| OpenAI Responses API | OpenAI | yes |
| OpenAI Agents SDK | OpenAI | yes |
| Vercel AI SDK | Vercel | yes |
| LangChain / LangGraph | LangChain | yes |
| Google ADK | yes | |
| n8n | n8n | yes |
| CrewAI | CrewAI | through the relay |
| LlamaIndex | LlamaIndex | through the relay |
| mcp-remote (any local client) | Open source | yes |
Assistants and apps#
Claude (claude.ai, Claude Desktop)#
Where: Settings › Connectors › Add custom connector
Paste the server URL, then under “Request headers” add Authorization with the value Bearer followed by your key. Without a key, the open-door URL works with “No sign in”.
https://piqline.com/api/mcpAuthorization: Bearer piq_live_…On Team and Enterprise plans, a header set on the connector is shared by every member: create a dedicated, capped key.
Source: support.claude.com, read on 20 Nov 2026 (block from the official documentation). Not yet tested here with a real key.
ChatGPT#
Where: Settings › Apps › Developer mode › Create
ChatGPT does not accept a key in a header: only OAuth or no authentication. Connect the open door today, with no key; the full server comes with sign-in through a Piqline account.
https://piqline.com/api/open/mcpSource: developers.openai.com, read on 20 Nov 2026 (block from the official documentation). Not yet tested here with a real key.
Mistral Le Chat#
Where: Connectors › Add MCP connector (admin)
Paste the server URL, choose Bearer token authentication, then paste your key.
https://piqline.com/api/mcpSource: docs.mistral.ai, read on 20 Nov 2026 (assembled from the official documentation). Not yet tested here with a real key.
Microsoft Copilot Studio#
Where: Agent › Tools › Add a tool › New tool › Model Context Protocol
Paste the server URL, choose “API key”, location “Header”, name Authorization. When connecting, enter Bearer followed by your key.
https://piqline.com/api/mcpSource: learn.microsoft.com, read on 20 Nov 2026 (assembled from the official documentation). Not yet tested here with a real key.
Coding agents and editors#
Claude Code#
Where: Terminal
One command. Add --scope project to write it to .mcp.json and share it with the team.
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, read on 20 Nov 2026 (block from the official documentation). Tested with a real key on 2026-11-20.
Codex CLI#
Where: ~/.codex/config.toml
Codex reads the key from an environment variable: export PIQLINE_API_KEY, then add the server to the config.
[mcp_servers.piqline]
url = "https://piqline.com/api/mcp"
bearer_token_env_var = "PIQLINE_API_KEY"Source: learn.chatgpt.com, read on 20 Nov 2026 (block from the official documentation). Not yet tested here with a real key.
Gemini CLI#
Where: Terminal or ~/.gemini/settings.json
One command, or the block in settings.json. The httpUrl key selects the HTTP transport (url would mean legacy 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, read on 20 Nov 2026 (block from the official documentation). Tested with a real key on 2026-11-20.
Cursor#
Where: ~/.cursor/mcp.json or .cursor/mcp.json
The block reads the key from an environment variable.
{
"mcpServers": {
"piqline": {
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer ${env:PIQLINE_API_KEY}" }
}
}
}Source: cursor.com, read on 20 Nov 2026 (block from the official documentation). Not yet tested here with a real key.
VS Code (GitHub Copilot)#
Where: .vscode/mcp.json
VS Code asks for the key on first connection and keeps it in its secret store. The .vscode/mcp.json format is announced as replaced in February 2027 by a root .mcp.json, in the Claude Code format.
{
"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, read on 20 Nov 2026 (assembled from the official documentation). Not yet tested here with a real key.
Zed#
Where: Zed settings.json
Add the server under context_servers.
{
"context_servers": {
"piqline": {
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Source: zed.dev, read on 20 Nov 2026 (block from the official documentation). Not yet tested here with a real key.
Cline#
Where: cline_mcp_settings.json
The type field is required: without it, Cline falls back to legacy SSE.
{
"mcpServers": {
"piqline": {
"type": "streamableHttp",
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Source: docs.cline.bot, read on 20 Nov 2026 (block from the official documentation). Not yet tested here with a real key.
Roo Code#
Where: .roo/mcp.json
Add the server to the project file.
{
"mcpServers": {
"piqline": {
"type": "streamable-http",
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Source: roocodeinc.github.io, read on 20 Nov 2026 (block from the official documentation). Not yet tested here with a real key.
Continue#
Where: Continue config.yaml
The key stays in Continue secrets.
mcpServers:
- name: piqline
type: streamable-http
url: https://piqline.com/api/mcp
requestOptions:
headers:
Authorization: "Bearer ${{ secrets.PIQLINE_API_KEY }}"Source: docs.continue.dev, read on 20 Nov 2026 (assembled from the official documentation). Not yet tested here with a real key.
Windsurf#
Where: ~/.codeium/windsurf/mcp_config.json
Windsurf accepts the HTTP transport and headers. If your version rejects this block, use the mcp-remote relay below.
{
"mcpServers": {
"piqline": {
"serverUrl": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}Source: docs.devin.ai, read on 20 Nov 2026 (headers undocumented, relay advised). Not yet tested here with a real key.
JetBrains AI Assistant#
Where: Settings › Tools › AI Assistant › Model Context Protocol
The documentation shows no header for a remote server: use the mcp-remote relay below.
See the mcp-remote relay.
Source: www.jetbrains.com, read on 20 Nov 2026 (headers undocumented, relay advised). Not yet tested here with a real key.
Goose#
Where: goose configure › Add extension › Remote
Add a remote HTTP extension with the server URL and the Authorization header. Otherwise, use the mcp-remote relay below.
https://piqline.com/api/mcpSource: goose-docs.ai, read on 20 Nov 2026 (headers undocumented, relay advised). Not yet tested here with a real key.
APIs and agent frameworks#
Claude API (Messages)#
Where: Messages API request
The API's MCP connector calls Piqline for the model. The key goes in authorization_token. See the source page for the current beta header.
{
"mcp_servers": [
{ "type": "url", "url": "https://piqline.com/api/mcp", "name": "piqline", "authorization_token": "piq_live_…" }
]
}Source: platform.claude.com, read on 20 Nov 2026 (block from the official documentation). Not yet tested here with a real key.
OpenAI Responses API#
Where: mcp tool of a Responses request
The key goes in 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, read on 20 Nov 2026 (block from the official documentation). Not yet tested here with a real key.
OpenAI Agents SDK#
Where: Python
A Streamable HTTP server with the header.
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, read on 20 Nov 2026 (block from the official documentation). Tested with a real key on 2026-11-20.
Vercel AI SDK#
Where: TypeScript
The MCP client hands the tools to generateText or 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, read on 20 Nov 2026 (block from the official documentation). Tested with a real key on 2026-11-20.
LangChain / LangGraph#
Where: Python
Piqline tools become LangChain tools.
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, read on 20 Nov 2026 (block from the official documentation). Tested with a real key on 2026-11-20.
Google ADK#
Where: Python
An MCP toolset for an ADK agent.
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, read on 20 Nov 2026 (assembled from the official documentation). Not yet tested here with a real key.
n8n#
Where: “MCP Client Tool” node of an AI agent
Paste the server URL, pick the HTTP transport and “Bearer” authentication, then paste your key.
https://piqline.com/api/mcpSource: docs.n8n.io, read on 20 Nov 2026 (assembled from the official documentation). Not yet tested here with a real key.
CrewAI#
Where: Python
CrewAI connects over Streamable HTTP; its documentation shows no header. Use the mcp-remote relay, or LangChain.
See the mcp-remote relay.
Source: docs.crewai.com, read on 20 Nov 2026 (headers undocumented, relay advised). Not yet tested here with a real key.
LlamaIndex#
Where: Python
LlamaIndex connects to an HTTP server; its documentation shows no header. Use the mcp-remote relay.
See the mcp-remote relay.
Source: developers.llamaindex.ai, read on 20 Nov 2026 (headers undocumented, relay advised). Not yet tested here with a real key.
Any other client#
mcp-remote (any local client)#
Where: Your client's MCP config file
For a client that only talks to a local process (stdio): mcp-remote relays the HTTP server. The header value lives in env, with no space in the arguments (some clients split on spaces).
{
"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, read on 20 Nov 2026 (assembled from the official documentation). Tested with a real key on 2026-11-20.