AIアプリの接続(ベータ)
最終更新: 2026-11-20
コンピューター上のAIアプリ——Claude Code、Claude Desktop、Cursor、VS Code、そのほかModel Context Protocol(MCP)に対応したもの——は、Plainvaを通じて保管庫を読むことができます: 検索し、ノートとその節、アウトライン、バックリンク、データベース、タスク、最近のノートを読み、Plainvaでノートを開きます。アプリが自分で何かを変更することはありません。あなたが許可したアプリは変更を提案でき、その提案はあなたが判断するまで待機します(下記参照)。実験的なAI機能の一部で、デスクトップでのみ動作します。
逆の向き——自分で接続したサーバーのツールをPlainvaのアシスタントが使うこと——は、AIアシスタントの外部ツールで説明しています。
三つ目の方法——Plainvaがほかのメーカーのエージェントを保管庫のフォルダーで起動し、そのセッションをAIタブに表示すること——は、外部エージェントで説明しています。
仕組み
Plainvaはアプリの隣に小さな補助プログラムplainva-mcpを同梱しています。AIアプリがそれを起動し、補助プログラムはこのコンピューターのプライベートなチャネル——Windowsでは名前付きパイプ、macOSとLinuxではプライベートなフォルダー内のソケット——で起動中のPlainvaに接続します。ネットワークポートは一切開きません。Plainvaが保管庫を開いた状態で起動している必要があり、そうでなければアプリに分かりやすいメッセージが届きます。
オンにする
- 設定 → AIを開き、この端末でAIを使うをオンにします。このコンピューターのAIアプリの行は、ページの下のほうにあるほかのアプリカードにあります。
- カードこのコンピューターのAIアプリで、このコンピューターのAIアプリにこの保管庫の読み取りを許可をオンにします。
- アプリを設定します(下記参照)。最初の接続時、Plainvaはどのアプリか、どのプログラムが起動したか、どのフォルダーを読んでよいかを尋ねます。何も選択されていないので、保管庫の最上位のフォルダーまたは保管庫全体を選び、許可を押します。拒否するとアプリは断られ、Plainvaは10分間そのアプリについて再び尋ねません。フォルダーの下には変更を提案できるがあります。チェックを入れない限りオフです。許可される内容は後述します。
アプリは次回のためにシステムのキーチェーンに秘密を保存します。フォルダーはアプリごと、保管庫ごとに許可されます: 別の保管庫では、アプリは改めて尋ねます。別の保管庫を開くと、前の保管庫に接続していたアプリは切断されます。新しい保管庫を読むのは、改めて接続してからです。完全ローカルがオンの間(AIアシスタントを参照)、サーバーは休止します: どのアプリも保管庫を読めず、接続してきたアプリは断られます。
アプリを設定する
- Claude Code: 設定からClaude Code用のコマンドをコピーし、ターミナルで実行します。
- Claude Desktop: パッケージを作成… で
plainva.mcpbファイルが書き出されます。開くとClaude DesktopにPlainvaがインストールされます。 - ほかのアプリ(JSON): 設定をコピーし、アプリのMCP設定(たとえばCursorの
mcp.json)に追加します。
アプリに見えるもの
許可したフォルダーだけ、そしてプライバシールールが、インターネットに接続できるクラウドのモデルに送ることを認めたものだけです(アプリは読んだものをどう扱うかPlainvaから見えないため、そのようなモデルとして扱われます): cloud: denyまたはweb: denyのノート、またはそのいずれかのルールのあるフォルダー内のノートはアプリにとって存在しません——本文もタイトルも見えません——。それらへのリンクは伏せられ、ジャーナルの場所は決して送られません。許可したフォルダー内のノートでも、名前がそのままでは判断できないもの——末尾が空白かピリオド、コロンを含む、または合成済みのUnicode形式でない——は同様に除外され、回答には除外したノートの数が示されます。Plainva自身のフォルダー(.plainva、.agent)とルールそのものは決して読めません。リクエストと回答のすべてのパスは2回確認されます: アプリのウィンドウと、Plainvaのネイティブ部分で。許可したフォルダー内にあって別の場所を指すフォルダーのリンクはたどられません。データベースは、アプリが読めるノートだけから計算した値で答えます。他のフォルダーへのリンクにまたがる件数や合計では、それらのノートは除かれます。アプリが読む内容のリンクは、アプリが読めるノートを指す場合だけ残ります。それ以外のリンクは、存在しないノートへのリンクも含めて伏せられます。検索では、伏せられたリンクの文字列からノートは見つからず、疑わしい場合はそのノートを除きます。伏せられたリンクに触れる変更や、その代替表示をノートに書き込む変更は拒否されます。
設定には、このコンピューターで許可したアプリと、この保管庫でのそのフォルダー(ほかでだけ許可したアプリはこの保管庫にはなし)、最近のリクエストが表示されます。削除でアプリの許可をすべての保管庫で取り消します。これはすぐに有効になり、その時点で接続中のアプリにも適用されます。
開いている保管庫の暗号化ワークスペースがこのデバイスで開かれていない間(ロックされているか、このデバイスにその鍵がない場合)、Plainvaはどのアプリにも答えません。一覧や検索も含めてすべてのリクエストは、そのどちらであるかを伝えるメッセージで断られ、ロックした時点で処理中のリクエストには見つけた内容が何も渡されず、接続しようとするアプリにはすぐにそのことが伝えられます。ワークスペースのロックを解除するか、このデバイスで設定すると、同じ接続が再び答えます。許可はフォルダー名に対して与えられます。許可したフォルダーの名前を変えると、もう一度許可するまでアプリには見えなくなり、元の名前で新しく作ったフォルダーはアプリに見えます。
ツールのほかに、Plainvaは5つのスキルをPlainva自身の言語でプロンプトとして、ファイル形式のリファレンスをリソース(plainva://format)として提供します:プロンプトはdaily-orientation、weekly-review、project-status、meeting-prep、task-triageで、project-statusはプロジェクト名を、meeting-prepは会議を尋ねます。プロンプトに対応したアプリでは、コマンドの一覧に表示されます。
アプリに変更を提案させる
読み取りの許可は、書き込みの許可ではありません。アプリが変更も提案できるかどうかは、別の回答です。最初の接続時の確認にある変更を提案できる、または後から設定のスイッチ …は変更を提案できるで決めます。アプリごと、保管庫ごとの設定で、あなたがオンにするまではオフです。アプリの次のリクエストから有効になり、Plainvaは接続中のアプリに、ツールが変わったことをすぐに伝えます(最新のプロトコルのリビジョンを使うアプリには、通知を求めた場合にだけ伝わります)。それを受け取って再接続せずに表示するかどうかはアプリ次第です。
許可したアプリには6つのツールが追加されますが、いずれも保管庫を変更しません。
- ノートへの変更(本文またはプロパティ)は、ノートの余白に提案として置かれ、アプリの名前と「(AIアプリ)」の署名が付きます。ほかの提案と同じく、そこで変更を1つずつ適用または却下します(コメントと提案を参照)。
- 新しいノートは、AIタブの要判断に下書きとして置かれます。そこで作成を選ぶと、ノートが作成されます。
- 名前の変更・移動・削除は、まず確認を求めます。Plainvaが自身のウィンドウで何が起きるかを表示し(名前の変更では、リンクが追従するノートも表示します)、アプリにはPlainvaが待機中であることが表示されます。Plainvaで許可を選び、アプリが続行して初めて、Plainvaはあなたが手動で行うときと同じ方法で実行します。アプリに伝わるのは、実行されたかどうかだけです。削除の場合は、そのあとPlainvaが自身の削除ダイアログを開き、そこで確認するまで何も消えません。このような表示ができないアプリ——MCPプロトコルのリビジョン2026-07-28以降が必要で、フォームで質問を表示できなければなりません——には、この3つのツールは提供されません。
アプリが持ち込んだウェブアドレスは、アシスタントの場合と同じく、何も開いたり読み込んだりしない形(https[://]…)で書かれます。ノート自身のプライバシールール(plainva.ai)をアプリが設定することはできず、暗号化されたワークスペースでは提案・下書き・計画は行われません。設定の最近のリクエストの一覧には、新しい8件が表示され、Plainvaがあなたに確認したもの(確認待ち)、あなたが断ったもの(却下)、通らなかったもの(拒否)には、その言葉が付きます。通ったリクエストには何も付きません。
制限
- デスクトップのみ: スマートフォンではこうしたアプリは動かず、iOSもAndroidもアプリが別のアプリにプライベートなチャネルを提供することを認めていません。
- ブラウザーのChatGPTやclaude.aiからは届きません: それらはインターネット上のサーバーにしか接続できず、Plainvaはそうしたサーバーを運用していません。
- アプリが自分で保管庫を変更することはありません。アプリが書いたものは提案または下書きとして待機し、名前の変更・移動・削除にはPlainvaでのあなたの許可が必要です。