MCP について

MCP (Model Context Protocol) は、Engram のようなツールを AI アシスタントに直接つなぐために、主要な AI 企業 (Anthropic、OpenAI など) が採用した、新しいオープン標準です。万能のコネクターだと考えてください。標準が 1 つあれば、Claude、Cursor、ChatGPT、そのほか MCP に対応した AI ツールのどれからでも、あなたのノートに届きます。ノートの検索、読み取り、新しいノートの保存までできますが、すべてあなたが管理する権限の範囲内です。

Engram を使うのに MCP を理解する必要はありません。AI 連携でお使いの AI ツールを選び、数回クリックするだけで完了します。このページは、背景を知りたい方のためのものです。

MCP とは

MCP が登場する前は、ノートを AI アシスタントに渡すには、コピー&ペースト、エクスポート、あるいはアプリごとの独自連携が必要でした。 MCP は、この接続を標準化します。

Engram が公開する MCP エンドポイントは 1 つ (URL が 1 つ、プロトコルが 1 つ) です。
AI クライアントが MCP を話します (Claude、Cursor、ChatGPT、VS Code、 Windsurf、Zed など)。
ハンドシェイクは OAuth です。 どのクライアントから何に届くかは、あなたが管理します。
ツール、プロンプト、リソースは自動で見つかります。 クライアントが Engram に何が使えるかを尋ね、Engram が答えます。連携ごとにあらかじめ決められたものはありません。

ひとことで言えば、MCP は AI のための USB-C です。ケーブルの規格は 1 つで、両端につなぐ機器は何でも構いません。

接続したらできること

AI に、あるトピックに関するノートを探してもらう。保管庫全体をセマンティックに検索し、最も関連性の高いものを取り出します
フォルダーを要約させたり、関連するノートをつなげさせたりする
新しいノートを下書きさせ、そのまま保管庫に保存させる (あなたの承認を経て)
ノートをエクスポートしたり、コピー&ペーストしたり、どこかに複製したりせずに、 AI のワークフローの中で Engram の検索を使う

Claude に 「先月、X について何を書いたっけ?」 と聞けば、 Claude が Engram の検索ツールを呼び出して、実際に答えを見つけてくれます。

プロトコルの概要

上級者向けに、技術的な仕様の概要を示します。読み飛ばしても、 Engram は問題なく使えます。

Engram は HTTPS 上で MCP を話します。具体的には次のとおりです。

認可: Dynamic Client Registration (DCR) 付きの OAuth 2.1。クライアントは、事前に発行された認証情報を必要としません。
ディスカバリー: GET /.well-known/oauth-authorization-server と tools/list により、クライアントは何に届くかを知ります。
ツール: search、get_note、write_note、list_folders など。
リソース: URI でアドレス指定できるノート。
スコープ: セッションごとに付与する、きめ細かな権限 ( スコープを参照)。

このセクションのページ

MCP 設定: GUI ではなく設定ファイルで接続するユーザー向けの、 JSON スニペットとパス一覧
スコープ: 各権限で何が許可されるか
トラブルシューティング: コネクターが Engram と通信できないとき

クライアントごとのセットアップ (Claude、Cursor、ChatGPT など) については、 AI 連携を参照してください。

インタラクティブなツールカタログ (Engram が公開するすべてのツールを、入力スキーマと例つきで掲載) は、今後のフェーズで公開予定です。バックエンドのコードから直接生成するため、内容がずれることはありません。