ローカル stdio MCP Gateway を通じて外部エージェントがファイル・オブジェクト・関係・テーブルを照会し、安定した ID と版を用いてレビュー用の変更を提出できます。
ローカルに接続する
先にデスクトップでワークスペースを開くか更新し、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 で読み、ハッシュを保持し、外部移動後は更新します。パスだけでは ID を確定できません。
提案を提出・確認する
tano_propose_changes は Markdown、オブジェクト JSON、.table.json を扱います。operationId と、path・content・reason・expectedHash を持つ変更を指定し、既存ファイルには fileId も付けます。新規ファイルのハッシュは null です。同じ操作 ID の再試行は同一入力だけに限ります。
会話履歴で外部提案を開き、各差分を承認・却下します。tano_get_operation で項目ごとの状態と実際の書き込み結果を確認します。提出は保存完了ではなく、一部成功もあり、全体を一括で取り消せるファイル取引ではありません。
従来の tano_read_document_identity、tano_propose_document、tano_get_proposal も使えます。Markdown は個別レビューに移せますが、テーブル・オブジェクトはアシスタントに残ります。
直接書き込みと操作記録
tano_list_documents・tano_read_document は従来の読取です。tano_create_document・tano_write_document には --access write が必要です。更新では expectedHash と現行 SHA-256 を比較し、新規作成は既存パスを上書きしません。
古い版で拒否されたら再読込・統合し、ハッシュだけ差し替えて古い本文を再送しないでください。tano_list_activity・tano_read_activity で操作と差分を見られますが、表示名はクライアントの本人証明ではありません。
Gateway はローカル stdio で、ネットワーク共同編集サーバーや端末実行器ではありません。隠しアプリデータや範囲外リンクは読取対象外です。エージェント、ファイルアクセス、ソースの連携ガイドもご覧ください。