你看到的情况
通过 MCP 连接到 Ceum 的外部工具——Claude Desktop、Cursor 或自定义客户端——无法验证。先前可运行的调用开始因权限错误而失败。
为什么会这样
最常见的原因:
- 令牌已被撤销。 有人(可能是稍早的你)在集成中撤销了该令牌。已撤销的令牌无法再次使用——需要创建新的令牌。
- 令牌从未被复制。 创建令牌时,其完整值仅显示一次。若关闭该对话框时未复制,该值便永久丢失且无法恢复。
- 外部工具使用了旧令牌。 你在 Ceum 中创建了新令牌,但外部工具仍配置为先前的令牌。
- 账户已被删除。 若创建令牌的人删除了自己的账户,其所有令牌也随之消失。令牌属于单个账户。
- 外部工具配置错误。 它指向错误的地址,或连接的设置方式不正确。
- 工具未获授权,或记录超出范围。 令牌仅具有你授予的工具,而带范围限制的令牌仅限于特定客户和/或项目。对未授予的工具,或对令牌范围外记录的调用,即使令牌本身有效也会被拒绝——请参阅集成与 MCP 以扩大其权限或范围。
- 带范围限制的令牌完全看不到任何内容。 范围要求记录同时符合客户与项目规则。若将客户限制为一组、将项目限制为另一组且两者不重叠,则没有记录能同时满足两者,因此一切读取结果皆为空白或“超出范围”。请将其中一个维度设回“全部”,或让两个允许列表有所重叠。
如何解决
- 打开集成并在列表中找到该令牌。若它不见了或被标记为已撤销,即表示不再有效——请创建新的令牌。
- 在关闭对话框前从对话框复制新令牌。该值之后无法取回。
- 用新令牌更新外部工具的配置并重新启动该工具。
- 在集成页面检查令牌的上次使用时间。在外部工具发出调用后,该时间应更新——若未更新,表示调用并未送达 Ceum。
- 交叉核对会话与 MCP 事件中过去一小时内是否有任何成功的调用,并与工具本身的错误日志比对,以找出连接在何处中断。
提示与特殊情况
- 令牌名称在撤销后仍会保留。 较旧的MCP 事件日志条目仍会显示已撤销令牌的名称;这是正常现象,并不代表该令牌仍可运行。
- 若怀疑泄露,应主动轮换。 先创建新令牌、切换工具、确认更改可成功送出,再撤销旧令牌。如此可避免出现两个令牌都无法运行的空窗期。
- 只读调用不会被记录。 即使MCP 事件日志中没有显示任何内容,令牌在读取上仍可能运行良好——因此空白的日志并不代表它已失效。
- 应用内的 CLI 是独立的。 Ceum 内的 CLI 命令面板使用你自己的登录,而非 MCP 令牌,因此绝不会因“令牌已撤销”之类的原因失败。
在移动设备上
移动应用不提供此功能——请在网页应用中管理。