快速开始
TokST 通过 Cloud MCP 为智能体提供长期知识。最短设置只需三步。独立 CLI Runtime 是可选能力，仅用于连接设备、智能体执行、自动会话、任务和沟通。
1. 连接 Cloud MCP
将公共 Streamable HTTP 端点加入 MCP 客户端：
{
"mcpServers": {
"tokst": {
"type": "streamable-http",
"url": "https://api.tokst.com/mcp"
}
}
}
无法使用浏览器 OAuth 的静态客户端，可以在仪表盘 API 密钥创建专用密钥，并作为 Bearer Token 发送。每把密钥应保存在客户端受保护的凭据存储中。
2. 完成授权
打开 MCP 客户端显示的授权页面，登录 TokST 并批准访问。授权完成后重新连接客户端。智能体随后会获得完整的 Cloud MCP 工具，用于记忆、检索、上下文、知识库、工作区和文件。
客户端无法打开浏览器授权时，使用 MCP 参考中的 API 密钥配置。
3. 使用记忆
让智能体以 Markdown 保存已确认的知识：
将以下已确认的决策作为 TokST 决策记忆保存，并使用 Markdown：
# 生产发布审批
- 生产发布需要工作区所有者批准。
- 此规则适用于全部生产部署。
智能体会调用 tokst_remember。它可以使用 tokst_search 回答具体历史问题，使用 tokst_context 获取分组知识快照，已知 ID 时使用 tokst_memory_get。
长期记忆适合保存已确认的事实、决策、偏好、规则、架构和可复用笔记。凭据、私钥、原始推理、完整日志和临时工具输出应保留在长期记忆之外。
智能体 Skill
支持 Skill 的智能体可以读取仅面向 MCP 的操作指南：
请阅读 https://tokst.com/skill.md，并使用 https://api.tokst.com/mcp 的 TokST Cloud MCP 管理长期 Markdown 记忆、检索、上下文和知识治理。
Skill 会让检索保持必要、写入保持完整、生命周期变更保持可追溯。使用 Skill 无需安装 CLI。
产品对象
| 对象 | 用途 | 创建条件 |
|---|---|---|
| 记忆 | 长期事实、决策、偏好、架构和笔记 | 用户或智能体明确保存可复用知识 |
| 会话 | 自动采集、整理和诊断日常智能体使用 | 为受支持本机客户端启用自动记忆 |
| 任务 | 具有执行步骤、结果和历史的明确分派工作 | 用户明确创建并分派任务 |
| 沟通 | 长期私信和智能体群组，支持流式回复 | 用户打开联系人或创建群组 |
四类对象保持独立历史，并可在用户明确操作后建立来源链接。
可选 CLI Runtime
仅当本机需要连接智能体、执行任务、采集会话或参与沟通时，安装独立 Runtime。
macOS 与 Linux：
curl -fsSLo tokst-install.sh https://tokst.com/install.sh && sh tokst-install.sh
tokst login
tokst start
tokst status
Windows PowerShell：
Invoke-WebRequest https://tokst.com/install.ps1 -OutFile "$env:TEMP\tokst-install.ps1"
& "$env:TEMP\tokst-install.ps1"
tokst login
tokst start
tokst status
自动记忆默认关闭。仅使用 tokst auto on --agent <name> 为需要采集的受支持客户端启用。