ローカル MCP クライアントと Skill を接続する
できること
明示的な権限で AI クライアントからメモを読み書きします。
始める前に
ローカルフォルダーを接続します。まずはデモ保管庫で試せます。
操作手順
既存の保管庫の読み書きスイッチは添付も対象とします。更新後にバックエンドを再起動し、ローカルクライアントと LeafLoom ChatGPT プラグインのツール一覧を更新してください。vault_files は検索・詳細・元バイト列・ZIP・タスク状態、vault_files_update はチャット/ローカルアップロード、移動・名前変更・回収・整理・索引保守・タスク操作を担当します。計画を確認し、現在のタスク版を渡して実行を確定します。同名ファイルを保持し、リンクを返しますがノートは自動編集しません。ファイル仕様を参照してください。
設定 → AI 連携 → MCP アクセス権限 でローカル AI の閲覧を有効にし、生成された接続設定をコピーします。専用の認証情報は一度だけ表示されます。Codex は http_headers.Authorization、Cursor は headers.Authorization、Claude Code は type: http と headers.Authorization を使います。認証情報の再生成または全リソース権限の無効化で古い認証情報は直ちに失効します。設定を共有しないでください。
直接保存するには、ローカル AI による変更を別途許可します。ChatGPT は既存の Tunnel と、全メモの閲覧・変更それぞれのスイッチを使います。権限の変更で自動再接続するため、クライアントのツール一覧を更新してください。どちらも書き込みは初期状態で無効です。
完全アクセスは、アーカイブや RAG 対象外を含む接続フォルダー内の Markdown、TXT、HTML/HTM に対応します。検索、分割閲覧、作成、正確な置換、プロパティ、移動、ゴミ箱、履歴復元、リンク、テンプレート、日記を利用できます。RAG は引き続き選択した対象の Markdown/TXT のみを使い、HTML はソースとして読み書きします。従来のローカル接続と bearer 認証は従来の 5 つの読み取り専用機能を保持し、以前の auth-token では完全アクセスできません。
すべての変更でワークスペースのバージョンを確認し、既存メモでは読み取り時のファイルバージョンも必要です。移動・削除は影響のプレビューから開始し、履歴・ゴミ箱も確認して復元できます。MCP は保存済みの内容を読み、競合した下書きを保持し、保存と索引更新の状態を区別します。ウェブアシスタントのメモ編集は従来の提案フローを維持します。管理されたデザインは design_document、design_operations とデザイン履歴、素材、共有ライブラリ、書き出しの各ツールを使い、接続ごとの読み書き権限に従います。
設定 → Skill で LeafLoom スキルをインストールし、ローカルの Codex チャットで $leafloom を使います。起動中のアプリに直接接続して知識庫の検索とタスク操作を行えます。MCP クライアントはツール仕様を参照してください。
CLI が見つからない場合は端末で動作を確認し、サービスを再起動して最新の PATH を読み込ませます。ログインの期限が切れたら CLI で更新します。会話の復元に失敗しても履歴を保持し、CLI の状態を確認してください。メモを削除して修復する必要はありません。
Windows ではインストール済みスキルを更新し、scripts/leafloom.ps1 を使います。利用可能な Python 3.11+ を選び、Store エイリアスを除外し、PowerShell のハッシュテーブルを UTF-8 JSON で渡します。更新後は新しいチャットを開いてください。各環境の呼び出し例を参照できます。
AI 素材検索と受け渡し
検索前に対象の添付グループを編集し、AI 素材検索の対象にする を有効にします。既定はすべて無効で、選択したグループの和集合のみを検索します。未選択時は scope_not_configured を返し、全添付には切り替えません。選択はグループ情報とともに NAS に同期され、競合するグループは解決するまで対象外です。通常の添付閲覧やノート参照には影響しません。
ダウンロード → ダウンロード設定 で素材の保存先を設定し、必要に応じて準備済みローカルモデルによる意味検索を有効にします。AI は vault_files の search_assets、asset_details、asset_preview で既存のローカル/NAS 素材と実際のバージョンを確認し、vault_files_update の deliver_asset と delivery_status で保存します。完了時のみサービス端末の絶対パスを返します。保存済みファイルはキャッシュ削除の対象外で、プロジェクトへの組み込みは AI が行います。モデルがなくてもキーワード検索でき、パッケージ内部や画像の外観類似度は検索しません。
完了後の状態
全体アクセスと RAG 範囲は独立し、Skill の導入だけでは MCP は設定されません。
うまくいかないとき
更新・認証情報の再生成後は接続を読み直し、状態が返す実際の権限を確認します。
