MCP 服务器参考

推荐的智能体接口。 云端 MCP 是长期记忆、上下文、知识库、文件和工作区治理的默认路径。独立 CLI 用于高级本机 Runtime 工作流：按需开启的自动会话、定向任务、流式沟通和诊断。

能力范围

云端 MCP 提供长期记忆、知识库选择、工作区治理、证据文件和账户状态。每次请求都会将凭据解析为稳定的 agt_... 审计身份。任务、自动会话、智能体沟通、端点健康和自动记忆设置由已连接的 TokST Runtime 与后台处理。

TokST MCP（Model Context Protocol）服务器让 AI 智能体直接与你的记忆系统交互。Claude Code、Codex、Pi、WorkBuddy、ZCode、Qoder、Kimi 及其他 MCP 客户端都可以通过自然语言存储、搜索和管理记忆。

决策、架构、会议纪要和任务建议在 content 中使用结构化 Markdown。标题、列表、任务清单、链接、表格和代码块可以提升审核效率。短事实可使用纯文本；密钥、私钥、原始推理和临时工具输出保留在记忆之外。

连接方式

方式	传输协议	适用场景
远程（Streamable HTTP，32 个工具）	`https://api.tokst.com/mcp`	ChatGPT、Web 智能体、记忆与工作区工作流

远程配置（适用于 ChatGPT 和远程智能体）

公开 MCP 清单位于 https://api.tokst.com/.well-known/mcp，其中声明了 Streamable HTTP 入口、OAuth 元数据和静态客户端的 API 密钥接入方式。

远端 MCP 客户端使用以下端点。首次连接时，客户端会打开 TokST 的登录与确认页面。TokST 使用 OAuth 2.1 授权码流程与 PKCE，并为已确认客户端建立稳定的可信智能体身份。

{
  "mcpServers": {
    "tokst": {
      "type": "streamable-http",
      "url": "https://api.tokst.com/mcp"
    }
  }
}

远程端点采用无状态 Streamable HTTP：每次请求均携带认证信息，可由任意健康实例处理。它返回 JSON 工具响应，无需维护持久 MCP 会话 ID。

授权服务器在 /.well-known/oauth-protected-resource/mcp 和 /.well-known/oauth-authorization-server 提供 OAuth 元数据。支持动态客户端注册的客户端可自动注册。

客户端未携带凭证访问 /mcp 时，TokST 返回包含 WWW-Authenticate: Bearer、mcp 作用域和受保护资源元数据地址的 401 Unauthorized。支持 MCP OAuth 的客户端会据此打开浏览器授权，不会将端点判定为不可达。

API 密钥远程配置

WorkBuddy、ZCode、Qoder、Kimi、CI 及其他使用静态 MCP 配置的客户端可通过专用 API 密钥连接。在仪表盘 API 密钥创建密钥后，填写以下配置：

{
  "mcpServers": {
    "tokst": {
      "type": "streamable-http",
      "url": "https://api.tokst.com/mcp",
      "headers": {
        "Authorization": "Bearer tk_live_your_api_key"
      }
    }
  }
}

每个客户端使用独立密钥。密钥保存在客户端的私有环境变量中，避免写入源代码和版本控制；停止使用后可直接撤销。

工具参考

TokST 云端 MCP 默认提供管理、团队和附件工具，并保持完整的 32 个工具面。

工作区治理工具

这些工具与后台使用相同的角色检查。接受或拒绝邀请、撤销邀请、退出、调整角色、移除成员、转让 Owner 均需要 confirm: true。

工具	用途
`tokst_workspace_members`	列出成员与角色
`tokst_workspace_invitations`	列出工作区已发邀请
`tokst_workspace_invite`	按角色和有效期发出一个或多个邀请
`tokst_workspace_invitation_inbox`	列出当前用户的邀请
`tokst_workspace_invitation_respond`	接受或拒绝邀请
`tokst_workspace_invitation_revoke`	撤销待处理邀请
`tokst_workspace_leave`	退出工作区
`tokst_workspace_member_role`	设置成员为 `admin` 或 `member`
`tokst_workspace_member_remove`	移除成员
`tokst_workspace_owner_transfer`	将 Owner 转让给已有成员

记忆操作

`tokst_remember`

存储新记忆，支持自动路由和向量嵌入生成。同一工作区、知识库和类型中的完全相同有效记录会返回已有 ID，并标记 duplicate: true 与 duplicateOf。已确认的长期知识使用 Markdown 保存；凭据、私钥、原始推理和临时执行输出保留在记忆之外。

参数	类型	必填	说明
`content`	string	是	记忆内容
`type`	string	否	`fact`、`decision`、`preference`、`task`、`architecture`、`note`（默认 `note`）
`tags`	string	否	逗号分隔的标签
`source`	string	否	来源名称（默认 `mcp`）
`evidence`	string	否	证据 URL 或来源文件路径
`confidence`	number	否	`0` 到 `1` 的可信度
`validUntil`	string	否	ISO 到期时间
`atlasId`	string	否	目标知识库（省略时按关键词自动路由）
`title`	string	否	可选标题

`tokst_search`

与用户后台和 REST 兼容接口共享编排逻辑的自适应作用域搜索。

参数	类型	必填	说明
`query`	string	是	搜索查询，至少两个字符
`type`	string	否	按类型筛选
`tags`	string	否	逗号分隔的标签筛选
`atlasId`	string	否	限定知识库
`mode`	string	否	`auto`、`keyword`、`semantic` 或 `hybrid`（默认 `auto`）
`limit`	number	否	最大结果数（默认 20）

工具结果包含与 REST 一致的结果顺序和 meta 耗时/缓存字段。

`tokst_context`

获取按记忆类型分组的结构化上下文快照。

参数	类型	必填	说明
`atlasId`	string	否	知识库 ID（省略返回全部）
`limit`	number	否	每类最大条数（默认 10）

`tokst_memory_list`

使用稳定游标分页列出可访问记忆。持续传入 nextCursor，直到 hasMore 为 false。

参数	类型	必填	说明
`type`	string	否	按类型筛选
`atlasId`	string	否	限定知识库
`limit`	number	否	最大结果数（默认 20）
`cursor`	string	否	上一页返回的不透明游标
`status`	string	否	`active`、`archived` 或 `all`（默认 `active`）
`includeTotal`	boolean	否	返回当前快照下的精确总数

结果包含 count、hasMore、snapshotAt，有下一页时还会返回 nextCursor。未知参数会被拒绝。

`tokst_memory_get`

获取单条记忆的完整详情和附件。

参数	类型	必填	说明
`id`	string	是	记忆 ID

`tokst_memory_update`

更新记忆的一个或多个字段。更新正文时会刷新检索向量；响应会返回已保存的标题、标签、正文长度与向量状态。

参数	类型	必填	说明
`id`	string	是	记忆 ID
`title`	string	否	替换后的标题
`content`	string	否	替换后的 Markdown 正文
`tags`	string[]	否	替换后的标签列表

title、content、tags 至少提供一项。

`tokst_memory_append`

向已有记忆追加内容。前后空行会归一为一个 \n\n 分隔符；已验证记忆被更新或追加后会回到 needs_review。

参数	类型	必填	说明
`id`	string	是	记忆 ID
`content`	string	是	追加内容

`tokst_memory_verify`

使用证据、可信度和可选有效期验证一条记忆。

参数	类型	必填	说明
`id`	string	是	要验证的记忆 ID
`evidence`	string	否	证据 URL 或来源文件路径
`confidence`	number	否	`0` 到 `1` 的可信度
`validUntil`	string	否	ISO 到期时间

`tokst_memory_supersede`

将旧记忆标记为由同一知识库中的新记忆替代。

参数	类型	必填	说明
`id`	string	是	被替代的记忆
`replacementMemoryId`	string	是	新的替代记忆

`tokst_memory_archive`

归档记忆（软删除，可恢复）。

参数	类型	必填	说明
`id`	string	是	记忆 ID

`tokst_memory_restore`

恢复归档的记忆为活跃状态。

参数	类型	必填	说明
`id`	string	是	记忆 ID

`tokst_attach_file`

为已有记忆附加一个 ChatGPT 上传文件或远程 URL。远程服务器下载文件并上传到 R2。

参数	类型	必填	说明
`memoryId`	string	是	记忆 ID
`files`	array	否	ChatGPT 提供的文件（`openai/fileParams`）
`fileUrl`	string	否	通用 MCP 客户端使用的可下载 URL
`filename`	string	否	自定义文件名

files 与 fileUrl 任选一个。fileUrl 必须是可公开下载的 HTTPS 地址，且不能解析到私有网络。远程 MCP 单文件上限为 100 MB。来源下载、上传授权、对象上传与上传确认失败时，响应会返回对应阶段和处理建议。

`tokst_download_file`

获取一条记忆中单个或全部附件的安全下载链接。链接有效期为 15 分钟，同时以 MCP resource_link 返回。

参数	类型	必填	说明
`memoryId`	string	是	记忆 ID
`attachmentId`	string	否	指定附件；省略时返回全部附件

知识库操作

`tokst_atlas_list`

列出所有知识库。无需参数。

`tokst_atlas_init`

创建新知识库。

参数	类型	必填	说明
`name`	string	是	知识库名称
`workspaceId`	string	否	工作区（省略使用默认）
`keywords`	string	否	逗号分隔的自动路由关键词

`tokst_atlas_rename`

重命名知识库。

参数	类型	必填	说明
`atlasId`	string	是	知识库 ID
`name`	string	是	新名称

`tokst_atlas_profile`

设置知识库的自动路由关键词。

参数	类型	必填	说明
`atlasId`	string	是	知识库 ID
`keywords`	string	是	逗号分隔的关键词

`tokst_atlas_archive`

归档知识库。记忆和附件保留在后台已归档视图中，可恢复和手工清除。

参数	类型	必填	说明
`atlasId`	string	是	要归档的知识库 ID
`confirm`	boolean	是	必须为 `true`，确认归档

工作区操作

`tokst_workspace_list`

列出所有工作区。无需参数。

`tokst_workspace_create`

创建新工作区。

云端团队工作区创建会消耗账户的可用团队工作区配额。TokST 本地模式已退役；长期记忆与协作通过云端 MCP 提供。

参数	类型	必填	说明
`name`	string	是	工作区名称

`tokst_workspace_archive`

归档工作区。资源保留在后台已归档视图中，可恢复和手工清除。

参数	类型	必填	说明
`workspaceId`	string	是	要归档的工作区 ID
`confirm`	boolean	是	必须为 `true`，确认归档

账户

`tokst_status`

获取账户概览：计划、用量、存储、工作区/知识库数量。无需参数。

认证

远程：Authorization: Bearer tk_live_xxx 请求头中的 API Key
CLI Runtime：tokst login --key <key> 将云端凭据保存至 ~/.tokst/config.json，供已连接端点、会话、任务和诊断工作流使用。

已连接 Runtime

安装 TokST CLI 后可连接已支持的智能体。Runtime 通过已认证的 WSS 投递明确任务、智能体沟通、按需启用的会话采集、端点健康和执行结果。相关工作流在用户后台管理；MCP 专注于读取和保存长期知识。