2026年5月 · 読了時間 7 分 · Fran Olivares、OlivaresAI 創業者
@olivaresai/alma-mcp をサーバーとしてインストールし、Alma API キーと共に MCP クライアント設定(Claude Desktop、Cursor、Windsurf、Claude Code、または他の互換クライアント)に単一の JSON ブロックを貼り付け、再起動してください。サーバーは AI が自律的に呼び出せる 35 のメモリーツールを公開します: メモリーを保存、メモリーを検索、コンテキストを構築、事実を抽出、Soul ブロックを設定。合計セットアップ時間は約 5 分で、すべての有料 Alma プランで動作します。Model Context Protocol(MCP)は、AI クライアントが外部ツールやデータソースと通信できるようにするオープン標準です。クライアントが MCP を話すようになれば、メモリーサーバーを接続でき、AI はあらゆる会話、あらゆるプロジェクト、あらゆる日にわたって永続メモリーストアの読み書きツールをすぐに得ます。本ガイドでは、2026 年の最も一般的な 4 つのクライアント向けの 5 分セットアップを解説し、その後に出てくる質問に答えます。
Alma MCP サーバーが接続されると、AI クライアントは、あなたが何もタイプしなくても呼び出せる 35 の新しいツールを得ます。最も重要なもの: alma_remember(事実または好みを保存)、alma_recall(自然言語クエリでメモリーを検索)、alma_assemble_context(すべてのメモリーレイヤーから現在の質問のための構造化コンテキストを構築)、alma_extract(テキストブロックから事実を採掘)、alma_update_block(AI アイデンティティのために Soul Engine ブロックを設定)、エピソード、手順、environments、会話、Web 検索、ファイル生成などのツール。
実際には、ユーザーがメモリー関連のことを尋ねると、AI がこれらのツールを呼び出します。「ESM モジュールを好むことを覚えておいて」→ AI が alma_remember を呼び出します。「新しいサービスにはどのスタックで合意した?」→ AI が alma_recall を呼び出します。ツールのラウンドトリップはサブ秒で、ユーザーはわずかに思慮深い回答を見るだけです。
ステップ 1。 alma.olivares.ai でサインアップしてください。エントリーティアとして Starter プラン($14/month)から始めます。
ステップ 2。 Settings → API Keys で、キーを生成してコピーします。
ステップ 3。 Claude Desktop の設定ファイルを開きます。macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json にあります。
ステップ 4。 mcpServers オブジェクト内に Alma サーバーを追加します: { "alma": { "command": "npx", "args": ["-y", "@olivaresai/alma-mcp"], "env": { "ALMA_API_KEY": "your-key" } } }。mcpServers がまだ存在しない場合は、JSON のトップレベルに作成します。
ステップ 5。 Claude Desktop を再起動します。Alma ツールがスラッシュメニューに表示され、Claude は自律的にそれらを呼び出せます。試してみてください: 「私のお気に入りのエディターは Helix だと覚えておいて」。1 ターン後: 「お気に入りのエディターは何?」 — Claude が想起します。
Cursor の MCP UI は Settings → Features → MCP にあります。名前 alma、コマンド npx、引数 -y @olivaresai/alma-mcp で新しいサーバーを追加し、env 変数 ALMA_API_KEY をキーと共に追加します。保存して Cursor を再起動します。Alma ツールはチャットのツール利用インジケーターに表示され、Composer とインラインチャットの両方がアクセスできます。Cursor のプロジェクトコンテキストと組み合わせると、AI にコードベース認識と 永続的なクロスプロジェクトメモリー の両方が与えられます。
Windsurf は ~/.windsurf/mcp_config.json から MCP 設定を読みます。構造は Claude Desktop を反映: 同じ Alma ブロックを持つ mcpServers オブジェクト。編集後に Windsurf を再起動します。Alma ツールが Cascade に表示され、Windsurf はエージェント的フロー中にそれらを使用できます — 特に AI に過去のセッションから規約を思い出させたい複数ファイルのリファクタリングに役立ちます。
Claude Code(ターミナルネイティブの Claude クライアント)には独自の MCP 設定が ~/.config/claude-code/mcp.json にあります。同じ Alma ブロックを入れます。claude mcp list を実行してサーバーが登録されていることを確認します。接続されると、Claude Code はコーディングセッション中に Alma のツールを使用できます。Alma の environments 機能と組み合わせると特に強力で、各リポジトリが独自のメモリー名前空間を持ちます。正確な JSON については Claude Code 統合ドキュメント を参照してください。
Alma の MCP サーバーは stdio 経由でバニラの MCP を話すので、準拠したクライアントなら何でも動作します。パターンは常に同じです: クライアントは command + args + env の設定ブロックを期待し、サーバーを子プロセスとして実行し、MCP ハンドシェイクを介してツールを検出します。リストにないクライアントで詰まった場合、サーバーログ(env に ALMA_DEBUG=1 を設定)がハンドシェイクが成功したかどうかを教えてくれます。
スタックキャプチャ。 AI に「新しいサービスには Bun + Hono + D1 を使っています」と伝えてください — alma_remember を呼び出します。2 日後の別の会話で: 「/users のルートハンドラーをスキャフォールドして」 — AI はスタックを想起し、慣用的な Bun + Hono コードを生成します。再説明は不要です。
意思決定の記録。 「MVP では Redis をスキップして D1 を直接使うことに決めた」。エージェントはカテゴリー decision と高い重要度で意思決定を保存します。数週間後にアーキテクチャをレビューする際、「なぜ Redis を使わない?」と尋ねると元の意思決定が根拠と共に返ります。
クロスクライアント継続性。 朝に Claude Desktop でメモリーを保存し、午後に Cursor から参照し、夜にターミナルの Claude Code からクエリします。同じ Alma アカウント、同じメモリーストア、すべてのクライアントがすべてを見ます。
はい。Alma の MCP サーバーはリソース(クライアントが購読できる読み取り専用データ)も公開しています: soul、memories、environments、conversations、budget、blocks、episodes、procedures など。MCP リソースを表面化するクライアント(特に Claude Desktop)はこれらをサイドバーに表示し、更新をストリーミングできます。ブラウザを開かずに Claude Desktop の中からメモリーストア全体を閲覧できます。
MCP サーバーは AI が指示することのみを、あなたの API キーでのみ行います — 暗黙のブロードキャストはありません。すべてのメモリー書き込みは Alma アカウントにスコープされ、保存時に暗号化され、オンデマンドでエクスポート可能です。サーバーはあなたのマシン上でローカルに動作します。Alma API 自体以外のサードパーティ経由ではプロキシしません。コスト面: サーバーは無料でインストールでき、Starter プラン($14/mo)は Alma のエントリーティアで、MCP サーバーの実行に必要なすべてを含みます。
サーバーが動作したら、最も大きなレバレッジとなる動きは Soul Engine ブロック(personality、expertise、コミュニケーションスタイル、強いルール)を埋めることです。AI が事実メモリーに加えて一貫したアイデンティティを持つようになります。alma.olivares.ai の Alma Web アプリは Soul エディターを公開しています。完全なパターンについては Soul Engine: 持続する AI パーソナリティ を参照してください。
関連する読み物: AI メモリー用の MCP サーバー · AI に永続メモリーを追加する方法 · AI のための永続メモリー: 2026 年完全ガイド · MCP サーバードキュメント · Claude Code 統合。