跳到正文

指南

连接你的客户端

从 Claude、ChatGPT、Codex、Cursor、VS Code、Gemini CLI、Zed、Mistral Le Chat、Copilot Studio、n8n、LangChain、Vercel SDK 和任何其他 MCP 客户端连接 Piqline:每个客户端一个可复制的配置块。

Piqline 有两个 MCP 服务器,都使用 Streamable HTTP:

服务器URL认证
完整版https://piqline.com/api/mcp在 Authorization: Bearer … 请求头中携带 API 密钥
开放入口https://piqline.com/api/open/mcp无:Piqline 能做什么,以及它的公开数据

在免费账号中创建密钥,位置是设置 → API 和 MCP。请把它保存在 PIQLINE_API_KEY 环境变量中,不要放在共享文件里。

客户端厂商请求头中的密钥
Claude (claude.ai, Claude Desktop)Anthropic支持
ChatGPTOpenAI不支持,仅限开放入口
Mistral Le ChatMistral AI支持
Microsoft Copilot StudioMicrosoft支持
Claude CodeAnthropic支持
Codex CLIOpenAI支持
Gemini CLIGoogle支持
CursorAnysphere支持
VS Code (GitHub Copilot)Microsoft支持
ZedZed Industries支持
ClineCline支持
Roo CodeRoo Code支持
ContinueContinue支持
WindsurfCognition通过中继
JetBrains AI AssistantJetBrains通过中继
GooseBlock通过中继
Claude API (Messages)Anthropic支持
OpenAI Responses APIOpenAI支持
OpenAI Agents SDKOpenAI支持
Vercel AI SDKVercel支持
LangChain / LangGraphLangChain支持
Google ADKGoogle支持
n8nn8n支持
CrewAICrewAI通过中继
LlamaIndexLlamaIndex通过中继
mcp-remote (any local client)Open source支持

助手和应用#

Claude (claude.ai, Claude Desktop)#

位置: 设置 › 连接器 › 添加自定义连接器

粘贴服务器 URL,然后在“请求头”下添加 Authorization,值为 Bearer 加上你的密钥。没有密钥时,开放入口 URL 配合“无需登录”即可使用。

https://piqline.com/api/mcp

在 Team 和 Enterprise 套餐中,连接器上设置的请求头由所有成员共用:请创建一个专用且设有上限的密钥。

来源:support.claude.com,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。尚未在此用真实密钥测试。

ChatGPT#

位置: 设置 › 应用 › 开发者模式 › 创建

ChatGPT 不接受放在请求头中的密钥:只支持 OAuth 或无认证。目前请无密钥连接开放入口;完整服务器将随 Piqline 账号登录一起提供。

文本
https://piqline.com/api/open/mcp

来源:developers.openai.com,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。尚未在此用真实密钥测试。

Mistral Le Chat#

位置: 连接器 › 添加 MCP 连接器(管理员)

粘贴服务器 URL,选择 Bearer token 认证,然后粘贴你的密钥。

文本
https://piqline.com/api/mcp

来源:docs.mistral.ai,读取于 2026 年 11 月 20 日(依据官方文档组合而成)。尚未在此用真实密钥测试。

Microsoft Copilot Studio#

位置: 智能体 › 工具 › 添加工具 › 新建工具 › Model Context Protocol

粘贴服务器 URL,选择“API 密钥”,位置选“Header”,名称填 Authorization。连接时输入 Bearer 加上你的密钥。

文本
https://piqline.com/api/mcp

来源:learn.microsoft.com,读取于 2026 年 11 月 20 日(依据官方文档组合而成)。尚未在此用真实密钥测试。

编程智能体和编辑器#

Claude Code#

位置: 终端

一条命令。加上 --scope project 可把它写入 .mcp.json,与团队共享。

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

来源:code.claude.com,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。已于 2026-11-20 用真实密钥测试。

Codex CLI#

位置: ~/.codex/config.toml

Codex 从环境变量读取密钥:先导出 PIQLINE_API_KEY,然后把服务器添加到配置中。

TOML
[mcp_servers.piqline]
url = "https://piqline.com/api/mcp"
bearer_token_env_var = "PIQLINE_API_KEY"

来源:learn.chatgpt.com,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。尚未在此用真实密钥测试。

Gemini CLI#

位置: 终端或 ~/.gemini/settings.json

一条命令,或 settings.json 中的配置块。httpUrl 键选择 HTTP 传输(url 表示旧版 SSE)。

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

来源:geminicli.com,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。已于 2026-11-20 用真实密钥测试。

Cursor#

位置: ~/.cursor/mcp.json 或 .cursor/mcp.json

该配置块从环境变量读取密钥。

JSON
{
  "mcpServers": {
    "piqline": {
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer ${env:PIQLINE_API_KEY}" }
    }
  }
}

来源:cursor.com,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。尚未在此用真实密钥测试。

VS Code (GitHub Copilot)#

位置: .vscode/mcp.json

VS Code 在首次连接时询问密钥,并把它保存在自己的密钥存储中。据公告,.vscode/mcp.json 格式将在 2027 年 2 月被根目录的 .mcp.json(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}" }
    }
  }
}

来源:code.visualstudio.com,读取于 2026 年 11 月 20 日(依据官方文档组合而成)。尚未在此用真实密钥测试。

Zed#

位置: Zed settings.json

在 context_servers 下添加服务器。

JSON
{
  "context_servers": {
    "piqline": {
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer piq_live_…" }
    }
  }
}

来源:zed.dev,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。尚未在此用真实密钥测试。

Cline#

位置: cline_mcp_settings.json

type 字段是必填的:没有它,Cline 会回退到旧版 SSE。

JSON
{
  "mcpServers": {
    "piqline": {
      "type": "streamableHttp",
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer piq_live_…" }
    }
  }
}

来源:docs.cline.bot,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。尚未在此用真实密钥测试。

Roo Code#

位置: .roo/mcp.json

把服务器添加到项目文件中。

JSON
{
  "mcpServers": {
    "piqline": {
      "type": "streamable-http",
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer piq_live_…" }
    }
  }
}

来源:roocodeinc.github.io,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。尚未在此用真实密钥测试。

Continue#

位置: Continue config.yaml

密钥保存在 Continue 的密钥存储中。

YAML
mcpServers:
  - name: piqline
    type: streamable-http
    url: https://piqline.com/api/mcp
    requestOptions:
      headers:
        Authorization: "Bearer ${{ secrets.PIQLINE_API_KEY }}"

来源:docs.continue.dev,读取于 2026 年 11 月 20 日(依据官方文档组合而成)。尚未在此用真实密钥测试。

Windsurf#

位置: ~/.codeium/windsurf/mcp_config.json

Windsurf 支持 HTTP 传输和请求头。如果你的版本不接受这个配置块,请使用下面的 mcp-remote 中继。

JSON
{
  "mcpServers": {
    "piqline": {
      "serverUrl": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer piq_live_…" }
    }
  }
}

来源:docs.devin.ai,读取于 2026 年 11 月 20 日(请求头没有文档说明,建议使用中继)。尚未在此用真实密钥测试。

JetBrains AI Assistant#

位置: 设置 › 工具 › AI Assistant › Model Context Protocol

文档中没有给出远程服务器的请求头用法:请使用下面的 mcp-remote 中继。

参见 mcp-remote 中继。

来源:www.jetbrains.com,读取于 2026 年 11 月 20 日(请求头没有文档说明,建议使用中继)。尚未在此用真实密钥测试。

Goose#

位置: goose configure › Add extension › Remote

添加一个远程 HTTP 扩展,填入服务器 URL 和 Authorization 请求头。否则,请使用下面的 mcp-remote 中继。

文本
https://piqline.com/api/mcp

来源:goose-docs.ai,读取于 2026 年 11 月 20 日(请求头没有文档说明,建议使用中继)。尚未在此用真实密钥测试。

API 和智能体框架#

Claude API (Messages)#

位置: Messages API 请求

API 的 MCP 连接器代表模型调用 Piqline。密钥放在 authorization_token 中。当前的 beta 请求头见来源页面。

JSON
{
  "mcp_servers": [
    { "type": "url", "url": "https://piqline.com/api/mcp", "name": "piqline", "authorization_token": "piq_live_…" }
  ]
}

来源:platform.claude.com,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。尚未在此用真实密钥测试。

OpenAI Responses API#

位置: Responses 请求的 mcp 工具

密钥放在 headers 中。

JSON
{
  "type": "mcp",
  "server_label": "piqline",
  "server_url": "https://piqline.com/api/mcp",
  "headers": { "Authorization": "Bearer piq_live_…" },
  "require_approval": "never"
}

来源:developers.openai.com,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。尚未在此用真实密钥测试。

OpenAI Agents SDK#

位置: Python

带请求头的 Streamable HTTP 服务器。

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']}"},
})

来源:openai.github.io,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。已于 2026-11-20 用真实密钥测试。

Vercel AI SDK#

位置: TypeScript

MCP 客户端把工具交给 generateText 或 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();

来源:ai-sdk.dev,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。已于 2026-11-20 用真实密钥测试。

LangChain / LangGraph#

位置: Python

Piqline 的工具会成为 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()

来源:github.com,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。已于 2026-11-20 用真实密钥测试。

Google ADK#

位置: Python

供 ADK 智能体使用的 MCP 工具集。

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']}"},
))

来源:adk.dev,读取于 2026 年 11 月 20 日(依据官方文档组合而成)。尚未在此用真实密钥测试。

n8n#

位置: AI 智能体的“MCP Client Tool”节点

粘贴服务器 URL,选择 HTTP 传输和“Bearer”认证,然后粘贴你的密钥。

文本
https://piqline.com/api/mcp

来源:docs.n8n.io,读取于 2026 年 11 月 20 日(依据官方文档组合而成)。尚未在此用真实密钥测试。

CrewAI#

位置: Python

CrewAI 通过 Streamable HTTP 连接;其文档没有给出请求头用法。请使用 mcp-remote 中继,或使用 LangChain。

参见 mcp-remote 中继。

来源:docs.crewai.com,读取于 2026 年 11 月 20 日(请求头没有文档说明,建议使用中继)。尚未在此用真实密钥测试。

LlamaIndex#

位置: Python

LlamaIndex 连接 HTTP 服务器;其文档没有给出请求头用法。请使用 mcp-remote 中继。

参见 mcp-remote 中继。

来源:developers.llamaindex.ai,读取于 2026 年 11 月 20 日(请求头没有文档说明,建议使用中继)。尚未在此用真实密钥测试。

任何其他客户端#

mcp-remote (any local client)#

位置: 你的客户端的 MCP 配置文件

适用于只能与本地进程(stdio)通信的客户端:mcp-remote 负责中继 HTTP 服务器。请求头的值放在 env 中,参数里不要有空格(有些客户端会按空格拆分)。

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_…" }
    }
  }
}

来源:github.com,读取于 2026 年 11 月 20 日(依据官方文档组合而成)。已于 2026-11-20 用真实密钥测试。

对 API 有疑问,或发现本页有误? 联系我们.