Blue Synergy Cortex

ほとんどのメモリシステムはすべてを流動的なベクトルの寄せ集めとして扱うため、エージェントが幻覚を起こしたり、厳密な技術要件を忘れたり、ユーザーの好みをコード仕様と混同したりします。

Blue Synergy Cortex は、トランザクション対応の PostgreSQL とエンタープライズ向けナレッジグラフアーキテクチャを基盤とする、エンタープライズグレードのトライストリームアーキテクチャを実装しています。

1. ユーザーストリーム： 会話の習慣やユーザーの好みを時間とともに一般化します。
2. アイデンティティストリーム： 迎合を防ぐ、決定論的なガードレールと行動の公理です。
3. ナレッジストリーム（生きた仕様）： 正式なユニバーサルドメインオントロジーに整理された、正確なアーキテクチャ仕様、ハードウェアの制限、システムパラメーターです。このストリームは、情報を損なう圧縮、意味の劣化、意図しないドリフトから保護されています。

---

クイックスタート（1分でセットアップ）

API キーが必要です： Blue Synergy Cortex は、ホスト型の完全な認知クラウドエンジンです。メンテナンスは不要です。クライアントを接続するには、有効な API キーが必要です。

🔑 21日間の無料トライアルキーはこちら
(すぐに有効化でき、クレジットカードは不要です。500個のグラフノードと最大3つのエージェントが含まれます。)

---

ステップ 1：API キーを取得する

1. cortex.bluesynergy.io にアクセスし、トライアルキーを生成します。
2. キーは次のような形式です：ctx_live_xxxxxxxxxxxxxxxxxxxxxx

---

ステップ 2：AI エージェントを接続する

A. Cursor IDE との連携

1. Cursor Settings（Ctrl+Shift+J または Cmd+Shift+J）を開きます。
2. Features -> MCP Servers -> Add new MCP server の順に移動します。
3. 次のように設定します：
   • Name： cortex-memory
   • Type： sse
   • URL： https://cortex.bluesynergy.io/v1/mcp/sse?api_key=YOUR_API_KEY
4. 保存します。これで Cursor Composer と Agent が、再起動後も永続的に情報を想起できるようになります！

---

B. Claude Desktop との連携

設定ファイルを編集します：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

Cortex のリモート設定を追加します（Claude Desktop）：

{
  "mcpServers": {
    "cortex": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cortex.bluesynergy.io/v1/mcp/sse",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Claude Desktop を再起動します

💡 重要：Claude Desktop でメッセージが折りたたまれたり空になったりするのを防ぐ
Claude Desktop では、同じターン内でアシスタントが MCP ツールを呼び出す前にテキストを書くと、デスクトップ UI がそのテキストをツールのアコーディオンに自動的に折りたたみ、ユーザーには応答が空、または途中で切れているように表示されます。

UI に確実にきれいに表示し、メモリへの取り込みを継続させるには、Claude Desktop の設定（Settings ➡️ Profile / Custom Instructions）に次のルールをそのまま追加してください：

[CORTEX MEMORY PROTOCOL]
1. Inhale: Call `cortex_recall` before answering whenever historical or project context is needed.
2. Exhale (UI-Safe): Do NOT write conversational text before calling `cortex_ingest_turn`. Always execute the `cortex_ingest_turn` tool call first (passing both the user's prompt and your planned answer).
3. Response: Generate your full substantive answer to the user immediately after the tool completes. This ensures your response displays cleanly in the UI without being collapsed into tool artifacts.

---

C. その他の MCP クライアント（Windsurf、VS Code Cline、Roo Code、Zed、Cursor）

ツールの MCP 設定で SSE エンドポイントを直接使用します。

{
  "mcpServers": {
    "cortex": {
      "url": "https://cortex.bluesynergy.io/v1/mcp/sse?api_key=ctx_live_..."
    }
  }
}

---

D. カスタムエージェントと REST API（LangChain、CrewAI、AutoGen、OpenAI Custom GPTs、LlamaIndex、n8n）

65 ミリ秒未満の REST エンドポイントを利用して、Cortex をカスタムパイプラインに直接統合します。

• インタラクティブ API ドキュメント（Swagger UI）： https://cortex.bluesynergy.io/docs
• OpenAPI スキーマ： https://cortex.bluesynergy.io/openapi.json

例：コンテキストのクエリ（cURL）

curl -X POST https://cortex.bluesynergy.io/v1/recall \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "System database requirements",
    "user_id": "developer",
    "agent_id": "backend_agent"
  }'

---

利用可能な MCP ツールとライフサイクルアーキテクチャ

Cortex は受動的なキー・バリューストアではありません。厳格なガバナンス境界を備えた、能動的な認知オペレーティングシステムです。各ツールをいつ、なぜ呼び出すべきかを理解することで、高精度なメモリ統合を実現できます。

---

標準的なエージェントのターンサイクル

すべてのユーザーターンで、エージェントは次の基本ループに従う必要があります。

1. ターン開始時： cortex_recall を呼び出して、信頼できるコンテキスト（ユーザープロフィール＋アクティブなプロジェクト仕様＋グラフの関係）を取得します。
2. 応答の生成： 取得したメモリに基づいて回答を作成します。
3. ターン終了時： cortex_ingest_turn を呼び出して、そのターンを非同期取り込みバッファーに送信します。

---

ツールの詳細リファレンス

ツール名	種類	呼び出すタイミング	システムの動作
cortex_recall	query (string) compact (bool, optional)	ユーザーに回答する前（コンテキストを完全に把握するため必須）。	65 ミリ秒未満のハイブリッドベクトル検索とトポロジカルグラフ検索を実行します。検証済みのユーザー特性、アクティブなプロジェクト仕様、エンティティ間のグラフ情報を挿入します。compact: true に設定すると、プロフィールの前置きを除外し、関連性の高い情報のみを返します（CLI／Claude Code での使用を推奨）。
cortex_ingest_turn	取り込み	すべての会話ターンに回答した直後。エージェントの行動の蒸留とユーザーの経歴生成に不可欠です。	会話ターン全体を非同期で取り込みます。Memory Firewall が対話のノイズをフィルタリングし、コミュニケーションの好みを学習し、技術的な情報をスケジュールされた統合に向けて準備します。
cortex_create_project	プロビジョニング	ユーザーが新しいプロジェクトのスコープを宣言、初期化、または承認したとき。	新しい正規の project_id を明示的に登録し、認可します。プロジェクトのベースラインを作成し、以降のメモリ書き込みが general にフォールバックしないようにして、関連するステージング済みのメモを general プールから自動的に取り込みます。
cortex_store_memory	書き込み	KNOWLEDGE ストリームに確実に保存する必要がある明示的なシステム制約、ビジネスルール、技術的決定の場合。	選別された永続的な書き込みを行います。安全ゲート： project_id がまだユーザーによって認可されていない場合、プロジェクトの汚染を防ぐため、情報は general メモリプール（general）に安全にステージングされます。
cortex_get_project_spec	検査	プロジェクトの完全な生きた正規仕様が必要なとき。	プロジェクトの検証済みで統合された仕様（Living Document）を確定的に取得します。注： 返されるのは認可済みで統合された仕様のみであり、整理されていないスクラッチパッドのメモは返されません。
cortex_manage_draft	ガバナンス	新しい製品またはドメインが提案され、ユーザーによる明示的な認可を待っているとき。	隔離されたプロジェクトの下書き（draft_*）を承認して本番環境のアクティブな仕様にするか、却下されたコンセプトを完全に削除します。ステージング済みの情報を general から専用のプロジェクトスコープに昇格します。
cortex_triage_general	メンテナンス	非構造化ステージングプール（general）に複数のプロジェクトに関するメモが蓄積したとき。	セマンティッククラスタリングエンジンが general のメモを整理し、対応するプロジェクトと関連付けて、ワークスペースの圧縮を実行します。

---

プロジェクトのガバナンスとライフサイクル

メモリの断片化と無許可のプロジェクトの乱立を防ぐため、Cortex は厳格なガバナンス境界を設けてメモリを管理します。

[Incoming Note / Message]
           │
           ▼
   Is Project Authorized?
        ├── NO  ──► Staged in General Pool ('general')
        │                 │
        │                 ▼
        │          Awaits Triage via `cortex_triage_general`
        │          (or explicitly authorized via `cortex_create_project`)
        │                 │
        └── YES ◄─────────┘
           │
           ▼
[Asynchronous Consolidation Cycle]
           │
           ▼
[Active Living Specification & Knowledge Topology]

---

ノートを保存したのに project_spec が空なのはなぜですか？

Cortex は人間が介在するポリシーを適用しています。project_id がユーザーによって明示的に承認されていない場合、アクティブなワークスペースが汚染されないよう、受信した情報は一般メモリプールに安全に一時保存されます。 プロジェクトが承認されると（cortex_manage_draft または明示的な作成によって）、夜間の統合エンジンが一時保存されたノートを公式の Living Specification（cortex_get_project_spec）に自動的に統合します。

---

User Biography が空なのはなぜですか？（「指示に従わない」エージェントの修正方法）

プロジェクト仕様は機能しているのに、User Biography または Agent Persona が空のままの場合、AI エージェントが応答後に必要な「息継ぎ」ステップ（cortex_ingest_turn）を省略しています。

この問題が発生する理由：
LLM（Claude、GPT など）は、ユーザーへの応答の作成を終えると、リモート MCP のプロンプト指示を低い優先度で扱います。エージェントが cortex_ingest_turn を省略すると、対話のターンが取り込みバッファーに届かず、認知ルーターとメモリファイアウォールがユーザーの習慣を抽出するために必要なデータを得られなくなります。

解決方法：
クライアント／システムプロンプトのレベルでこのルールを適用してください（たとえば、システムプロンプト、Cursor Rules .cursorrules、または Claude Desktop Custom Instructions に記載します）。クライアントのネイティブプロンプトに組み込んだ指示は、MCP ツールのヘッダーだけの場合よりも遵守率が 10 倍高くなります。

---

コアアーキテクチャの特長

• 65 ミリ秒未満の LLM 不使用の検索： 高性能なベクトル検索とトポロジカルグラフ照合を直接実行し、低速で非決定的なランタイム LLM キーワード抽出器を完全に迂回します。
• デュアルゾーンの高速追記： 未加工の事実をインボックスの一時保存ゾーンに即座に記録し（20 ミリ秒未満）、その後、スケジュールされた非同期統合によって不変の統一された Living Specification にまとめます。
• セマンティック不変条件ガード： 事実の密度と連続性を強制するアルゴリズム検証ゲートです。再インデックス時に重要なパラメーターが切り詰められたり失われたりするのを数学的に防止します。
• 免疫シールド： 運用エラー、ツールのクラッシュ、一時的な幻覚、会話中の謝罪を設計上フィルタリングし、長期メモリに保存しません。

---

サポートとフィードバック

問題が発生した場合や、機能の提案がある場合はお知らせください。

• バグ報告と問題： Issue を作成
• ステータスとポータル： cortex.bluesynergy.io
• 理論と運用の詳細な解説については、Engineering Whitepaper (ARCHITECTURE.md) をご覧ください。