认证配置
idcd MCP Server 使用 MCP 令牌(前缀 idcd_mcp_)认证,令牌在控制台创建。
普通 API Key(sk_live_)不被 MCP Server 接受 —— 只有 idcd_mcp_ 令牌
(以及作为兜底的 idcd_pat_ 个人访问令牌)才能通过 MCP 认证。
令牌类型
| 类型 | 有效期 | 适用场景 |
|---|---|---|
| Personal | 24 小时 | 个人开发调试 |
| Workspace | 90 天 | 团队共享 |
| Service | 90 天(自动续期) | 生产 / CI-CD 集成 |
注意:所有令牌最长 90 天,无永久令牌(D21 决策)。
创建 MCP 令牌
- 登录 idcd 控制台
- 进入「设置 → MCP 令牌」
- 点击「创建令牌」,选择类型(Service 令牌还需填写 IP 白名单)
- 复制令牌(明文只显示一次)
使用方式
Authorization 请求头
MCP Server 从标准 bearer 头读取令牌:
Authorization: Bearer idcd_mcp_xxxxxxxx
环境变量(推荐)
export IDCD_MCP_TOKEN=idcd_mcp_xxxxxxxx
命令行参数
mcp --token idcd_mcp_xxxxxxxx
权限范围
MCP 令牌可访问 idcd MCP 拨测工具,用量计入套餐统一配额。撤销令牌后立即生效。