Crosmos

crosmos MCP

会話をまたいで引き継がれるメモリを AI アシスタントに提供します。

crosmos は Codex、Claude、Cursor などの MCP 対応クライアントに接続します。アシスタントは役立つ事実、好み、決定事項を保存し、それらが関連するときに呼び出せるようになります。

クイックスタート

始める前に、Node.js 18 以降をインストールし、crosmos コンソールで API キーを作成してください。

ガイド付きセットアップを実行します。

npx @crosmos/crosmos-mcp setup

セットアップアシスタントでは、次の操作を行います。

1. crosmos アカウントを認証します。
2. デフォルトのメモリスペースを選択できます。
3. 対応する AI クライアントを検出して設定します。
4. 対応するエージェントに crosmos スキルをインストールします。

グローバルなパッケージのインストールは不要です。セットアップ後に AI クライアントを再起動し、何かを記憶するよう依頼してください。

ガイド付きセットアップは、Codex、Claude Desktop、Claude Code、Cursor、opencode、VS Code、Windsurf、Cline、Roo-Cline、Zed、Kimi CLI に対応しています。クライアントが検出されない場合は、以下の手動セットアップを使用してください。

動作を確認する

クライアントを再起動した後、新しい会話を開始して、次のように伝えてください。

Remember that my favorite editor is Neovim.

次に、次のように尋ねてください。

What is my favorite editor?

新しいメモリが利用可能になるまで、少し時間がかかる場合があります。最初の呼び出しで見つからなかった場合は、少し待ってからもう一度尋ねてください。

crosmos の使用方法

接続したら、自然な言葉で操作できます。

Remember that we chose PostgreSQL for the analytics service.

What did we decide about the analytics database?

Use the Product Team space for this conversation.

インストールされたスキルは、永続化すべきコンテキストを保存するタイミングと、それを呼び出すタイミングをエージェントに教えます。コンテキストを分けておきたいときは、いつでもスペースを切り替えるよう依頼することもできます。

メモリの保存先を選択する

スペースを使うと、異なる人、プロジェクト、エージェントのメモリを分けて管理できます。セットアップアシスタントでデフォルトを選択でき、名前または ID を指定していつでも変更できます。

npx @crosmos/crosmos-mcp spaces list
npx @crosmos/crosmos-mcp spaces current
npx @crosmos/crosmos-mcp spaces use "Product Team"
npx @crosmos/crosmos-mcp spaces use 019dc652-2714-76d3-ab4b-1b0d077019b5

選択したスペースは、今後のメモリ操作のデフォルトになります。実行中の MCP クライアントには、スペースの変更が自動的に反映されます。

手動セットアップ

ガイド付きセットアップをおすすめします。クライアントを自分で設定したい場合、または自動検出で見つからない場合にのみ、以下の手順を使用してください。

1. 認証する

npx @crosmos/crosmos-mcp auth login

認証情報はローカルの ~/.crosmos/credentials.json に保存されます。管理された環境では、代わりに CROSMOS_API_KEY で API キーを指定してください。

export CROSMOS_API_KEY=csk_your_api_key_here

カスタムデプロイでは、CROSMOS_API_BASE_URL も設定できます。

2. MCP サーバーを追加する

codex mcp add crosmos -- npx -y @crosmos/crosmos-mcp

claude mcp add crosmos -- npx -y @crosmos/crosmos-mcp

kimi mcp add --transport stdio crosmos -- npx -y @crosmos/crosmos-mcp

{
  "mcpServers": {
    "crosmos": {
      "command": "npx",
      "args": ["-y", "@crosmos/crosmos-mcp"]
    }
  }
}

{
  "servers": {
    "crosmos": {
      "command": "npx",
      "args": ["-y", "@crosmos/crosmos-mcp"]
    }
  }
}

{
  "mcp": {
    "crosmos": {
      "type": "local",
      "command": ["npx", "-y", "@crosmos/crosmos-mcp"]
    }
  }
}

ガイド付きセットアップでは、Cline、Roo-Cline、Zed など、その他の対応するローカルクライアントも検出されます。

3. エージェントスキルをインストールする

スキルは任意ですが、永続メモリを使用するタイミングと方法をエージェントに教えるため、インストールをおすすめします。

npx @crosmos/crosmos-mcp skill install codex

codex を使用するクライアントに置き換えてください。対応する値は codex、claude-code、opencode、cursor、windsurf、vscode、kimi-cli です。

MCP またはスキルの設定を変更した後は、クライアントを再起動してください。

よく使うコマンド

以下のコマンドはすべて、グローバルインストールなしで実行できます。

トラブルシューティング

クライアントに crosmos が表示されない

クライアントを再起動し、MCP サーバーの一覧を確認してください。登録名が crosmos であり、 コマンドが npx -y @crosmos/crosmos-mcp であることを確認してください。

古いインストールでは、crosmos-memory として登録されている場合があります。現在のサーバーを追加する前に、 古いエントリーを削除してください。

認証に失敗する

保存されている認証状態を確認してください。

npx @crosmos/crosmos-mcp auth status

必要に応じて、npx @crosmos/crosmos-mcp auth login で再度サインインし、API キーが crosmos コンソールで有効になっていることを確認してください。

メモリが間違ったスペースに保存される

現在のデフォルトを確認してください。

npx @crosmos/crosmos-mcp spaces current

npx @crosmos/crosmos-mcp spaces list を使って利用可能なスペースを確認し、spaces use で選択してください。

利用可能なスペースがない

crosmos コンソールでスペースを作成し、次を実行してください。

npx @crosmos/crosmos-mcp spaces list

それでも解決しない場合は、クライアント名とエラーメッセージを添えてイシューを報告してください。 API キーは絶対に含めないでください。

ライセンス

MIT