Skip to content

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:

ServerURLAuthentication
Fullhttps://piqline.com/api/mcpAPI key in the Authorization: Bearer … header
Open doorhttps://piqline.com/api/open/mcpnone: 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.

ClientVendorKey in a header
Claude (claude.ai, Claude Desktop)Anthropicyes
ChatGPTOpenAIno, open door only
Mistral Le ChatMistral AIyes
Microsoft Copilot StudioMicrosoftyes
Claude CodeAnthropicyes
Codex CLIOpenAIyes
Gemini CLIGoogleyes
CursorAnysphereyes
VS Code (GitHub Copilot)Microsoftyes
ZedZed Industriesyes
ClineClineyes
Roo CodeRoo Codeyes
ContinueContinueyes
WindsurfCognitionthrough the relay
JetBrains AI AssistantJetBrainsthrough the relay
GooseBlockthrough the relay
Claude API (Messages)Anthropicyes
OpenAI Responses APIOpenAIyes
OpenAI Agents SDKOpenAIyes
Vercel AI SDKVercelyes
LangChain / LangGraphLangChainyes
Google ADKGoogleyes
n8nn8nyes
CrewAICrewAIthrough the relay
LlamaIndexLlamaIndexthrough the relay
mcp-remote (any local client)Open sourceyes

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

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.

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

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

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

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

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

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

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.

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

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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, read on 20 Nov 2026 (assembled from the official documentation). Tested with a real key on 2026-11-20.

A question about the API, or a mistake on this page? Write to us.