智能體接入
透過 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>。 |