Claude Desktop

Claude Desktop のコネクター UI は、Engram をつなぐ最もスムーズな方法です。 URL を貼ってサインインするだけで、設定ファイルも、コピーする API キーも要りません。内部で何が起きているかの背景は、MCP を参照してください。

前提条件

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

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

セットアップ

Engram コネクターを追加するページを開きます。Engram の名前と URL が入力済みの状態で、 Claude のコネクター設定が起動します。この設定は、デスクトップアプリと claude.ai の両方に反映されます。

手動で行いたい場合は、 claude.ai/customize/connectors を開き、+ ボタンを押してカスタムコネクターを追加します。
2 つの項目を入力し、Add をクリックします。上のリンクからモーダルを開いた場合は、どちらも入力済みです。そうでない場合は、自分で入力してください。

Name: 好きな名前で構いません。たとえば次のとおりです。
```
Engram
```
Remote MCP server URL:
```
https://mcp.engram.page
```
ブラウザーの認可ウィンドウが開きます。何が表示されるかは、初回の認証を参照してください。
スコープの画面で、要求されている権限を確認して承認します。
Claude に使い方を伝えると、 Claude が自動的に Engram を使うようになります。
試してみると、コネクターが動作することを確認できます。

初回の認証

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

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

Claude に使い方を伝える

コネクターを追加しただけでは、半分です。伝えなければ、Claude は Engram を使いません。 Claude のグローバル設定に短い指示を入れておくと、どの会話でも Engram を記憶として使うようになります。

claude.ai/settings/general を開きます。
What personal preferences should Claude consider in responses? の欄 (グローバル指示のボックス) を探します。
次のスニペットを貼り付けます。すべての会話で有効にするため、独立した 1 行にしてください。

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.

これで Claude は、あなたが共有した内容を調べたり保存したりする必要があるとき、自動的に Engram を使うようになります。

試してみる

接続してグローバルプロンプトを設定すると、サイドバーにコネクターが表示されます。次のように聞いてみてください。

保管庫からエンジニア採用面接のプロセスに関するノートを検索して、上位 3 件を要約して。
先月書いた、埋め込みに関するものをすべて探して。
「Q3 planning」というノートを読んで、アクションアイテムを抜き出して。
「project-ideas.md」のフロントマターと外向きリンクを見せて。
「Meeting notes」フォルダーに「Sync with design, May 21」というノートを新しく作って、今日の要点をまとめて。
「roadmap.md」に「Decisions」セクションを追加して、この 3 項目を書いて。
保管庫の最上位フォルダーを一覧にして。
「inbox」にある「Q4」に触れているものを、すべて「Q4-planning」に移動して。

Claude が Engram の search (または get_note、write_note など) ツールを呼び出し、結果を取り出して、その文脈で答えます。

付与されるスコープ

Claude Desktop は、承認画面で mcp スコープを要求します。これは、保管庫に対する MCP ツールのすべてをカバーする、単一の許可です。アクションごとの細かいスコープ (読み取り専用、削除不可など) は、ロードマップにあります。詳細と取り消しの流れについては、スコープを参照してください。

トラブルシューティング (Claude Desktop 固有)

認可ウィンドウが開かない。 Claude Desktop が最新バージョンであること、ポップアップブロッカーが有効になっていないことを確認してください。
“Connector failed to load.” MCP の URL に届くか確認してください。ブラウザーのタブに貼り付けます。エラーではなく、構造化された応答のページが表示されるなら、接続は問題なく、原因は Claude Desktop 側にあります。再起動して、もう一度試してください。

クライアントをまたぐ問題 (認証の拒否、スコープのエラー、同期の欠落) については、トラブルシューティングを参照してください。

接続の解除

接続の解除は、どちら側からでも有効になります。都合のよいほうを選んでください。

Claude アプリから: Settings → Connectors を開き、Engram を見つけて、 Disconnect を選びます。

Web 版の Claude から: claude.ai/customize/connectors を開き、 Engram コネクターをクリックして、Disconnect を選びます。

Engram から: app.engram.page/settings/connections を開き、セッションを切断します。

どの方法でも、OAuth トークンはサーバー側で無効になり、再接続するには Claude Desktop での再認証が必要です。

次のステップ

MCPプロトコルの概要。

スコープ必要最小限の権限を選ぶ。

すべての連携別のクライアントを選ぶ。