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 專注於讀取和保存長期知識。