快速入門
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> 為需要擷取的支援用戶端啟用。