Trunkbase は Model Context Protocol (MCP)に対応しているため、MCP 対応の AI クライアントは、ボールトを公開すればそれを読み取れます。クライアントの接続方法は 2 通りあります。
クライアントの接続方法
- コネクターバンドル（`.mcpb`） — 対応クライアントは Claude Desktop。Claude Desktop は stdio 経由でローカルサーバーと通信します。Trunkbase は
.mcpbバンドルを生成します。開くだけで、数クリックで Trunkbase を Claude に登録できます。 - Localhost Streamable HTTP — 対応クライアントは Claude Code と、そのほかの HTTP 対応クライアントです。これらはローカルサーバーのエンドポイント
127.0.0.1に直接接続します。
いずれの方法でも、サーバーは 127.0.0.1 のみにバインドされ、ネットワーク上で待ち受けることはありません。そして、すべてのリクエストは応答前にオリジンが検証されます。
AI にできること
読み取りアクセスは現在提供中です。書き込みアクセスは別の、オプトイン方式のレイヤーです。ゲートとなるのは常に ボールトであり、クライアントではありません。
| 機能 | 利用できる対象 | ゲート |
|---|---|---|
| ノートの読み取り、検索、つながりをたどる | 接続中のすべてのクライアント | ボールトごとの読み取り公開 — 既定ではオフ |
| タグの追加、ノートの作成・更新 | 書き込み可能なボールト上のクライアント | ボールトごとの書き込み公開 — 既定ではオフ。事前に読み取りが必要 |
| ファイルの削除・移動 | 誰も（一切不可） | AI サーフェスには一切組み込まれていません |
読み取りツールは意図的に範囲を絞っています。ボールトの一覧表示、ボールト内の検索、ノートの取得、フォルダの一覧表示、類似ノートの検索、そしてそれらの間のつながりの読み取りです。ドキュメントに関する質問に答えるにはこれで十分であり、それ以上のことはできません。
書き込みはボールト単位で、すべてか無しかのどちらかです。 ボールトで書き込みを有効にすると、接続中のすべてのクライアントがそのボールトに書き込めます。クライアントごとの書き込み段階はありません。ボールトはディスク上の単なるファイルなので、意味のある制御はボールトのトグルそのものです。AI による書き込みはすべて作成者のラベルが付き、上書き前にスナップショットが取られるため、常に元に戻せます。
今後の予定
- 対応クライアントの拡充。 LM Studio、Gemini CLI、Cursor、VS Code などを検討リストに入れています。
- 自分のキーを使うモデル（BYOK） とローカルモデルのオプションは、今後のリリースで予定しています。
- macOS が次に対応予定の OS です。
リモートアクセス（別のマシンからボールトにアクセスすること）は、意図的にまだ提供していません。将来的に、セキュリティを最優先した専用の設計に向けて温存しています。今のところ、すべてはローカルにとどまります。それこそが本質です。