跳转到正文
客户端接入

HTTP

通过 Streamable HTTP 发送 JSON-RPC 请求。

在快速接入页配置此客户端

开始前

准备 curl 和 DINQ API Key。先初始化连接,再发送初始化确认,最后调用 capabilities;不要跳过协议握手。

认证方式与密钥使用说明见认证与 API Key。修改已有配置时只合并 peoplerouter 条目,不要覆盖其他设置。

配置连接

开发者设置 · API Key(可选)

Key 保存在当前浏览器,只有勾选上方选项后才会写入复制的配置示例。

Terminal
# 1. initialize — read Mcp-Session-Id from the response headers
curl -si https://mcp.peoplerouter.ai \
  -H "Authorization: Bearer <DINQ_API_KEY>" \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

# 2. copy the returned session id and negotiated protocolVersion below
SESSION='<Mcp-Session-Id>'
PROTOCOL='2025-06-18'
# acknowledge
curl -s https://mcp.peoplerouter.ai \
  -H "Authorization: Bearer <DINQ_API_KEY>" -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H "Mcp-Session-Id: $SESSION" -H "MCP-Protocol-Version: $PROTOCOL" -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

# 3. call a tool
curl -s https://mcp.peoplerouter.ai \
  -H "Authorization: Bearer <DINQ_API_KEY>" -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H "Mcp-Session-Id: $SESSION" -H "MCP-Protocol-Version: $PROTOCOL" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"capabilities","arguments":{}}}'
或直接发给你的 Agent

复制下方指令发给 Agent,协助你完成接入。

粘贴给 Agent
请帮我在 HTTP 中接入 PeopleRouter,先检查实际版本,参考以下配置:

# 1. initialize — read Mcp-Session-Id from the response headers
curl -si https://mcp.peoplerouter.ai \
  -H "Authorization: Bearer <DINQ_API_KEY>" \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

# 2. copy the returned session id and negotiated protocolVersion below
SESSION='<Mcp-Session-Id>'
PROTOCOL='2025-06-18'
# acknowledge
curl -s https://mcp.peoplerouter.ai \
  -H "Authorization: Bearer <DINQ_API_KEY>" -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H "Mcp-Session-Id: $SESSION" -H "MCP-Protocol-Version: $PROTOCOL" -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

# 3. call a tool
curl -s https://mcp.peoplerouter.ai \
  -H "Authorization: Bearer <DINQ_API_KEY>" -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H "Mcp-Session-Id: $SESSION" -H "MCP-Protocol-Version: $PROTOCOL" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"capabilities","arguments":{}}}'



需要 API Key 时,指导我在本地配置,不要让我把 Key 发到聊天中。 若配置或授权操作受到沙箱的文件、网络或浏览器回调限制,通过当前 Agent 的权限机制申请所需权限;支持沙箱外执行时,获准后再执行对应操作。浏览器授权由我完成。 不要在同一受限环境里反复重试,也不要自行关闭沙箱或绕过审批。若当前环境不支持申请权限,给出需要我在本机终端或应用界面执行的具体步骤。 修改已有配置前先备份,仅合并 peoplerouter 条目,保留其他服务器和设置。若已有同名配置,先检查,不要重复添加。网页应用需要用户在界面添加连接器;无法直接操作时给出步骤。工具加载且 capabilities 调用成功后才确认接入完成;失败时说明实际错误。

此示例需要 API Key。请在控制台创建,并在开发者设置中启用。 认证与 API Key

官方配置文档

检查连接

SDK / HTTP 示例以 capabilities 返回能力清单作为连接检查。API 示例可能继续执行人物搜索,运行前先检查输入和工具价格;不要只凭 HTTP 成功状态判断调用结果。

连接成功后继续阅读使用工具。认证或调用失败时,参考常见问题,并检查客户端返回的具体错误。