Couchloop EQ

CouchLoop EQ - MCP サーバー

より安全で一貫性のある AI 会話を実現する行動ガバナンスレイヤーです。

🌐 ランディングページ • 📦 npm • ⭐ GitHub

---

📖 ガイドを選択

用途	ガイド	説明
💻 開発者	README-DEVELOPER.md	パッケージ検証、セキュリティスキャン、コードレビュー、コンテキストの保持
🧘 ウェルネス	README-WELLNESS.md	ガイド付きセッション、ジャーニー、インサイト、振り返りツール

---

CouchLoop EQ とは？

CouchLoop EQ は、AI アシスタント向けの行動ガバナンスレイヤーです。MCP（Model Context Protocol）を基盤とし、状態を保持する AI セッションを管理しながら、ハルシネーション、一貫性の欠如、安全でない推論パターンを監視します。

CouchLoop EQ を選ぶ理由

パッケージのハルシネーション、安全でないコードの生成、会話中のコンテキスト喪失が起こりうる生の LLM とは異なり、CouchLoop EQ は問題がリリースされる前に検出します。

問題	CouchLoop EQ の解決策
🎭 ハルシネーションしたパッケージ	review(mode: "packages") が、インストール前に偽の npm/PyPI/Maven パッケージを検出します
🔓 安全でないコード	review(mode: "code") が SQLi、XSS、ハードコードされたシークレットを検出します
📉 コードの肥大化	review(mode: "code") が過剰な設計、console.logs、エラー処理の欠落を警告します
🧠 コンテキストの喪失	memory がセッションをまたいでアーキテクチャ上の決定事項やチェックポイントを保存します
📚 非推奨 API	review(mode: "packages") が古いバージョンや破壊的変更について警告します
🔍 粗雑な AI コード	review(mode: "verify") が AI の応答に含まれる、ハルシネーションした API を事前に確認します
🧠 セッションの継続性	危機検出、ジャーニー、セッションメモリを備えた conversation

アーキテクチャ

CouchLoop EQ はモジュール式のパイプラインを使用します。

Request -> Classify -> Policy -> Plan -> Execute -> Compose

• インテント分類器：信頼度に基づくルーティングと複数インテントの検出
• ポリシーエンジン：フォールバックと危機時のオーバーライドを備えた、ヘルス状態を考慮したルーティング
• 実行プランナー：並列処理のための DAG 生成
• ツールレジストリ：ヘルス状態の追跡とサーキットブレーカー
• OpenTelemetry：すべてのステージにわたる分散トレーシング

主な安全機能

行動ガバナンス

• ハルシネーション検出：捏造された事実や裏付けのない主張を監視します
• 一貫性チェック：ターンをまたいだ矛盾や論理的な不整合を特定します
• トーンの監視：感情のエスカレーション、操作、依存を形成する表現を検出します
• 安全ガードレール：有害な助言、臨床的な越権行為、不適切な道徳的説教を防ぎます

セッション管理

• 状態を保持した会話：複数回のやり取りにわたってコンテキストを維持します
• 進捗の追跡：ガイド付きのジャーニーで、ユーザーがどこまで進んだかを記憶します
• 危機の検知：ガイド付きの内省ジャーニーに危機検知機能を統合しています
• メモリーコンテキスト：重要な気づきとチェックポイントを保持します

プライバシー・バイ・デザイン

• 個人データを保存しません：メールアドレス、名前、パスワード、API キーは保存しません
• セッション単位の分離：各セッションは匿名で分離されています
• データはご自身で管理できます：気づきやコンテキストは個人情報ではなく、セッション ID に紐付けられます
• 追跡はありません：アナリティクス、テレメトリー、サードパーティとのデータ共有はありません

クイックスタート

CouchLoop EQ は、あらゆる MCP 対応クライアント（Claude Desktop、ChatGPT、Cursor、Windsurf、VS Code など）で動作する標準的な MCP サーバーです。

オプション 1：ホスト型サーバーに接続する（最も簡単）

本番エンドポイント： https://mcp.couchloop.com/mcp

Claude Desktop（v0.7.0+）の場合、~/Library/Application Support/Claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "couchloop-eq": {
      "url": "https://mcp.couchloop.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Claude を再起動して、次のように試してください：「毎日の振り返りセッションを開始して」

オプション 2：ローカルで実行する

npm install -g couchloop-eq-mcp

Claude Desktop の設定に追加します：

{
  "mcpServers": {
    "couchloop-eq": {
      "command": "couchloop-eq-mcp",
      "env": {
        "COUCHLOOP_SERVER": "https://mcp.couchloop.com"
      }
    }
  }
}

セッションは ~/.couchloop-mcp/identity.json に自動的にローカル保存されます。登録は不要です。

ChatGPT の場合（開発者モード）

ChatGPT は開発者モードで MCP サーバーに対応しています。詳細な設定手順については、CHATGPT_SETUP.md を参照してください。

その他の MCP クライアントの場合

あらゆる MCP 対応クライアント（Cursor、Windsurf、Continue など）から、次の設定で接続できます：

• URL： https://mcp.couchloop.com/mcp
• トランスポート： streamable-http
• 認証： 任意 — デフォルトでは匿名で利用でき、永続的な ID を使用する場合は OAuth を利用できます。認証を参照してください。

本番サーバーを利用できます： https://mcp.couchloop.com/mcp

簡単な手順：

1. ChatGPT の設定で開発者モードを有効にします
2. URL https://mcp.couchloop.com/mcp を指定して MCP コネクターとして追加します
3. セッション単位の分離を使用するため、開始時の認証は不要です

ローカル開発の場合：

• ngrok を使用するか、ご自身のサーバーをデプロイします
• CHATGPT_SETUP.md の設定手順に従ってください

認証

サインアップ、API キー、ログイン画面なしで接続できます。認証はこのデフォルト設定に追加するものであり、利用に必須ではありません。

モード	利用できる内容	方法
匿名（デフォルト）	セッションベースの分離です。各セッションには独自のコンテキストが割り当てられ、ID は収集されません。	接続するだけで利用できます。設定は不要です。
OAuth 2.1	セッション ID の代わりにベアラートークンに紐付けられた、再接続やデバイスをまたいで維持される ID です。	サーバーは動的なクライアント登録、/oauth/authorize、/oauth/token、/oauth/revoke、および /.well-known/oauth-authorization-server メタデータを公開します。OAuth をサポートする MCP クライアント（例：Claude Desktop）は、接続時にこれらを自動的に検出して処理します。
SSO（任意）	OAuth と同じく維持される ID ですが、クライアントの認証情報をそのまま使う代わりに、Google または GitHub のサインインを使用します。管理していないデバイス間で作業を連携する場合に便利です。	FF_SSO_SUPABASE フラグが有効な場合、同意画面に Supabase Auth を利用した「Google/GitHub でサインイン」ボタンが表示されます。

ID は生のメールアドレスや名前ではなく、ハッシュ化されたサブジェクトとして保存されます。Google または GitHub でサインインすると、それぞれのポリシーに従ってプロフィールがそのプロバイダーと共有されますが、CouchLoop EQ に保存されるのはキー付きハッシュと内部ユーザー ID のみです。これは、上記の プライバシー・バイ・デザイン の原則に沿ったものです。

クライアントがベアラートークンを送信しない場合、リクエストは自動的に匿名のセッションベースの分離にフォールバックします。何も壊れることはありませんが、再接続をまたいだ ID の継続性は得られません。

利用可能なツール（4）

CouchLoop EQ の公開ツールは 4 つに集約されています。ツールの前段にルーターツールはありません。各ツールの名前と説明は、MCP クライアントが直接ルーティングできるほど具体的なため、レイテンシーが 1 ホップ分削減され、ルーティングが誤る可能性のある箇所も 1 つ減ります。

ツール	説明
memory	主力ツール - セッションをまたいでコンテキスト、洞察、チェックポイント、意思決定を保存・呼び出します（Supabase を利用）。アクション：save、recall、list
conversation	危機検出機能を備えた、ガイド付きの内省、燃え尽き症候群のチェックイン、ウェルネスに関する会話に加え、ローカルの開発者向けワークフロー（スタンドアップ、レトロ、ポストモーテム）を提供します。アクション：send、start、end、resume、status
review	コードレビュー、パッケージ監査、納品前検証を統合します。モード：code、packages、verify、confirm、apply-fix、dismiss、full
status	ダッシュボード - セッションの進捗、履歴、コンテキストウィンドウの使用状況、保護ステータス、設定

guard は内部ガバナンスツールで、すべての応答時に自動実行されます。ユーザー向けではないため、直接呼び出す必要はありません。

使用例

memory(action: "save", type: "insight", content: "...")   # Save context
memory(action: "recall", content: "auth flow")             # Retrieve saved context
memory(action: "list")                                     # Browse everything saved

conversation(action: "start", message: "Begin daily reflection")
conversation(action: "send", message: "...")

review(mode: "code", content: "function foo() {...}")      # Security/quality analysis
review(mode: "packages", packages: ["lodash-utils"])        # Validate before install
review(mode: "verify", content: "...")                      # Hallucination/fact check

status(section: "session")                                  # Quick dashboard summary

実際の使用状況

CouchLoop EQ は本番環境の開発で実際に使用されています。実際の 2 週間の使用状況は次のとおりです。

使用統計

指標	値
記録された洞察	49
アクティブなセッション	5
固有のタグ	85+
期間	2026 年 1 月 19 日 - 2 月 2 日

追跡対象の開発分野

カテゴリ	インサイト	例
🔐 セキュリティ修正	12	認証フローの強化、バリデーションの改善
💳 決済連携	8	決済フローのパターン、Webhook の処理
📱 モバイル開発	15	状態管理、ナビゲーションガード
🗄️ データベース操作	6	データのクリーンアップ、スキーマの最適化
🏗️ アーキテクチャの意思決定	8	キャッシュ戦略、イベントパターン

注目のインサイト：複雑なバグの解決

PAYMENT FLOW BUG ROOT CAUSE IDENTIFIED:

Issue: Race condition between frontend state and backend data caused
inconsistent user experience during payment retry flows.

Analysis: Traced through 5 components across iOS and backend to find
the state synchronization gap.

FIX OPTIONS:
A) Data cleanup - reset stale records
B) Frontend fix - stricter validation
C) Backend fix - additional verification step

Recommended: Defense-in-depth approach combining A + B

このインサイトはデバッグセッションの途中で記録され、コンテキストウィンドウのリセット後も保持されました。そして、修正を実装する際に3日後に参照されました。

スプリント開発のベストプラクティス

スプリント開始時： コンテキストを確立するためにセッションを作成します

"Create a session for Sprint 42 - user authentication overhaul"

機能の完成後： 複雑さに応じて、インサイト、コンテキスト、またはチェックポイントを保存します

機能の規模	推奨アクション
小規模な修正	memory(action: "save") を insight 型で実行 — 実施した内容と理由を簡潔に記録します
中規模の機能	memory(action: "save") を insight 型と checkpoint 型で実行 — 意思決定と状態を記録します
大規模な機能群	複数回の memory 保存（insight、checkpoint、decision）— アーキテクチャのコンテキスト全体を記録します

重要な理由： 後で振り返ったりデバッグしたりするときに、たとえ数週間後でも、別の AI セッションであっても、直前に構築した内容の正確なコンテキストを取得できます。

memory(action: "recall") -> Instant recall of decisions made
"Resume my Sprint 42 session" -> Pick up exactly where you left off

利用可能なジャーニー

• 日々の振り返り（5分）- その日を振り返るための短いチェックイン
• 感謝の実践（3分）- 感謝していることを3つ見つけて言葉にします
• 週次レビュー（10分）- 1週間を振り返り、意図を設定します

使用例

日々の振り返りを始めます：

"Start a daily reflection session"

前回の続きから再開します：

"Resume my last session"

インサイトを保存します：

"Save this insight: I notice I'm more energized in the mornings"

スクリーンショット

サポート

• Issue：github.com/wisenbergg/couchloop-mcp/issues
• メール：[email protected]

ライセンス

MIT