Sovant Claude Code MCP

🚀 sovant - claude - code - mcp

Sovant MCPは、Claude Code用のローカルアダプターで、各リポジトリごとに明示的で管理された長期メモリを可能にします。

🚀 クイックスタート

Sovant MCPはClaude Codeに対するローカルアダプターで、各リポジトリに明示的かつ管理された長期メモリを提供します。

✨ 主な機能

このアダプターができること

• 明示的なメモリのみ：すべてのメモリは意図的なツール呼び出しによって書き込まれ、自動的に捕捉されることはありません。
• 1つのリポジトリ = 1つのメモリスレッド：各Gitリポジトリはデフォルトで単一のSovantスレッドにマッピングされます。
• リポジトリごとにスコープ化：各Gitリポジトリには独自のメモリスレッドがあり、明示的にグローバル検索を行わない限り、メモリはプロジェクト間で漏れることはありません。
• MCPはローカルで実行：このアダプターはClaude Codeと並行してローカルのstdioプロセスとして実行され、HTTPSを介してSovant APIと通信します。
• メモリはSovantクラウドに保存：メモリは永続化され、検索可能であり、Sovantダッシュボードから管理できます。

このアダプターができないこと

• 自動捕捉はありません。バックグラウンドリスナーもありません。受動的なメモリもありません。
• 暗黙的な再呼び出しはありません。コンテキストは明示的に要求されたときにのみ取得されます。
• スコープの拡張はありません。リポジトリスコープの検索はリポジトリスコープのままです。グローバル検索には明示的なオプトインが必要です。

📦 インストール

インストール要件

• Claude Code がインストールされ、正常に動作していること
• Node.js 18以上
• Sovant APIキー（sovant.ai/dashboard/keys で無料で取得できます）

インストール手順

git clone https://github.com/sovant-ai/sovant-claude-code-mcp.git
cd sovant-claude-code-mcp
npm install
npm run build

次に、Claude Codeに登録します：

claude mcp add sovant \
  --transport stdio \
  --env SOVANT_API_KEY=sk_live_your_key_here \
  -- node /absolute/path/to/sovant-claude-code-mcp/dist/index.js

/absolute/path/to/ をあなたのマシン上の実際のパスに置き換えてください。

💻 使用例

基本的な使用法

インストールの確認

Claude Codeを再起動してから、以下を試してみてください：

> "Remember: we use PostgreSQL 16 with JSONB for the main database"

ClaudeはSovantを介してメモリが保存されたことを確認し、短いメモリIDを表示します。次に：

> "What database do we use?"

Sovantはあなたが保存したメモリを再呼び出します。両方が機能すれば、設定は完了です。

高度な使用法

利用可能なツール

デフォルトのプライバシー設定

デフォルトでは、sovant_recall は 開発用メモリ のみを返します — つまり、source:claude - code でタグ付けされたメモリ（つまり、このMCPアダプターを介して保存されたメモリ）です。ダッシュボードのメモリ、CRMレコード、およびスマートキャプチャデータは除外されます。 再呼び出しにすべてのワークスペースメモリを含めるには、include_workspace: true を渡してください。

再呼び出しパラメータ

アンインストール

claude mcp remove sovant

これにより、Claude CodeからMCPの登録が削除されます。Sovantにすでに保存されているメモリは削除されず、Sovantダッシュボード から管理できます。

ヘルプとフィードバック

• 問題報告：github.com/sovant - ai/sovant - claude - code - mcp/issues — ご使用のOS、Nodeバージョン、および claude --version を含めてください。
• ドキュメント：sovant.ai/docs/mcp

📄 ライセンス

このリポジトリ内のMCPアダプターコードはMITライセンスです。 メモリの保存と取得は、Sovantの管理サービス（sovant.ai）によって提供されます。使用は Sovantの利用規約 に従います。