Sooveryn

Sooveryn MCP

Sooveryn はホスト型の MCP サーバーです。コードは公開されておらず、このリポジトリにはドキュメントと設定例のみが含まれています。

Claude Code のための、長期記憶と AI チームです。

YouTube でデモを見る（1分） · フランス語版

Sooveryn は、プロジェクトを記憶する AI ペルソナのチームを Claude Code に提供します。パートナーでチームリーダーの Soov は、あなたの決定や仕事の進め方を長期記憶に保存します。セッションをまたいで、また、どのマシンでも、言葉と意味からそれらを見つけ出します。

Soov はチームメイト（セキュリティ担当の Néo、アイデアに異議を唱える Vera、デザイン担当の Iris、SEO 担当の Maria）に相談したり、決定を下す前に彼らに議論させたりします。有料プランでは、独自のペルソナやスキルを作成できます。

• ウェブサイト：https://www.sooveryn.com
• サーバー：https://mcp.sooveryn.com/mcp（ストリーマブル HTTP、ヘッダーに API キーを指定）
• MCP レジストリ（registry.modelcontextprotocol.io）：com.sooveryn/sooveryn
• Claude Code、VS Code、Orca、Pi、およびキーを使ったリモート HTTP サーバーに対応する MCP クライアントで利用できます

はじめに

1. https://www.sooveryn.com/try にアクセスして、メールアドレスを入力します。パスワードは不要です。
2. メールで届いたコードを確認するか、同じメールに記載されたリンクをクリックします。その時点でアカウントと最初の API キーが作成されます。
3. クライアントを接続します。Claude Code の場合は、ページに表示されるコマンドをプロジェクトのフォルダーからターミナルに貼り付けて実行します。他のクライアントの場合は、以下の設定を使用します。キーはアカウントの代理として動作し、記憶にアクセスします。Git に送られるものには含めないでください。
4. セッションで Soov Init と入力します。エージェントはプロジェクトのルートに sooveryn.md ファイルを書き込み、Git の対象外にしたうえで、CLAUDE.md 内の @sooveryn.md 行を通じて毎回のセッションで読み込みます。以降、各セッションは Soov と、プロジェクトに関する彼の記憶とともに始まります。

後で再度サインインするには、同じページで同じメールアドレスを入力します。コードを使ってサインインできます。API キーのページ（https://www.sooveryn.com/me/keys）でキーを追加作成できます。マシンごとにキーを1つ用意することをおすすめします。

Claude Code と Orca

最も手早い方法は、プロジェクトのフォルダーからターミナルで1つのコマンドを実行することです。サーバーとキーが、そのプロジェクト用の Claude Code 設定に保存され、プロジェクト内には何も書き込まれません。

claude mcp add --transport http sooveryn https://mcp.sooveryn.com/mcp --header "Authorization: Bearer <YOUR-API-KEY>"

キーを含めずに設定をプロジェクト内に置くには、SOOVERYN_API_KEY という名前の環境変数にキーを設定し、Claude Code の起動時に読み込まれるようにします（たとえば、シェルのプロファイルに設定します）。次に、プロジェクトのルートに .mcp.json を追加します（例）。Claude Code はファイルの読み込み時に ${SOOVERYN_API_KEY} を置き換えるため、ファイルに秘密情報は含まれません。

{
  "mcpServers": {
    "sooveryn": {
      "type": "http",
      "url": "https://mcp.sooveryn.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SOOVERYN_API_KEY}"
      }
    }
  }
}

Orca は Claude Code を実行し、Claude Code がこのファイルを読み込みます。

VS Code

.vscode/mcp.json（例）。VS Code は .mcp.json のヘッダーを無視するため、servers キーの下に専用のファイルが必要です。キーの入力は一度だけ求められ、入力中は非表示になり、安全に保存されます。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sooveryn-key",
      "description": "Sooveryn API key",
      "password": true
    }
  ],
  "servers": {
    "sooveryn": {
      "type": "http",
      "url": "https://mcp.sooveryn.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sooveryn-key}"
      }
    }
  }
}

Pi

MCP 拡張機能をインストールします。Pi はその後、Claude Code と同じ .mcp.json を読み込みます。

pi install npm:pi-mcp-adapter

Pi が環境変数からキーを取得できない場合は、以下のようにキー自体をファイルに記述してください。

その他の MCP クライアント

設定	値
トランスポート	ストリーマブル HTTP
URL	https://mcp.sooveryn.com/mcp
ヘッダー	Authorization: Bearer <YOUR-API-KEY>
任意のヘッダー	X-Project-Scope: <project-name>

X-Project-Scope がない場合、エージェントは sooveryn.md の指示に従い、各呼び出しでプロジェクト名を渡します。

キーがファイルに書き込まれている場合

ウェブサイトの API キーページでは、キーが書き込まれた次のファイルを取得できます。.gitignore に記載し、Git の対象から除外してください。

.mcp.json
.vscode/mcp.json

一度コミットしたキーは、ファイルを削除した後も履歴に残ります。API キーページでそのキーを失効させ、新しいキーを作成してください。

ツール

ツール	内容
init	「Soov Init」と指示すると、現在のプロジェクトで Sooveryn をセットアップします。
activate	ペルソナの役割、ルール、およびセッションに適したメモリーの一部を読み込みます。
search_memory	ペルソナのメモリーを、単語と意味の両方から検索します。
write_event	起きたことを記録します。
update_semantic	名前付きのファクトシートを作成または更新します。
update_procedural	名前付きの作業ルールを作成または更新します。
write_previous_context	プロジェクトの次のセッションに向けて、短い引き継ぎ情報を残します。
clear_previous_context	引き継ぎ情報が適用されたら、これを消去します。
start_debate	プランと利用枠を確認したうえで、2～4人のペルソナ間のディベートを開始し、従うべきプロトコルを返します。
list_skills	アカウントで利用できるスキル（カタログと自分のスキル）を一覧表示します。
get_skill	スキルの指示を返します。
stats	ペルソナのメモリー項目数を数えます。
reindex	ペルソナのメモリーインデックスのキャッシュを再構築します。

メモリーとプライバシー

• メモリーには、起きたこと、既知のこと、作業方法の3種類があります。各プロジェクトにはそれぞれ専用のメモリーがあり、プロジェクト間で共有される一般メモリーは Pro で利用できます。
• メモリーには、ペルソナが書き込んだ内容が保存されます。ウェブサイトですべてを確認でき、どのプランでも、リクエストすればデータのコピーを入手できます。
• メモリーの内容は、アカウントごとのキーでデータベース内に暗号化され、そのキー自体もデータベース外に保管されたマスターキーで保護されています。サーバーはマスターキーを保持しているため、Sooveryn はサービスを提供するために技術的にはメモリーを復号できます。この暗号化は主に、データベースやそのバックアップの盗難、漏えいから保護するためのものです。エンドツーエンド暗号化ではありません。
• サービスで並べ替えやフィルタリングができるよう、一部の情報は暗号化されずに保存されます。これには、識別子、各メモリーのペルソナと種類、プロジェクト名、カウンターと日付、アカウントデータ、および作成したペルソナとスキルが含まれます。
• サーバーはフランスにあります。ペルソナを有効にすると、メモリーの関連部分が AI クライアントに送られ、そこから AI プロバイダーに送信されます。統合オプション（Pro）を利用すると、統合案を作成するため、メモリーの抜粋が米国の Anthropic に送信されます。
• 詳細：プライバシーポリシーおよび利用規約。

知っておくとよいこと

• メモリーに書き込まれた内容は、後のセッションで再び使われます。エージェントが信頼できないソース（ウェブページ、イシュー、ファイル）からコピーしたテキストは、後のセッションに影響を与える可能性があります。ときどきウェブサイトでメモリーを確認してください。
• プロジェクトのルートに .incognito ファイルを置くと、そのセッション中のメモリーへの書き込みが停止します。これを適用するのはエージェントであり、サーバーはファイルを認識しません。

プラン

Free：ディベートも含め、1つのプロジェクトでチーム全体を利用できます。ただし、呼び出し、メモリーへの書き込み、ディベートには1日あたりの上限があります。有料プランでは独自のペルソナとスキルが追加され、Pro では一般メモリーとメモリーの統合を利用できます。料金と詳細：https://www.sooveryn.com/#pricing。

サポートとセキュリティ

• サポート：[email protected]
• 脆弱性の報告については、SECURITY.mdを参照してください。公開イシューで報告しないでください。
• ドキュメントの誤りについて、このリポジトリでイシューを作成できます。ただし、このページは公開されているため、キー、設定ファイル、メモリーを貼り付けないでください。

ライセンス

このリポジトリのドキュメントとサンプルには、MIT ライセンスが適用されます。Sooveryn のサービス、コード、名称、ロゴには適用されません。

Sooveryn は、フランスの Cyril Pierron EI が PANDAPROG の名称で公開しています。法的通知：https://www.sooveryn.com/legal。