Engram を AI に接続する

Engram はリモート MCP サーバーです。以下のどのクライアントも、同じ URL に接続し、OAuth でサインインし、保管庫のノートを読み書きします。インストールするものはなく、Obsidian を開いておく必要もありません。

https://mcp.engram.page

このサーバーは Streamable HTTP を話し、OAuth 2.1 で認証します。クライアントは自動的に自身を登録するため、クライアント ID やシークレットをコピーする必要はありません。

はじめる前に

はじめる前に、次を確認してください。

app.engram.page に Engram アカウントがある。
少なくとも 1 つの保管庫が同期されている。Obsidian プラグインまたは Web アプリを開き、直近 1 日以内にノートが同期されていることを確認してください。
ブラウザーでサインインできる。MCP の認証フローはブラウザーウィンドウを開きます。
OAuth の代わりに API キーを使う予定の場合: API キーには Pro が必要です。 OAuth サインインは Free を含むすべてのプランで使え、推奨の方法です。 Free と Starter では、API キーを作成することも使うこともできません。

Claude (Web 版とデスクトップ版)

claude.ai/customize/connectors を開きます。ここでの設定は、claude.ai とデスクトップアプリの両方に適用されます。
+ をクリックし、Add custom connector を選びます。
名前に Engram、リモート MCP サーバーの URL に https://mcp.engram.page を入力します。Advanced settings は空のままにします。
Add、続いて Connect をクリックし、サインインのウィンドウで承認します。

Claude の Free プランでは、カスタムコネクターを 1 つ追加できます。詳しい手順は Claude Desktop を参照してください。

ChatGPT

カスタムコネクターは、ChatGPT の Developer mode の中にあり、対象となる有料プランの Web 版で使えます。Business または Enterprise のワークスペースでは、まず管理者が許可する必要があります。

Settings → Apps → Advanced settings を開き、 Developer mode をオンにします。
Settings → Apps に戻り、Create app をクリックします。
名前を Engram にし、MCP サーバーの URL を https://mcp.engram.page に設定し、認証には OAuth を選びます。
Scan Tools をクリックし、完了するまで待ちます。
Create をクリックし、サインインのウィンドウで承認します。
チャットで、入力欄のツールメニューから Engram を選びます。

Business ワークスペースでは、管理者が公開するまで、アプリは Workspace settings → Apps → Drafts に置かれます。

詳しい手順は ChatGPT を参照してください。

Grok

Grok のコネクターディレクトリには、Engram は載っていません。URL を指定して、カスタムコネクターとして追加します。

grok.com/connectors を開きます。
New Connector、続いて Custom をクリックします。
https://mcp.engram.page を貼り付け、サインインを完了します。

Grok アプリではなく xAI API で開発する場合は、 Grok (xAI API) を参照してください。

Cursor

Engram を ~/.cursor/mcp.json (すべてのプロジェクト) か .cursor/mcp.json (1 つのプロジェクト) に追加します。

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

Cursor を完全に終了して開き直します。サインインのウィンドウは、エージェントが初めて Engram のツールを呼び出したときに開きます。詳しい手順は Cursor を参照してください。

VS Code

VS Code は、Copilot Chat の Agent モードで MCP サーバーを読み込みます。コマンドパレットから MCP: Add Server を実行するか、次の内容を .vscode/mcp.json に追加します。

{
  "servers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page"
    }
  }
}

engram エントリの上にある Auth のコードレンズをクリックして、サインインします。詳しい手順は GitHub Copilot を参照してください。

Claude Code

claude mcp add --transport http engram https://mcp.engram.page

claude を再起動し、/mcp を実行して engram を選び、 Authenticate を選びます。--scope user を付けると、すべてのプロジェクトで Engram を使えます。詳しい手順は Claude Code を参照してください。

任意の MCP クライアント

クライアントがリモート MCP サーバーに対応している場合は、次を設定します。

URL: https://mcp.engram.page
トランスポート: Streamable HTTP
認証: OAuth。Engram は認可サーバーのメタデータを公開し、 Dynamic Client Registration を受け付けるため、準拠したクライアントならほかに必要なものはありません。

ブラウザーでのサインインを実行できないクライアントは、代わりに Engram の API キーを Bearer ヘッダーで送れます。API キーには Pro が必要です。どちらの設定形式も MCP 設定にあります。

初回のサインイン

初めて接続すると、クライアント が Engram へのサインインを求めるブラウザーウィンドウを開きます。サインインし、許可したい権限にチェックを入れて、Approve をクリックします。ブラウザーは自動的にクライアントに戻ります。トークンのコピー&ペーストも、環境変数も不要です。Google、Dropbox、GitHub にアプリを接続するときと同じ種類のサインインフローです。

ブラウザーでのフローを省きたい場合 (ヘッドレス、スクリプト、共有保管庫の構成など) は、代わりに API キーで認証することもできます。MCP 設定 → API キー認証を参照してください。

動作を確認する

ノートにしか答えられないことを、AI に聞いてみてください。たとえば次のようなものです。

What value did I set for POOL_SIZE in my deploy notes?

保管庫の内容をもとに答えたら、接続できています。そうでなければ、トラブルシューティングを参照してください。

接続を解除する

AI クライアントでコネクターを削除し、続いて app.engram.page/settings/connections でそのセッションを失効させます。