MCP連携
Claude Code や Codex のようなコーディング用の AI に、workspace の note を直接読み書きさせられます。その橋渡しをする仕組みが MCP です。つないでおくと、アプリの画面を開かなくても、AI 側に「この note をこう直して」と頼めるようになります。
つなぐには、パソコンにその AI が入っていることが要ります。あわせて、パソコンのターミナル（macOS なら Terminal.app のような、命令を打ち込むためのアプリ）で 1 回だけ命令を実行します。ふだん文章を書くだけなら、この設定は要りません。
つないだ AI にできること
一覧と検索 — workspace の note を並べたり、言葉で探したりできます。
読み書き — note の中身を読み、新しく作ったり書き換えたりできます。
移動と削除 — note を別の場所へ移したり、消したりできます。
変更履歴 — 過去の版や checkpoint をたどり、前の版に戻せます。
添付ファイル — asset を一覧したり、取り出したり、新しく置いたりできます。
作業の依頼 — まとまった作業を、クラウド側の AI にそのまま任せられます。
対象になるのは、つないだ 1 つの workspace の中だけです。別の workspace の中身には手が届きません。
つなぐ前に用意するもの
Claude Code または Codex が、このパソコンで使える状態になっていること
zudo-text にサインインしていること
workspace の master password を、つないだ側に渡す方法を決めておくこと
master password は workspace の中身を復号するためのものです。詳しくは用語集にまとめています。
Settings → Local AI Agent での設定
Settings → Local AI Agent（つなぐための設定をまとめて作る画面）を開きます。Command Palette（Mod+K で開く、コマンドの検索窓）からは Open Local AI Agent settings でも開けます。このコマンドには最初キーが割り当てられていないので、キーで開きたいときは Settings → Shortcuts の App で割り当ててください。
上から順に次のようになっています。
Runtime identity — Workspace ID と Server URL が出ます。それぞれ横の Copy でコピーできます。
Agent harness — Claude Code と Codex のどちらに向けた設定を作るかを選びます。
Workspace password source — password の渡し方を選びます。
Create token & config — 押すと token と設定がまとめて作られます。
サインインしていないときは、先にサインインするよう表示が出て、Create token & config は押せません。
Add encryption salt override (debugging only) は動作を調べるための項目です。ふだんは触らずにおきます。
password の渡し方
Password file (recommended) — password を書いたファイルを自分で用意し、その絶対パスを入れます。
/で始まるパスでないと受け付けられません。ファイルは自分の権限だけで読める状態にしてください。Prompt when the MCP server starts — つないだ側が動きはじめるたびに、その場で password を聞かれます。どこにも保存されない代わりに、毎回パソコンのターミナルの画面が必要になります。
どちらを選んでも、password がこの画面に表示されることも、この画面から保存されることもありません。
生成された設定の貼り付け
Create token & config を押すと、Copy this configuration now という囲みが現れ、そのまま実行できる命令の並びが表示されます。Copy full config でコピーして、パソコンのターミナルに貼り付けて実行します。
中身は 3 つに分かれています。必要な道具を入れる、つないだ側に zudo-text を登録する、登録できたかを確かめる、という順です。
Caution
この表示は一度きりです。囲みの中の token は、閉じたあと二度と表示されません。貼り付けが済むまで閉じないでください。
Discard one-time config で閉じても、作られた token は生きたままです。使わずに捨ててしまったときは、Settings → Access Tokens でその token を Revoke して無効にします。
Settings → Access Tokens での発行
自分で書いたスクリプトや、ほかの道具から workspace を扱いたいときは、Settings → Access Tokens（長期の合鍵を発行して管理する画面）から token を作ります。Command Palette の Open Access Tokens settings でも開けます。このコマンドにキーを割り当てることはできません。
下の入力欄で発行します。
左の欄に token の名前を入れます。あとで見分けるための名前なので、用途が分かるものにします。
隣の欄で有効期限を決めます。空のままにすると期限なしになります。
Scope で、その token に許す範囲を選びます。
必要なら Restrict to this workspace only を入れます。
Create token を押します。
Scope で選べるのは次の 6 つです。Full access はほかの 5 つと同時には選べません。
Full access — 制限なしです。
Read documents / Write documents — note の読み取りと書き込みです。
Read assets / Write assets — 添付ファイルの読み取りと書き込みです。
Invoke agent — クラウド側の AI に作業を頼めるようになります。
最初は note と添付ファイルの読み書きの 4 つが選ばれています。用途に足りる範囲まで減らしておくと、その token でできることもそのぶん狭くなります。
Restrict to this workspace only を入れると、その token はいま開いている workspace にだけ効きます。入れないと、アカウントが持つほかの workspace にも届きます。
発行したあと
作ると New Access Token の画面が出て、token の文字列が 1 回だけ表示されます。Copy でコピーし、安全な場所に控えてから Done で閉じます。閉じたあとに同じ文字列を出す方法はありません。
一覧には、作った日、最後に使われた日、期限、許した範囲が並びます。workspace を限定した token には、その旨の印が付きます。
使わなくなった token は Revoke で無効にします。確認の画面が出て、Revoke を押すとその場で効かなくなります。取り消しはできないので、その token を使っていた仕掛けはすべて止まります。
Active note pointer
つないだ AI に「いま開いている note」を伝える仕組みです。最初は切ってあります。
Settings → Local AI Agent の下にある Active note pointer で、Enable active note pointer を押すと入り、Disable active note pointer で切れます。Command Palette からも同じ切り替えができます。このコマンドにキーを割り当てることはできません。
入れたときに伝わるのは、いま開いている note の場所、どの frame のどの表示か、選んでいる範囲の位置までです。note の本文そのものは渡りません。
この設定はこの端末だけのもので、token を作っても勝手に入ることはありません。
安全のための境目
token は本人確認のためのものです。 token だけでは workspace の中身は読めません。中身を復号するには master password が別に要ります。
password と token は別々に渡ります。 password はファイルか起動時の入力から読まれ、token とは別の経路をたどります。
範囲を狭めるほど被害は小さくなります。 読み取りだけで足りる用途なら、書き込みの範囲は付けずにおきます。
心当たりのないときは無効にします。 token が漏れたかもしれないときは、Settings → Access Tokens で Revoke すればその場で止まります。