智能体接入
通过 TokST Cloud MCP 为智能体连接长期记忆、共享上下文和知识治理。Cloud MCP 是记忆的标准入口。可选 CLI Runtime 连接设备和智能体 Binding,并提供会话、明确任务、沟通与诊断。
连接云端 MCP
在支持 OAuth 的 MCP 客户端中配置公开端点:
{
"mcpServers": {
"tokst": {
"type": "streamable-http",
"url": "https://api.tokst.com/mcp"
}
}
}
客户端会打开 TokST 浏览器授权页。授权完成后,智能体即可使用完整的云端 MCP 工具集处理记忆、上下文、知识库、工作区治理、附件和账户状态。
静态 MCP 配置的客户端可使用专用 API Key。请在用户后台 API Key创建密钥,将其保存到客户端受保护的配置中,并在客户端停止使用后撤销。
{
"mcpServers": {
"tokst": {
"type": "streamable-http",
"url": "https://api.tokst.com/mcp",
"headers": {
"Authorization": "Bearer tk_live_your_api_key"
}
}
}
}
添加 TokST Skill
将下面内容发送给支持 Skill 的智能体:
阅读 https://tokst.com/skill.md。连接 TokST 云端 MCP:
https://api.tokst.com/mcp,完成授权。在重要工作前检索相关上下文,
仅保存已确认的长期有效信息。
Skill 定义长期知识的检索、写入、更新和归档规则。它仅面向 MCP,不管理 Runtime 会话、任务或沟通。
高级功能:连接本机智能体端点
当本机需要运行已创建智能体绑定、参与沟通、采集受支持会话或执行后台分派任务时,使用可选设备工具:
tokst start
tokst auto on --agent all
tokst status
tokst doctor
start 连接 Runtime 设备并登记可用适配器。auto on 明确安装并启用自动记忆桥接。status 展示设备、绑定、模型、WSS、队列、任务与沟通健康状态。doctor 给出连接与配置问题及修复操作。
验证连接
- 打开 MCP 客户端,确认可以看到 TokST 工具。
- 让智能体在重要工作前检索已有上下文。
- 让它通过 TokST MCP 保存一条已确认的长期事实或决策。
- 打开记忆确认结果。
工具详情请查看云端 MCP,智能体行为请查看Skill 指南,设备操作请查看CLI 参考。
排查
| 情况 | 处理方式 |
|---|---|
| 客户端显示授权请求 | 完成浏览器授权,再重新连接 MCP 客户端。 |
| 客户端仅支持静态配置 | 创建专用 API Key,并作为 Bearer token 配置。 |
tokst: command not found | 安装独立 CLI 以连接本机端点,再打开新终端。 |
| MCP 工具未出现 | 确认 URL 为 https://api.tokst.com/mcp,并查看客户端 MCP 日志。 |
| 本机端点不可用 | 运行 tokst doctor,处理提示后运行 tokst auto on --agent <name>。 |