接入指南

获取 API Key

MCP API Key 用于调用 /sokoo/mcp 协议入口。

前往 API Key 管理

创建密钥

01

进入账户页

登录后进入 /account/apikey,打开 MCP API Key 管理页。

02

填写密钥名称

建议按应用或环境命名,例如生产环境、测试环境、BI 同步。

03

复制并保存完整 Key

创建成功后立即复制完整 Key,并保存到服务端环境变量或密钥管理系统。

完整 Key 只展示一次

创建成功后页面会展示完整 pd_mcp_ 开头密钥。关闭弹窗后,列表只展示 key_prefix 和掩码,无法再次查看完整 Key。

管理密钥

数量限制

每个账户最多保留 10 个 active MCP API Key。

最新使用日期

列表会展示 Key 最近使用时间,便于识别长期未使用密钥。

删除即吊销

页面上的删除操作对应后端 revoke,吊销后调用会失败。

安全建议

  • 按应用和环境拆分 Key,不要多人共用一个生产 Key。
  • 不要把 Key 写入前端代码、Git 仓库、日志或截图。
  • 轮换时先创建新 Key,更新调用方后再吊销旧 Key。
  • 发现泄露风险时立即吊销对应 Key。