Flexnote MCP：Cursor と Codex からローカルナレッジベースにアクセスする

Cursor や Codex で作業しているとき、ローカルのノート——以前の決定、文献の抜粋、ボードのレイアウト——を参照したくなることがよくあります。別のチャットにテキストをコピーしたり、アプリを切り替えたりすると、ナレッジベースと今のワークフローが分断されます。

Flexnote デスクトップアプリにはいま MCP サーバー（Model Context Protocol）が含まれます。サービスは 127.0.0.1 だけを待ち受けます。プロトコルを実装するクライアント——Cursor、Claude Desktop、Codex を含む——は、現在のライブラリを検索・読み取り・書き込みできます。データはユーザーの端末に残り、第三者のノートクラウドへアップロードされません。

1. MCP とアプリ内 Flexnote AI の違い

MCP は、外部の AI クライアントが呼べるツールを宣言するためのオープンプロトコルです。クライアントはツール一覧を取得し、名前で呼び出し、JSON テキストを受け取ります。モデルはクライアント側で選ばれ、Flexnote は課金やプロバイダを仲介しません。

アプリ内の Flexnote AI はサイドバーで動きます：設定で構成した API キーを使い、回答には引用が付き、Agent はボードを編集できます。MCP は同じライブラリを 外部の開発ツールに公開するので、エディタを離れずに日記、カード、ToDo、ホワイトボードを使えます。

2. スコープ

現在のワークスペース内のカード、日記、ホワイトボード、ToDo、タグ、コレクションを照会できます。書き込みツールには読み取り専用モードをオフにする必要があります。Canvas 操作にはホワイトボード ID が必要です。ボードが開いていなければ、Flexnote はそこへ移動しキャンバスの準備ができるまで待つので、クライアントのリクエストがタイムアウトしません。

3. サーバーの有効化

MCP は Pro 機能です。有効なメンバーシップでのサインインが必要で、 Flexnote デスクトップアプリが起動している必要があります。アプリを終了するとローカルポートは閉じ、クライアントは接続できません。

1. Flexnote → 設定 → MCP server を開く。
2. サービスを有効にする。ループバックのみにバインドします。既定ポートは 39125 です。
3. クライアント向け設定をコピーする：Cursor / Claude Desktop 向けの HTTP JSON。command を起動するクライアント向けの stdio ブリッジ。Codex CLI 向けの TOML。
4. 設定をクライアントに追加する。アクセストークンはローカル認証専用です。公開リポジトリにコミットしたり共有したりしないでください。

関連する追加オプションがふたつあります： 読み取り専用モード は照会ツールだけを公開し、初回の接続テストに適しています。外部モデルに渡したくないツールは個別に無効化できます。

4. Cursor、Claude Desktop、Codex の接続

Cursor / Claude Desktop

設定から HTTP 構成を使います。必要なフィールドはローカル URL と Bearer トークンです：

{
  "mcpServers": {
    "flexnote": {
      "url": "http://127.0.0.1:39125/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Codex CLI

Codex CLI は通常 stdio ブリッジを使います：Node が Flexnote 提供のスクリプトを実行し、標準入力をローカル HTTP エンドポイントへ転送します。設定から TOML 構成をコピーし、スクリプトの場所を確認できます。環境変数に FLEXNOTE_MCP_URL と FLEXNOTE_MCP_TOKEN を設定します。

5. リクエストの例

接続が確立したあと、ツール名は不要です。自然言語のリクエストで十分です。次の文で連携を確認できます：

• 「いま開いている Flexnote ワークスペースはどれ？最近のホワイトボードとカードを 5 件一覧して。データは一切変更しないで。」
• 「この結論を今日の日記に追記して。なければ作成して。通常のノートカードとしては保存しないで。」
• 「タイトルが MCP trial のノートを作って。本文は Markdown の見出し 1 で始めて。」
• 「指定のホワイトボード（whiteboardId を渡す）に付箋をふたつ作り、つなぎ、キャンバスのレイアウトを読んで。」
• 「ToDo を一覧し、ひとつを完了にして。」

書き込みが成功すると、Flexnote はウィンドウに通知を表示します。一致するエンティティがあれば、「表示」で対応ページを開き、なければ画面を更新できます。通知は閉じるまで残ります。

6. セキュリティ

サービスは localhost のみを待ち受けます。同じ端末上でアクセストークンを持つ他のプロセスは、同じツールを呼べます。トークンは資格情報として扱ってください。設定で再生成すると、以前の構成はすぐに無効になります。

書き込みツールが有効なとき、外部モデルはライブラリを変更できます。初回の検証では読み取り専用モードを有効にするか、作成・削除・ホワイトボードツールを無効にしてください。MCP は いま開いているワークスペース にのみ適用されます。書き込みの前にワークスペースを確認してください。

7. 制限

• デスクトップアプリなしのブラウザのみ利用では、ローカル MCP ポートはありません。
• チーム向けゲートウェイではなく、公衆網アクセスもありません。他の人とライブラリを共有する用途ではありません。
• Flexnote はリアルタイムの多人ホワイトボードではなく、MCP もその能力を追加しません。製品の範囲は Flexnote とは を参照してください。

8. 始め方

MCP を含むビルドへデスクトップアプリを更新し、Pro アカウントでサインインし、設定でサーバーを有効にし、設定を Cursor または Codex に追加します。書き込みを有効にする前に、読み取り専用モードで検索を確認してください。クライアントは ダウンロードページから。Pro の詳細は 料金 にあります。

既存のアプリ内ナレッジ Agent のワークフローを変える必要はありません。MCP は同じローカルライブラリを外部の開発ツールにつなぎます。