本機 stdio MCP Gateway 讓外部 Agent 透過穩定識別與版本查詢檔案、物件、關係和資料表，再提交待審修改。
連線本機工作區
先在桌面 Tano 開啟或重新整理工作區，再複製 MCP 面板中的啟動配置。需要 Node.js 24.12 或更新版本。應用資料目錄必須位於工作區外，並與桌面應用一致，才能共享提案與活動記錄。
從開放原始碼原始碼啟動：
npm run mcp:build
node apps/mcp/dist/tano-mcp.cjs --workspace /path/to/notes --data-dir /path/to/tano-app-data --access review
| 許可權 | 可執行操作 |
|---|---|
read |
查詢與讀取 |
review（預設） |
讀取和提交待審提案 |
write |
額外啟用舊 Markdown 直接建立與條件寫入 |
可重複指定 --directory 限制普通檔案目錄，使用 --object-type 限制物件類型。兩個範圍獨立，工作區指引和模型輸出不能擴大許可權。即使使用 write，跨資源提案也仍需審閱。
查詢目前內容
| 工具 | 返回內容 |
|---|---|
tano_gateway_capabilities |
工作區識別與實際許可權 |
tano_query_files / tano_read_file |
檔案 ID、路徑、屬性、雜湊與內容快照 |
tano_query_objects |
類型化物件和版本 |
tano_query_table |
資料表記錄、儲存檢視和公式結果 |
tano_query_relations |
授權端點之間的關係 |
tano_read_workspace_rules |
已知工作區約定檔案 |
先檢查錯誤和完整性標記，再判斷是否沒有匹配項。按穩定 ID 讀取並保留返回的雜湊；外部移動後先重新整理。路徑本身不能證明檔案識別。
提交與審閱修改
tano_propose_changes 支援 Markdown、物件 JSON 和 .table.json。提供 operationId，每項修改含 path、content、reason 和 expectedHash；已有檔案還需 fileId，新增的 expectedHash 為 null。重試同一操作 ID 時輸入必須相同。
在助理會話記錄中開啟外部提案，逐項檢視差異並採納或拒絕。透過 tano_get_operation 查詢每項狀態和實際寫入回執。提交成功不等於已儲存；批次可以部分成功，不是全有或全無的檔案系統事務。
舊文件提案工具 tano_read_document_identity、tano_propose_document、tano_get_proposal 仍可用。Markdown 提案可轉為逐項建議審閱；資料表和物件提案在助理內處理。
直接寫入與活動
tano_list_documents、tano_read_document 提供舊 Markdown 讀取介面。tano_create_document、tano_write_document 需要顯式 --access write；更新比較目前 SHA-256 和 expectedHash，新增不能覆蓋已有路徑。
過期寫入被拒絕後，重新讀取、比較併合並，再提交。不要只替換 hash 後重發舊正文。tano_list_activity 和 tano_read_activity 提供本機操作記錄與可用差異；客戶端標籤不是識別認證。
Gateway 使用本機 stdio，不是網路協作服務，也不執行終端命令。隱藏應用資料和工作區外符號連結不在讀取範圍。另見Agent 工作流、檔案存取及原始碼接入指南。