# MCP 服务器

> Piqline 的 MCP 服务器、它们的工具、ask_<agent> 工具和注解。

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

MCP 服务器提供与 API 相同的工具，并为每个智能体额外提供一个工具。它使用无会话的“Streamable HTTP”传输：每个请求相互独立。密钥的发送方式与 API 相同，放在 `Authorization` 请求头中。

## 服务器

| 服务器 | URL | 内容 |
| --- | --- | --- |
| 全部工具 | `https://piqline.com/api/mcp` | 密钥可调用的所有工具，以及每个智能体的 `ask_<agent>` |
| 单个智能体 | `https://piqline.com/api/mcp/{agent}` | 该智能体的工具，以及它的 `ask_<agent>` |

`{agent}` 为 `piqline`、`requete`、`facebook`、`linkedin`、`upwork` 或 `onboarding`。单智能体服务器适合限制工具数量的客户端。

`tools/list` 只显示密钥可以调用的工具：缺少某个工具，说明它需要密钥没有的 scope。`ask_<agent>` 工具需要 `agents` scope，`ask_onboarding` 还要求所有者或管理员角色。

## 连接客户端

每个客户端都有可直接复制的配置块，已对照其官方文档核对，见[连接你的客户端](/zh/docs/api/clients)：Claude、ChatGPT、Codex、Cursor、VS Code、Gemini CLI、Zed、Cline、Mistral Le Chat、Copilot Studio、n8n、LangChain、Vercel SDK，以及适用于任何本地客户端的中继。例如在 Claude Code 中：

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

## ask_<agent> 工具

`ask_piqline`、`ask_requete`、`ask_facebook`、`ask_linkedin`、`ask_upwork` 和 `ask_onboarding` 把整个请求交给对应的智能体，与 [`POST /api/v1/agents/{agent}`](/zh/docs/api/agents) 相同。

| 参数 | 作用 |
| --- | --- |
| `message` | 用自然语言写的请求（必填）。 |
| `history` | 与该智能体之前的交流，最早的在前：对象 `{ "role": "user" or "assistant", "text": "…" }`。 |

响应包含智能体的文本。当智能体因提问或待确认的操作而停下时，响应会说明这一点，并指出要调用的工具。

## 注解

每个工具都声明 `readOnlyHint`、`destructiveHint` 和 `openWorldHint`。客户端可以据此在写入、删除或实时读取类工具之前请求确认。

## 错误

失败的工具会返回 `isError: true` 和一条可读的消息。发生在工具之前的拒绝（密钥、scope、限制）是 `application/problem+json` 格式的 HTTP `401`、`403` 或 `429` 响应，详见[错误](/zh/docs/api/errors)。两种情况都会出现在设置 → API 和 MCP 的请求历史中。

## 账号登录

ChatGPT 只接受 OAuth 登录或无认证：目前它连接的是开放入口 `https://piqline.com/api/open/mcp`。使用 Piqline 账号登录（OAuth）正在准备中；[连接你的客户端](/zh/docs/api/clients)页面上的其他所有客户端都接受密钥。
