指南
MCP 服务器
Piqline 的 MCP 服务器、它们的工具、ask_<agent> 工具和注解。
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 还要求所有者或管理员角色。
连接客户端#
每个客户端都有可直接复制的配置块,已对照其官方文档核对,见连接你的客户端:Claude、ChatGPT、Codex、Cursor、VS Code、Gemini CLI、Zed、Cline、Mistral Le Chat、Copilot Studio、n8n、LangChain、Vercel SDK,以及适用于任何本地客户端的中继。例如在 Claude Code 中:
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} 相同。
| 参数 | 作用 |
|---|---|
message | 用自然语言写的请求(必填)。 |
history | 与该智能体之前的交流,最早的在前:对象 { "role": "user" or "assistant", "text": "…" }。 |
响应包含智能体的文本。当智能体因提问或待确认的操作而停下时,响应会说明这一点,并指出要调用的工具。
注解#
每个工具都声明 readOnlyHint、destructiveHint 和 openWorldHint。客户端可以据此在写入、删除或实时读取类工具之前请求确认。
错误#
失败的工具会返回 isError: true 和一条可读的消息。发生在工具之前的拒绝(密钥、scope、限制)是 application/problem+json 格式的 HTTP 401、403 或 429 响应,详见错误。两种情况都会出现在设置 → API 和 MCP 的请求历史中。
账号登录#
ChatGPT 只接受 OAuth 登录或无认证:目前它连接的是开放入口 https://piqline.com/api/open/mcp。使用 Piqline 账号登录(OAuth)正在准备中;连接你的客户端页面上的其他所有客户端都接受密钥。