指南
连接你的客户端
从 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 | 支持 |
| ChatGPT | OpenAI | 不支持,仅限开放入口 |
| Mistral Le Chat | Mistral AI | 支持 |
| Microsoft Copilot Studio | Microsoft | 支持 |
| Claude Code | Anthropic | 支持 |
| Codex CLI | OpenAI | 支持 |
| Gemini CLI | 支持 | |
| Cursor | Anysphere | 支持 |
| VS Code (GitHub Copilot) | Microsoft | 支持 |
| Zed | Zed Industries | 支持 |
| Cline | Cline | 支持 |
| Roo Code | Roo Code | 支持 |
| Continue | Continue | 支持 |
| Windsurf | Cognition | 通过中继 |
| JetBrains AI Assistant | JetBrains | 通过中继 |
| Goose | Block | 通过中继 |
| Claude API (Messages) | Anthropic | 支持 |
| OpenAI Responses API | OpenAI | 支持 |
| OpenAI Agents SDK | OpenAI | 支持 |
| Vercel AI SDK | Vercel | 支持 |
| LangChain / LangGraph | LangChain | 支持 |
| Google ADK | 支持 | |
| n8n | n8n | 支持 |
| CrewAI | CrewAI | 通过中继 |
| LlamaIndex | LlamaIndex | 通过中继 |
| mcp-remote (any local client) | Open source | 支持 |
助手和应用#
Claude (claude.ai, Claude Desktop)#
位置: 设置 › 连接器 › 添加自定义连接器
粘贴服务器 URL,然后在“请求头”下添加 Authorization,值为 Bearer 加上你的密钥。没有密钥时,开放入口 URL 配合“无需登录”即可使用。
https://piqline.com/api/mcpAuthorization: Bearer piq_live_…在 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"{
"mcpServers": {
"piqline": {
"type": "http",
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer ${PIQLINE_API_KEY}" }
}
}
}来源:code.claude.com,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。已于 2026-11-20 用真实密钥测试。
Codex CLI#
位置: ~/.codex/config.toml
Codex 从环境变量读取密钥:先导出 PIQLINE_API_KEY,然后把服务器添加到配置中。
[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{
"mcpServers": {
"piqline": {
"httpUrl": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}来源:geminicli.com,读取于 2026 年 11 月 20 日(来自官方文档的配置块)。已于 2026-11-20 用真实密钥测试。
Cursor#
位置: ~/.cursor/mcp.json 或 .cursor/mcp.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 格式)取代。
{
"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 下添加服务器。
{
"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。
{
"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
把服务器添加到项目文件中。
{
"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 的密钥存储中。
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 中继。
{
"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 请求头见来源页面。
{
"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 中。
{
"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 服务器。
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。
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 工具。
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 工具集。
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 中,参数里不要有空格(有些客户端会按空格拆分)。
{
"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 用真实密钥测试。