DEVELOPERS

把 cpcp 接入你的工作流

cpcp 提供三种稳定的接入方式：给 Agent 用的 MCP、给终端用的 CLI，以及可直接编排的 REST API。它们共用同一条寄取链路和同一套限额。

快速开始

先选一条最短路径。CLI 适合脚本和终端；MCP 适合 Claude Code、Codex、Cursor 这类客户端。

CLI

安装官网分发的 tarball，然后直接寄一个文件。

安装

npm install -g https://cp.1tools.vip/downloads/cpcp-cli-0.1.0.tgz

寄件

cpcp upload ./report.pdf

查看 CLI 文档

MCP

把远端 MCP 端点加到客户端配置，token 只放在密钥库或环境变量里。

.cursor/mcp.json

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

查看 MCP 接入

四种接入面

从最小的 Agent 调用到完整的 HTTP 编排，按需要选择，不要重复实现同一件事。

适合 Agent / 客户端

MCP

无状态 JSON-RPC 端点，提供 cpcp_put_text、cpcp_put_file 和 cpcp_get。

MCP 接入

适合脚本 / CI

CLI

在终端和 CI 里寄取文件，输出取件码和可分享链接。

CLI 文档

适合服务端编排

REST API

直接控制 init、upload、seal 和 pickup，适合自定义集成。

API 参考

适合所有 MCP 客户端

API keys

自助创建和吊销 MCP token；不显示第二次，90 天后自动失效。

管理 key

客户端配置

三种常见客户端的命令放在这里；每个页面都有完整的验证和排错步骤。

Claude Code

用一条命令把远端 MCP 服务写进 Claude Code 配置。

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

Claude Code 步骤

Codex

从环境变量读取 token，不把凭证写进 config.toml。

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

Codex 步骤

Cursor

项目级或全局 mcp.json，保存后在 MCP 面板确认工具出现。

~/.cursor/mcp.json

Cursor 步骤

限额与边界

文字: 64KB / 包裹
单个文件: 100MB（MCP 5MB）
包裹总量: 20 个文件 / 200MB
取件次数: 最多 10 次
包裹保留: 1 小时
token 有效期: 90 天

安全边界

cpcp 不是端到端加密。内容会在服务端短暂存放，并在 1 小时后失效。
取件码就是凭证。拿到或猜到码的人可以取走内容。
token 只放在客户端密钥库或环境变量里，不要写进仓库、日志或提示词。
怀疑泄露时，先到 API keys 页面吊销，再生成新的 token。

从一条命令开始

先生成一个 token，或者直接读 MCP 接入。两条路径都不需要注册账号。

创建 API key 阅读 MCP 接入