Agent 接入

当前能力

工具	作用	限制
cpcp_put_text	寄一个文字包裹，返回 6 位取件码、链接和过期时间	文字最多 64KB；每个 token 每天 200 次
cpcp_put_file	寄一个文件，返回 6 位取件码、链接和下载入口	文件最多 5MB；每个 token 每天 200 次寄件（与文字共用）
cpcp_get	按取件码取回文字，或取得文件元数据与签名下载链接	每个 token 每小时 20 次

连接方式

端点是本站的 /mcp，使用 JSON-RPC 2.0 over Streamable HTTP，协议版本 2025-06-18。服务不保存会话，不需要 mcp-session-id。

每个请求都要带 Authorization: Bearer cpcp_...。token 在 /zh/keys 自助生成，只显示一次；不需要注册账号。

POST /mcp（使用本站域名）
Content-Type: application/json
Authorization: Bearer cpcp_...
支持 initialize、ping、tools/list、tools/call；不支持 resources、prompts 和订阅

官方 MCP Registry

cpcp 已收录到官方 MCP Registry：io.github.builderbasetech-lgtm/cpcp（0.1.0）。支持 Registry 发现的客户端可以直接按名称找到；手工配置仍以下面的客户端命令为准。

在 MCP Registry 中查看 cpcp

Claude Code

先到 /zh/keys 生成 token，然后在终端执行下面的命令。Claude Code 会把远端 MCP 服务写进它自己的配置。

用 claude mcp list 确认 cpcp 已连接。
如果 token 里带特殊字符，先用 shell 变量再传入，避免历史记录泄露。

claude mcp add --transport http cpcp https://cp.1tools.vip/mcp --header "Authorization: Bearer cpcp_..."

Codex

Codex 支持 streamable HTTP MCP。把 token 放进环境变量，不要直接写进 config.toml。

用 codex mcp list 确认配置；codex mcp get cpcp 查看详情。

添加服务器

codex mcp add cpcp --url https://cp.1tools.vip/mcp --bearer-token-env-var CPCP_TOKEN

启动前设置 token

export CPCP_TOKEN=cpcp_...

Cursor

在 Cursor 的 MCP 配置里加入下面的 JSON。项目级配置放在 .cursor/mcp.json，全局配置放在 ~/.cursor/mcp.json。

保存后在 Cursor 的 MCP 面板里确认 cpcp 的三个工具都出现。
不要把这个文件提交到仓库；token 泄露后立即到 /zh/keys 吊销。

.cursor/mcp.json

{
  "mcpServers": {
    "cpcp": {
      "url": "https://cp.1tools.vip/mcp",
      "headers": {
        "Authorization": "Bearer cpcp_..."
      }
    }
  }
}

验证连接

没有客户端时，可以直接用 curl 验证端点和 token。

curl -sS https://cp.1tools.vip/mcp \
  -H "Authorization: Bearer cpcp_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

调用示例

列出工具：{"jsonrpc":"2.0","id":1,"method":"tools/list"}

寄文字：{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"cpcp_put_text","arguments":{"content":"hello"}}}

寄文件：{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"cpcp_put_file","arguments":{"name":"note.txt","contentBase64":"aGVsbG8="}}}

取包裹：{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"cpcp_get","arguments":{"code":"123456"}}}

边界与安全

包裹 1 小时后失效，存储随后最多 10 分钟内清理；最多成功取件 10 次。
文字会在服务器短暂存放，不是端到端加密；不要通过 MCP 发送密码、密钥或证件。
token 是凭证，放在客户端密钥库里，不要写进仓库、日志或提示词。
token 自创建起 90 天后失效；怀疑泄露时到 /zh/keys 粘贴吊销，再生成新的。
MCP 文件用 base64 内联传输，只适合小文件；不要用它发送敏感文件。