集成（外部工具）

Ceum 可以连接外部工具——如 Claude Desktop、Cursor 或你自己的代理程序——让它们代你读取与更新数据。每一个连接都使用一个你创建的 MCP 令牌。集成页面就是管理这些令牌并留意它们动向的地方。

此页面讲的是用令牌连接外部工具。Ceum 自带的应用内助理 Rocky 不需要令牌——你可在助理设置中启用它能做的事。

令牌管理

此页面会列出你已有的令牌，并包含：

名称——你的标签（例如“Claude Desktop”、“My Cursor setup”）。
令牌前缀——前几个字符，让你能区分不同令牌。
上次使用——令牌上次发出调用的时间。
创建时间——你创建它的时间。

操作：

创建令牌——选择名称，然后设置其权限与范围（见下文）；完整的令牌只会显示一次，以便你复制。之后无法再获取，因此请在关闭对话框前完成复制。
编辑——可随时重命名令牌或更改其权限与范围。令牌字符串本身永不改变。
撤销——关闭该令牌。已撤销的令牌无法再连接，但其过往活动会保留，以便你仍可查看。

此列表默认隐藏已撤销的令牌。切换即可连同各令牌的撤销时间一并显示它们。

权限与范围

创建或编辑令牌时，你同时决定它能做什么以及它能对什么做这件事。只授予工具所需的最少权限，能避免外泄或行为异常的令牌触及你工作区的其余部分。

工具权限

权限是一份按领域分组（任务、项目、客户、文档等）的单个工具白名单。新令牌一开始会授予所有权限；取消勾选工具不需要的部分即可。

全部读取 / 全部写入——顶部的两个开关会一次翻转所有领域中的每个只读工具，或每个会更改数据的工具。
读取 / 写入（按领域）——相同的划分，但仅限于单个领域。
单个工具始终可逐一勾选。

令牌只能调用你授予它的工具；其他一律拒绝。

资源范围

范围将令牌限定于特定的客户和／或项目。令牌默认拥有完全访问——它可对所有内容执行操作，包括没有客户或项目的条目（例如未指派的任务）。关闭完全访问以加以限制，便会出现两个独立的维度：

客户——设为所有客户（不受限），或设为特定客户的严格白名单。
项目——设为所有项目，或设为特定项目的严格白名单。

两者皆为严格白名单：一旦某维度设为“特定”，便只有你加入的内容可访问。记录必须同时满足两个维度才算在范围内——因此它必须隶属于一个被允许的客户且一个被允许的项目（维持为“所有”的维度则不检查）。

留意重叠。 由于两个维度都必须匹配，将互不重叠的某客户与某项目加入白名单，意味着完全没有记录匹配——令牌看不到任何东西。若你只想按项目限定范围，请将客户维持为“所有”（反之亦然）。在受限维度上缺少关联的记录（项目受限时没有项目的任务）同样不在范围内。

范围外的任何内容皆不可见且不可访问：列表只返回范围内的记录，而以 ID 对范围外记录执行操作会返回“超出范围”错误。受限令牌只有在其项目维度为“所有”时才能创建新项目，只有在其客户维度为“所有”时才能创建新客户。

范围在记录关联到客户或项目的每个地方都会强制执行：客户、项目、任务、文档、交易、时间记录、任务评论（通过其父任务）、关系（两个端点），以及工作区搜索与日历动态（只返回范围内项目）。它也涵盖关联本身——将任务加入项目、将项目加入客户，或将时间记录加入任务，都要求记录与其所关联的对象皆在范围内。没有客户／项目关联的内容——日历事件、订阅，以及状态、任务类型与标签等工作区级别的设置——无论范围如何皆保持可用。

连接外部工具

此页面会显示常见工具可直接粘贴的配置片段，包括 Claude Desktop 和 Cursor。复制你工具对应的片段，填入你的令牌，工具便会连接至 Ceum。

查看 MCP 事件

你可以查看通过连接的工具所做的每一项更改——请参阅会话与 MCP 事件。它会记录所执行的操作、由哪个令牌执行、受影响的记录，以及时间，让你能精确审计你的工具更改了什么。

工作流程

连接 Claude Desktop

从集成页面创建令牌，并命名为类似“Claude Desktop”的名称。
趁令牌显示时复制完整令牌——这是你唯一的机会。
将配置片段粘贴进 Claude Desktop 的配置中并填入你的令牌。
重新启动 Claude Desktop。令牌的 上次使用 会在它首次调用后更新。

审计可疑的更改

打开MCP 事件页面并缩小至更改发生的日期范围。找出造成该更改的操作，再与记录自身的历史交叉比对（请参阅实体变更日志）以查看完整的更改前后。

轮换令牌

先创建新令牌，将你的工具切换过去，并确认它能正常工作。然后撤销旧的那个。对任何你认为可能已外泄的令牌都加以撤销。

提示与特殊情况

令牌无法再次显示。 若你丢失令牌，请创建新的。
过往活动在撤销后保留。 撤销令牌不会抹除它做过的事——其先前的操作仍会以其旧名称出现。
MCP 事件会保留至你的账号存在为止。
任务状态与类型可通过 MCP 限定项目范围。 创建／更新任务状态与任务类型的工具接受 allProjects 与 scopedProjectIds，而 list_task_statuses 会返回它们——因此连接的工具既能设置也能读取按项目范围。将状态或类型指派给超出其项目范围的任务会被拒绝，并附上指明违规项目的消息。

在移动设备上

移动应用无法使用——请从网页应用进行管理。