跳到正文

指南

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 中:

Shell
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)正在准备中;连接你的客户端页面上的其他所有客户端都接受密钥。

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