MCP連携
MemoryFirstは、Model Context Protocol(MCP)サーバーを公開しています。対応するクライアント(Claude、ChatGPT、Cursor、LM Studio、独自のエージェント)であれば、あなたのIDで、検証可能な出典付きで、会社の記憶を読み書きできます。MCPクライアントを持たないローカルモデルでも、コンテキストをテキストとして受け取ることで利用できます。
近道:AIに頼む
コネクタのメニューが見つからない場合や、スマートフォンをお使いの場合は、このメッセージをアシスタントに貼り付けてください。このページを読み取って、お使いのクライアントでの正確な手順を案内してくれます。
https://mcp.memoryfirst.ai これをMCPコネクタとしてインストールして、私のAIクライアントでの正確な手順を教えてください。2つの接続方法
リモート(推奨)
すべてのクライアントとチームメンバー全員で共通の、単一のHTTPエンドポイントです。何もインストールする必要がなく、スマートフォンやclaude.aiからも使えます。
https://mcp.memoryfirst.aiすでに設定済みの方向けに、以前のURLも引き続き動作します: https://api.memoryfirst.ai/mcp
stdio専用クライアント
ローカルプロセスしか起動できないクライアント(旧版のClaude Desktop、スクリプトなど)では、オープンソースのブリッジmcp-remoteが同じリモートサーバーに接続し、OAuthでログインします。独自のnpmパッケージはありません。
npx -y mcp-remote https://mcp.memoryfirst.ai認証とID
- APIキー: スクリプト、CLI、エージェント向けです。設定 → APIキーで作成し、次の形式で送信します:
Authorization: Bearer mf_live_… - OAuth: 人間向けです。クライアントがMemoryFirstのログイン画面を開き、アカウントでログインすると、すべての呼び出しに、あなたの名前と実行したAIが署名として記録されます。キーをコピーする必要はありません。
- チーム: ワークスペースの各メンバーには、オーナー、メンバー、閲覧専用のいずれかのロールがあります。閲覧者はrecallとqueryはできますが、書き込みはできません。イベントには、書き込んだ人(個人とモデル)が記録されます。
クライアントごとの設定
- Claude Code:
claude mcp add --transport http memoryfirst https://mcp.memoryfirst.ai --header "Authorization: Bearer mf_live_…" - claude.ai, Claude Desktop, Claude iOS: 設定 → コネクタ → カスタムコネクタを追加で、上のURLを指定します。アクセスはOAuthで行います。
- ChatGPT: 設定 → コネクタ → 作成で、上のURLを指定します。mf_* に加えて、コネクタのsearchとfetchのツールを使用します。
- Cursor, VS Code, Windsurf: MCPサーバーのファイルに、次を追加します:
{ "mcpServers": { "memoryfirst": { "url": "https://mcp.memoryfirst.ai", "headers": { "Authorization": "Bearer mf_live_…" } } } } - LM Studio, Open WebUI, Jan: MCP対応のデスクトップクライアントであれば、同じURLと同じキーを使います。お使いのマシンで動くモデルが、会社の記憶を読み書きします。
- 独自のエージェント: HTTP上のJSON-RPC 2.0(initialize、tools/list、tools/call)で、ステートレスです。どのMCP SDKでも動作します。
ChatGPTを接続する
- ChatGPTで、設定 → アプリとコネクタを開きます。独自のコネクタにプランの条件がある場合は、詳細設定で開発者モードを有効にしてください。
- 「作成」を押し、名前を MemoryFirst にして、認証にOAuthを選び、MCPサーバーのURLとして次を貼り付けます:
https://mcp.memoryfirst.ai - ChatGPTがMemoryFirstの画面に移動します。アカウントでログインし、ワークスペース、アクセスレベル(読み取り専用がデフォルトで選択されています)、範囲、必要に応じて有効期限を選んで、「認可する」を押します。
- チャットで、ツールメニューからMemoryFirstを有効にします。ChatGPTはsearchとfetchで検索し、mf_queryで質問します。読み取りと書き込みを許可した場合は、mf_recordで記録することもできます。
Claudeを接続する
- claude.aiで、設定 → コネクタ → カスタムコネクタを追加を開き、URLを貼り付けます(TeamおよびEnterpriseプランでは、組織の管理者が追加します):
https://mcp.memoryfirst.ai - 「接続」を押すと、MemoryFirstの画面が開きます。ログインして、ワークスペース、アクセスレベル、範囲、有効期限を選び、「認可する」を押します。
- 同じアカウントであれば、コネクタはclaude.ai、Claude Desktop、モバイルアプリで利用できます。会話ごとに、ツールメニューから有効にしてください。
- Claude Codeでは、サーバーを追加して /mcp で認可します(または、上記のようにAPIキーを使います):
claude mcp add --transport http memoryfirst https://mcp.memoryfirst.ai
自分自身のセッションを回答から除外する
ヘッダー X-MemoryFirst-Session にClaude CodeのセッションIDを指定して送信すると、mf_queryとsearchは、そのセッション自身の書き起こしを結果から除外し、直前の質問がそのままエコーとして返ってくることがなくなります。これは任意の設定で、指定しなくても何も変わりません。値は、英字、数字、ハイフン、アンダースコアで構成された8〜128文字である必要があり、それ以外は無視されます。Claude Codeは、保存された設定内の環境変数への参照を、接続のたびに展開します。そのため、IDは実行中のセッションの環境から読み取られます。ターミナルでは、サーバーを追加するときに変数が展開されないよう、シングルクォートを使ってください。この機能は、Claude Codeが環境にCLAUDE_CODE_SESSION_IDを公開していることを前提としています。お使いのバージョンが公開していない場合は、ヘッダーが空のまま、または展開されないまま送信され、サーバーはそれを無視します。
コマンドラインから(APIキーで接続する場合は、Authorizationヘッダーも追加してください):
claude mcp add --transport http memoryfirst https://mcp.memoryfirst.ai \
--header 'X-MemoryFirst-Session: ${CLAUDE_CODE_SESSION_ID}'または .mcp.json で:
{
"mcpServers": {
"memoryfirst": {
"type": "http",
"url": "https://mcp.memoryfirst.ai",
"headers": { "X-MemoryFirst-Session": "${CLAUDE_CODE_SESSION_ID}" }
}
}
}stdioサーバー(@memoryfirst/mcp-server)とClaude Codeのフックは、セッションIDがわかる場合には、すでに自動でこのヘッダーを送信します。
各アクセスレベルの意味
アプリケーションが要求するのは上限で、どこまで与えるかはあなたが決めます。あなたのロールが許可する範囲を超えて付与されることはありません。閲覧専用のメンバーは、書き込みを選んでも書き込めません。
- 読み取り専用(デフォルト): 記憶を参照します:mf_recall、mf_query、mf_projects、mf_state、search、fetch。イベントの記録、状態の再生成、タスクの操作はできません。
- 読み取りと書き込み: 加えて、意思決定やイベントの記録(mf_record)、状態の再生成、タスクの作成と更新を、あなたの名前で署名して行います。リスク:AIが悪意のあるもの(Webページやメールなど)を読み込むと、誘導されて記憶に偽のデータを書き込む可能性があります。本当に必要なアプリケーションにのみ付与してください。
- 一部のプロジェクトのみ: この接続は、選択したプロジェクトのみを参照できます。ワークスペース全体を横断するツール(search、mf_morning、mf_assets、mf_skills)は利用できなくなります。ChatGPTでは、プロジェクトを指定してmf_queryで質問してください。
- 有効期限: 選択した日付を過ぎると、接続は動作しなくなり、アプリケーションは再度許可を求める必要があります。
- 取り消し: ダッシュボードの「連携アプリ」に、各接続のレベル、プロジェクト、承認した人、最終利用日が一覧表示されます。取り消すと更新ができなくなり、次の呼び出しで接続は動作しなくなります。
MCPクライアントを持たないローカルモデル
Ollama、llama.cpp、またはシステムプロンプトしか受け付けないモデルの場合:トークン予算に収めたプロジェクトのコンテキストを取得して、渡してください。ほかのクライアントと同じ状態を参照します。違うのはクライアントであって、記憶ではありません。
# 指定した予算内でのmarkdown形式のプロジェクト状態 CONTEXT=$(curl -s "https://api.memoryfirst.ai/v1/brain/context?project=lexiel&max_tokens=3000" \ -H "Authorization: Bearer $MEMORYFIRST_API_KEY") ollama run llama3.1 --system "$CONTEXT"
Claude Codeでは、起動時のコンテキスト取得と、終了時のセッションのイベントへの要約がすでに自動化されています。パッケージ: @memoryfirst/claude-hooks.
ツール
リモートでもローカルでも同じものです。両者の一致はテストで確認しています。
mf_recall· プロジェクトの意思決定、ブロッカー、デプロイ、現在有効な状態mf_query· 出典付きの自然言語での質問。パーティションやドキュメントの種類で絞り込み可能mf_record· 意思決定、ブロッカー、デプロイ、顧客との接点を記録。あなたのIDとAIで署名されますmf_projects· ワークスペースの記憶にあるプロジェクトを、各プロジェクトのイベント数とともに一覧表示mf_morning· ワークスペースの過去24時間のブリーフ(種類別)mf_skills· 繰り返された質問からコンパイルされたスキルのカタログと、そのSKILL.mdmf_assets· ワークスペースのアセットとプロジェクトの台帳mf_state· プロジェクトの現在有効な状態(履歴ではなく、今も有効なもの)search· ChatGPTコネクタ向けの検索fetch· idを指定して1件のイベント全体を取得(ChatGPTコネクタ向け)
検証可能な出典
すべての mf_query の回答には、引用ごとに spanRef が付きます。ドキュメントではページとボックス、音声ではミリ秒、ブレインではイベントidです。クライアントはそれらを情報源へのリンクとして表示します。
{
"answer": "The contract scope is fixed-fee €4,500.",
"citations": [
{
"sourceType": "doc",
"spanRef": { "page": 3, "bbox": [120, 450, 380, 60] },
"snippet": "Fixed fee of €4,500 for the scope defined..."
},
{
"sourceType": "ops",
"spanRef": { "source": "brain.event:decision_taken:78048c2c-…", "eventId": "chunk:0" },
"snippet": "Decision (Jose, claude-code): fixed fee confirmed with the client on 12 May."
}
]
}詳細なスキーマ、エラーコード、プランごとの上限は、APIリファレンスをご覧ください。足りない情報がありますか?次のアドレスまでご連絡ください: hola [at] memoryfirst.ai.