Flexnote MCP:Cursor と Codex からローカルナレッジベースにアクセスする
Flexnote デスクトップアプリに MCP サーバーが入りました。Cursor、Claude Desktop、Codex がローカルライブラリ——日記、カード、ToDo、ホワイトボード——を検索・書き込みでき、データを第三者のノートクラウドへ上げる必要はありません。
Flexnote MCP MCP ノート Cursor MCP Codex MCP ローカルノート MCP Model Context Protocol AI ノート取り MCP サーバー Cursor をノートに接続
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、ホワイトボードを使えます。
| 項目 | Flexnote AI(アプリ内) | Flexnote MCP |
|---|---|---|
| 動作場所 | Flexnote サイドバーの Chat / Agent | Cursor、Codex、Claude Desktop など |
| モデル | 設定で構成した API キー | クライアントが使うモデル |
| 保存 | ローカルナレッジベース | 同じローカルナレッジベース |
| 典型的な用途 | ノートとボード内での Q&A と編集 | 開発ツールからライブラリを読み書き |
2. スコープ
現在のワークスペース内のカード、日記、ホワイトボード、ToDo、タグ、コレクションを照会できます。書き込みツールには読み取り専用モードをオフにする必要があります。Canvas 操作にはホワイトボード ID が必要です。ボードが開いていなければ、Flexnote はそこへ移動しキャンバスの準備ができるまで待つので、クライアントのリクエストがタイムアウトしません。
| カテゴリ | 説明 |
|---|---|
| 検索と読み取り | ライブラリ検索、カード全文、ハイライト、メタデータ、PDF とエンティティ一覧 |
| 日記 | 日付の一覧と読み取り。作成または追記(日付がなければ当日) |
| カードとタグ | ノートカードの作成、内容の追記、タグ付与、プロパティ設定、コレクション管理 |
| ToDo | 作成、更新、完了、削除 |
| ホワイトボード | ボードとノードの一覧。付箋、テキスト、図形、ウェブサイトカード、メディアカード、セクション、接続の作成。レイアウトの読み取りとローカルな配置の適用 |
| アプリで開く | 対応するカードまたはボードを Flexnote ウィンドウで開く |
3. サーバーの有効化
MCP は Pro 機能です。有効なメンバーシップでのサインインが必要で、 Flexnote デスクトップアプリが起動している必要があります。アプリを終了するとローカルポートは閉じ、クライアントは接続できません。
- Flexnote → 設定 → MCP server を開く。
- サービスを有効にする。ループバックのみにバインドします。既定ポートは 39125 です。
- クライアント向け設定をコピーする:Cursor / Claude Desktop 向けの HTTP JSON。
commandを起動するクライアント向けの stdio ブリッジ。Codex CLI 向けの TOML。 - 設定をクライアントに追加する。アクセストークンはローカル認証専用です。公開リポジトリにコミットしたり共有したりしないでください。
関連する追加オプションがふたつあります: 読み取り専用モード は照会ツールだけを公開し、初回の接続テストに適しています。外部モデルに渡したくないツールは個別に無効化できます。
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 は同じローカルライブラリを外部の開発ツールにつなぎます。
関連記事
Heptabase のデータを Flexnote にワンクリックでインポートする方法
Flexnote はローカルの Heptabase からノート、ジャーナル、タグ、ホワイトボード、PDF ハイライト、マインドマップ、プロパティ、添付ファイルを一括インポートできます。新規ワークスペースまたは現在のワークスペースへ書き込み、再インポート時はスキップ/上書きに対応します。
製品ガイドObsidian の Vault を Flexnote にインポートする方法
Obsidian Vault を Flexnote にインポート:Markdown ノート、タグ、ウィキリンク、添付ファイル、Canvas ボードを移行し、安全な再インポートオプションも使えます。
特集2026年版・おすすめAIノートアプリ10選(実測)
2026年に使えるAIノートアプリを実測比較。ナレッジベースチャット、BYOK、ローカルプライバシー、ホワイトボードAgent、自動リンクなどの観点で Flexnote、NotebookLM、Notion AI、Mem、Reflect、Obsidian、Heptabase などを並べ、選び方も整理します。