# 连接你的客户端

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

Source: https://piqline.com/zh/docs/api/clients

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)](#claude-claude-ai-claude-desktop) | Anthropic | 支持 |
| [ChatGPT](#chatgpt) | OpenAI | 不支持，仅限开放入口 |
| [Mistral Le Chat](#mistral-le-chat) | Mistral AI | 支持 |
| [Microsoft Copilot Studio](#microsoft-copilot-studio) | Microsoft | 支持 |
| [Claude Code](#claude-code) | Anthropic | 支持 |
| [Codex CLI](#codex-cli) | OpenAI | 支持 |
| [Gemini CLI](#gemini-cli) | Google | 支持 |
| [Cursor](#cursor) | Anysphere | 支持 |
| [VS Code (GitHub Copilot)](#vs-code-github-copilot) | Microsoft | 支持 |
| [Zed](#zed) | Zed Industries | 支持 |
| [Cline](#cline) | Cline | 支持 |
| [Roo Code](#roo-code) | Roo Code | 支持 |
| [Continue](#continue) | Continue | 支持 |
| [Windsurf](#windsurf) | Cognition | 通过中继 |
| [JetBrains AI Assistant](#jetbrains-ai-assistant) | JetBrains | 通过中继 |
| [Goose](#goose) | Block | 通过中继 |
| [Claude API (Messages)](#claude-api-messages) | Anthropic | 支持 |
| [OpenAI Responses API](#openai-responses-api) | OpenAI | 支持 |
| [OpenAI Agents SDK](#openai-agents-sdk) | OpenAI | 支持 |
| [Vercel AI SDK](#vercel-ai-sdk) | Vercel | 支持 |
| [LangChain / LangGraph](#langchain-langgraph) | LangChain | 支持 |
| [Google ADK](#google-adk) | Google | 支持 |
| [n8n](#n8n) | n8n | 支持 |
| [CrewAI](#crewai) | CrewAI | 通过中继 |
| [LlamaIndex](#llamaindex) | LlamaIndex | 通过中继 |
| [mcp-remote (any local client)](#mcp-remote-any-local-client) | Open source | 支持 |

## 助手和应用

### Claude (claude.ai, Claude Desktop)

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

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

```text tab="URL"
https://piqline.com/api/mcp
```
```text tab="Header"
Authorization: Bearer piq_live_…
```

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

来源：[support.claude.com](https://support.claude.com/en/articles/11175166)，读取于 2026 年 11 月 20 日（来自官方文档的配置块）。尚未在此用真实密钥测试。

### ChatGPT

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

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

```text
https://piqline.com/api/open/mcp
```

来源：[developers.openai.com](https://developers.openai.com/apps-sdk/build/auth)，读取于 2026 年 11 月 20 日（来自官方文档的配置块）。尚未在此用真实密钥测试。

### Mistral Le Chat

**位置：** 连接器 › 添加 MCP 连接器（管理员）

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

```text
https://piqline.com/api/mcp
```

来源：[docs.mistral.ai](https://docs.mistral.ai/le-chat/knowledge-integrations/connectors/mcp-connectors)，读取于 2026 年 11 月 20 日（依据官方文档组合而成）。尚未在此用真实密钥测试。

### Microsoft Copilot Studio

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

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

```text
https://piqline.com/api/mcp
```

来源：[learn.microsoft.com](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent)，读取于 2026 年 11 月 20 日（依据官方文档组合而成）。尚未在此用真实密钥测试。

## 编程智能体和编辑器

### Claude Code

**位置：** 终端

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

```bash tab="CLI"
claude mcp add --transport http piqline https://piqline.com/api/mcp \
  --header "Authorization: Bearer $PIQLINE_API_KEY"
```
```json tab=".mcp.json"
{
  "mcpServers": {
    "piqline": {
      "type": "http",
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer ${PIQLINE_API_KEY}" }
    }
  }
}
```

来源：[code.claude.com](https://code.claude.com/docs/en/mcp)，读取于 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](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)，读取于 2026 年 11 月 20 日（来自官方文档的配置块）。尚未在此用真实密钥测试。

### Gemini CLI

**位置：** 终端或 ~/.gemini/settings.json

一条命令，或 `settings.json` 中的配置块。`httpUrl` 键选择 HTTP 传输（`url` 表示旧版 SSE）。

```bash tab="CLI"
gemini mcp add --transport http \
  --header "Authorization: Bearer $PIQLINE_API_KEY" piqline https://piqline.com/api/mcp
```
```json tab="settings.json"
{
  "mcpServers": {
    "piqline": {
      "httpUrl": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer piq_live_…" }
    }
  }
}
```

来源：[geminicli.com](https://geminicli.com/docs/tools/mcp-server/)，读取于 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](https://cursor.com/docs/context/mcp)，读取于 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](https://code.visualstudio.com/docs/agents/reference/mcp-configuration)，读取于 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](https://zed.dev/docs/ai/mcp)，读取于 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](https://docs.cline.bot/mcp/configuring-mcp-servers)，读取于 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](https://roocodeinc.github.io/Roo-Code/features/mcp/using-mcp-in-roo)，读取于 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](https://docs.continue.dev/reference)，读取于 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](https://docs.devin.ai/desktop/cascade/mcp)，读取于 2026 年 11 月 20 日（请求头没有文档说明，建议使用中继）。尚未在此用真实密钥测试。

### JetBrains AI Assistant

**位置：** 设置 › 工具 › AI Assistant › Model Context Protocol

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

参见 [mcp-remote](#mcp-remote-any-local-client) 中继。

来源：[www.jetbrains.com](https://www.jetbrains.com/help/ai-assistant/mcp.html)，读取于 2026 年 11 月 20 日（请求头没有文档说明，建议使用中继）。尚未在此用真实密钥测试。

### Goose

**位置：** goose configure › Add extension › Remote

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

```text
https://piqline.com/api/mcp
```

来源：[goose-docs.ai](https://goose-docs.ai/docs/getting-started/using-extensions)，读取于 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](https://platform.claude.com/docs/en/agents-and-tools/mcp-connector)，读取于 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](https://developers.openai.com/api/reference/resources/responses/methods/create)，读取于 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](https://openai.github.io/openai-agents-python/mcp/)，读取于 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](https://ai-sdk.dev/docs/ai-sdk-core/mcp-tools)，读取于 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](https://github.com/langchain-ai/langchain-mcp-adapters)，读取于 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](https://adk.dev/tools-custom/mcp-tools/)，读取于 2026 年 11 月 20 日（依据官方文档组合而成）。尚未在此用真实密钥测试。

### n8n

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

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

```text
https://piqline.com/api/mcp
```

来源：[docs.n8n.io](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp/)，读取于 2026 年 11 月 20 日（依据官方文档组合而成）。尚未在此用真实密钥测试。

### CrewAI

**位置：** Python

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

参见 [mcp-remote](#mcp-remote-any-local-client) 中继。

来源：[docs.crewai.com](https://docs.crewai.com/en/mcp/streamable-http)，读取于 2026 年 11 月 20 日（请求头没有文档说明，建议使用中继）。尚未在此用真实密钥测试。

### LlamaIndex

**位置：** Python

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

参见 [mcp-remote](#mcp-remote-any-local-client) 中继。

来源：[developers.llamaindex.ai](https://developers.llamaindex.ai/python/framework/module_guides/mcp/llamaindex_mcp/)，读取于 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](https://github.com/geelen/mcp-remote)，读取于 2026 年 11 月 20 日（依据官方文档组合而成）。已于 2026-11-20 用真实密钥测试。
