GUIDE · PLATFORM KEY
获取平台 API Key
适用场景：WorkBuddy 连接器、Claude Code / Cursor / Cline 等 MCP 客户端，以及任何需要 Authorization: Bearer <platform key> 的 Agent 集成。
1. 控制台签发（推荐）
- 登录平台控制台。
- 进入 「MCP 接入」页（平台级）。
- 点击 签发 Key，填写用途标签（如
workbuddy）。 - 明文只在签发弹窗展示一次——请立即复制保存；列表仅保留摘要指纹，无法再次查看明文。
2. 使用
任意 MCP 客户端 / REST 调用，请求头携带：
Authorization: Bearer <platform key>平台 MCP 端点（Streamable HTTP，MCP 2025-06-18）：
POST https://adep.top/api/v1/mcp3. 最小权限（作用域 Key）
签发时可指定作用域：工具白名单 + 项目白名单（空 = 全权限）。
scopes.tools：允许调用的平台工具名（如["project.list","function.list"]）；scopes.projects：允许操作的项目 id 白名单。
把受限 Key 交给第三方 Agent（如 WorkBuddy）可以显著降低凭证风险：越界调用会返回 TOOL_SCOPE_DENIED / AUTH_FORBIDDEN，不会影响白名单外资源。
4. 吊销
- 在「MCP 接入」页点击吊销：立即生效，无需等待缓存过期。
- 吊销后持该 Key 的请求一律返回 401
MCP_UNAUTHORIZED。
密钥纪律
- 明文令牌只在签发响应返回一次；服务端只存 SHA-256 摘要。
- 不要在任何聊天、文档、公开仓库里粘贴明文 Key。
- 疑似泄露：立即吊销并重新签发。