コンテンツにスキップ
Engram Docs

MCP 設定

このページが必要なユーザーは、ほとんどいません。最近の AI クライアント (Claude、 Cursor、ChatGPT、VS Code、Windsurf、Zed) には、数回クリックするだけで Engram を追加できる GUI があります。クライアントごとの手順はAI 連携を参照してください。

設定ファイルを編集したい場合 (またはクライアントに GUI がない場合) は、 簡単な順に 3 つの方法があります。セットアップを AI に任せる、クライアントごとのタブの手順に沿って進める、 または API キーを使って OAuth を省く、のいずれかです。

AI にセットアップを任せる

Section titled “AI にセットアップを任せる”

いちばん速い方法です。下のプロンプトを AI アシスタントに貼り付けてください。AI が、 動いているクライアントを判別し、適切な設定ファイルを編集して (または 適切な CLI コマンドを実行して)、次に何をすればよいかを教えてくれます。

Add Engram as an MCP server in this AI client, then teach the AI to use it.


URL: https://mcp.engram.page
Transport: HTTP
Auth: OAuth — a browser opens on first connect.


First, pick the right path for this client (CLI like `claude mcp add`, editing an mcp.json, etc.), do the setup, and tell me how to restart so the new server registers.


After that's done, add the text below to my long-lived system / global prompt for this client (e.g. ~/.claude/CLAUDE.md for Claude Code, Cursor Rules for Cursor, the personal preferences field at claude.ai/settings/general for Claude Desktop). If it's a web UI you can't edit, just tell me where to paste it:


Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.


Reference: https://engram.page/docs/mcp/manual-config/

うまくいかない場合や、自分で進めたい場合は、下のクライアントごとのタブに 完全な手動の手順があります。

Engram の MCP エンドポイント

Section titled “Engram の MCP エンドポイント”
https://mcp.engram.page

Engram は HTTPS 上で MCP を話します。認証の方法は 2 つあります。

  • OAuth (既定)。 クライアントが上の URL に初めて接続すると、 サインイン用のブラウザーウィンドウが開きます。以降はクライアントがトークンを保持し、 何もせずに再接続します。コピーするキーはありません。
  • API キー。ヘッドレス、スクリプト、共有保管庫の構成向けです。 キーを Authorization ヘッダーに Bearer トークンとして送ります。下の API キー認証を参照してください。

どちらの方法でも、環境変数もローカルのサーバープロセスも不要です。

クライアントを設定する

Section titled “クライアントを設定する”

下のタブからクライアントを選んでください。各タブは、設定、 再読み込み、初回の認証、そして AI に Engram を実際に使わせる場所まで、 一通りそろった手順です。

セルフホストの場合は、以下のどのスニペットでも、クラウドの URL を自分のバックエンドの /api/mcp URL に置き換えてください。標準のプレースホルダーについては、上の エンドポイントのセクションを参照してください。

1. Engram を追加する。 設定の編集を代わりに行ってくれる Claude Code CLI を使います。

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

--scope user フラグを付けると、すべてのプロジェクトで Engram を使えます。 外す (または --scope project にする) と、Engram は現在のプロジェクトの .mcp.json だけに限定されます。

手動で行いたい場合は、~/.claude.json (ユーザースコープ) か、プロジェクトのルートにある .mcp.json に追記します。

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

2. 再読み込みする。 現在の Claude Code のセッションを終了し、 claude を再実行します。claude mcp list を実行して、Engram が登録されていることを確認します。

3. 初回の認証。 Claude Code は自動では促しません。新しい セッションで /mcp を実行し、engram (△ needs authentication と表示されています) を選び、Authenticate を選びます。ブラウザーが開いて OAuth が始まります。Engram にサインインして接続を承認すると、Claude Code がトークンを保存し、以降はそれを再利用します。現時点で付与されるのは、フルの mcp スコープです。アクションごとの細かいスコープは、 ロードマップにあります。

4. Claude に使い方を伝える。 下のスニペットを、 ユーザーレベルの指示ファイルである ~/.claude/CLAUDE.md に追記します。 すべてのプロジェクトに適用されます。

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

API キー認証

Section titled “API キー認証”

既定は OAuth です。API キーは、ヘッドレスやスクリプトからのアクセス、 接続ごとの制御 (書き込み可能なボットか、読み取り専用のエージェントか)、 フルのサインインを許可せずに保管庫を共有したい場合に使います。1 つのキーで MCP と REST API の両方を認証できます。現時点では、すべてのキーが あなたのアカウントのフルアクセスを持ちます。キーごとの細かいスコープは、 ロードマップにあります。

キーを取得する

Section titled “キーを取得する”

app.engram.page/settings/api-keys で生成します。Engram はキーの全文を作成時に一度だけ表示し、以降はプレフィックスだけを表示します。 パスワードと同じように扱い、安全な場所に保管してください。

設定に追加する

Section titled “設定に追加する”

キーを Bearer トークンとして送る headers ブロックを追加します。ラッパー キー (mcpServers / servers / context_servers) は、設定中のクライアントに従います。 上のタブで示した形式と同じものを使ってください。 標準の mcpServers クライアントの場合は次のとおりです。

{
  "mcpServers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page",
      "headers": {
        "Authorization": "Bearer engram_YOUR_KEY_HERE"
      }
    }
  }
}

API キーを設定すると、初回の接続でブラウザーは開かず、 キーですぐに認証されます。キーを更新するには、設定で新しいキーを生成し、 設定ファイルの値を置き換えます。

トラブルシューティング

Section titled “トラブルシューティング”
  • 編集後もクライアントに Engram が表示されない。 ウィンドウだけでなく、 クライアントを完全に再起動してください。
  • 認証でブラウザーが開かない。 ポップアップブロッカーが 邪魔していないか確認してください。クライアントによっては OAuth ウィンドウを独自のブラウザー処理に通すため、 ブロックされると何も表示されずに失敗します。
  • Failed to connect。 URL に届くか確認してください。クライアントをまたぐ問題については、 トラブルシューティングを参照してください。

クライアントごとの GUI での手順については、 AI 連携を参照してください。