AI Context Flow

Plurality MCP サーバー

AI エージェントとツールのためのユニバーサルメモリー。コンテキストをどこでも保存、整理、検索できます。

あらゆる MCP 対応 AI クライアントに永続メモリーを提供する、Model Context Protocol サーバーです。ドキュメント、メモ、会話、ファイルを整理されたメモリーバケットに保存し、セマンティック検索できます。OAuth と Personal Access Token（PAT）ベースの認証に対応しています。

使う理由

• Memory Studio — コンテキストをメモリーバケットに整理し、保存したコンテンツを確認して、AI エージェントが把握している情報を管理できる、個人用ナレッジベース兼第二の脳です。
• 重要なチャットを保存 — Claude、ChatGPT、Cursor、その他の AI ツールから、関連するメモリーバケットに直接保存できます。
• すべてのエージェントで共有する永続メモリー — Claude Code、Lovable、Cursor、OpenClaw など、すべてのエージェントが同じコンテキストにアクセスできます。
• セマンティック検索 — キーワードだけでなく、自然言語を使って関連するメモリーを見つけられます。
• バケットを他の人と共有 — 他の人にコンテキストへのアクセス権を付与して、共同作業できます。
• どこでも利用可能 — MCP 対応クライアントなら、どれでも接続できます。

また、どのウェブサイトでもコンテキストを取得して利用できる、AI Context Flow というChrome 拡張機能も提供しています。30 種類以上のモデルに対応したチャットエージェントが組み込まれており、どのページでもサイドバーとして開きます。メモリーと会話したり、保存したコンテキストから質問に答えたり、保存したすべての情報からつながりを見つけたりできます。MCP サーバーを拡張機能と併用すると、製品のすべての機能を利用できます。

▶️ デモを見る

📖 ドキュメント全文 · 🌐 ウェブサイト · 🧩 Chrome 拡張機能 · 🧠 Memory Studio

クイック接続（本番環境）

本番環境の URL：https://app.plurality.network/mcp

サーバーは、OAuth 2.1 with PKCE（対話型クライアント向け）と Personal Access Token（ヘッドレスエージェントおよび CI 向け）に対応しています。ほとんどのクライアントでは、OAuth フローが自動的に処理されます。

Claude Desktop、Claude Code、ChatGPT、Cursor、および MCP 対応クライアントで利用できます。

→ 対応するすべてのクライアントの手順付きセットアップガイド

ツール

認証

MCP サーバーは、次の 2 種類の認証方式に対応しています。

Personal Access Token の使用

1. ダッシュボードにサインインし、MCP 経由で接続 → トークンを管理を開きます
2. トークンを作成をクリックし、名前と任意の有効期限を設定して、plur_pat_… の値をコピーします
3. Bearer トークンとして送信するよう、クライアントを設定します。

Authorization: Bearer plur_pat_...

PAT の利用には有料プランが必要です。有効期限が切れると自動的に無効化され、設定可能な猶予期間（デフォルトは 7 日）を設けてローテーションでき、ダッシュボードから即時に無効化できます。ハッシュ化して保存され、ログに記録されることはありません。

OAuth の詳細

サーバーでは、OAuth2/OIDC プロバイダーとしてOry Hydraを使用します。

アーキテクチャ

MCP Client (Claude Code, Cursor, etc.)
    │
    │  OAuth2 + Streamable HTTP
    ▼
Traefik (:5050)           ← single entrypoint for clients
    ├── /mcp              → MCP Server (:5051)
    ├── /.well-known/*    → API Gateway or Hydra
    ├── /oauth2/*         → Hydra (:4444)
    └── /register         → API Gateway (DCR proxy)
                                │
                                │ Bearer token
                                ▼
                          API Gateway (:5000)
                                │
                                ▼
                          Vector Service (:8000)

Traefik が唯一のエントリーポイントです。OAuth トラフィックを Hydra に、MCP プロトコルトラフィックを MCP サーバーにルーティングします。MCP サーバーは Hydra の JWKS 鍵を使って JWT をローカルで検証し、データアクセスのために Bearer トークンを API Gateway に転送します。API Gateway は認証と DCR のプロキシ処理を行い、ベクトル／検索操作を Vector Service にルーティングします。

ローカル開発環境のセットアップ

前提条件

• Python 3.11+
• uv（Python パッケージマネージャー）
• Docker および Docker Compose
• 稼働中の API Gateway（plurality-backend-api）：認証、OAuth メタデータ、DCR のプロキシ処理、データベースアクセスを担当します
• 稼働中の Vector Service（plurality-ai-service）：セマンティック検索とベクトルデータベース操作を担当します

1. 依存関係をインストール

cd plurality-mcp-server
pip install uv
uv sync

2. 環境を設定

cp .env.example .env

API Gateway が :5000 で稼働している場合は、デフォルト値のままでローカル開発に使用できます。変更は不要です。

HYDRA_ISSUER=http://localhost:5050
MCP_RESOURCE_URL=http://localhost:5050
BACKEND_API_URL=http://localhost:5000

3. Docker サービスを起動（Hydra + Traefik）

cd ory-hydra
docker compose up -d

次のサービスが起動します。

サービスが正常な状態になるまで待ちます：docker compose ps

4. MCP サーバーを起動

uv run uvicorn main:mcp_server --host 0.0.0.0 --port 5051 --reload

ポートは 5050 ではなく 5051です。Traefik は 5050 でリッスンし、/mcp を 5051 上の MCP サーバーにプロキシします。

5. 確認

# Health check (direct)
curl http://localhost:5051/mcp/health

# OAuth metadata (via Traefik)
curl http://localhost:5050/.well-known/oauth-protected-resource

# Traefik dashboard (for debugging routes)
open http://localhost:8080

ローカルクライアントの設定

claude mcp add --transport http plurality-memory http://localhost:5050/mcp

{
  "mcpServers": {
    "plurality-memory": {
      "type": "http",
      "url": "http://localhost:5050/mcp"
    }
  }
}

{
  "mcpServers": {
    "plurality-memory": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:5050/mcp"]
    }
  }
}

npx @modelcontextprotocol/inspector

注： ローカル開発では ChatGPT はサポートされていません。公開アクセス可能な OAuth エンドポイントが必要です。

プロジェクト構成

plurality-mcp-server/
├── main.py                             # Entry point
├── pyproject.toml                      # Dependencies (managed by uv)
├── .env.example                        # Environment template
├── src/plurality_mcp_server/
│   ├── app.py                          # FastMCP app + middleware stack
│   ├── config.py                       # Env vars, shared HTTP client, context vars
│   ├── auth.py                         # JWT validation via Hydra JWKS + scope check
│   └── tools.py                        # MCP tool definitions (read + write)
└── ory-hydra/
    ├── docker-compose.yml              # Hydra + Traefik + PostgreSQL
    ├── hydra.yml                       # Hydra OAuth2/OIDC config
    ├── traefik.yml                     # Traefik static config
    └── dynamic.yml                     # Traefik routing rules

トラブルシューティング

リンク

• 📖 ドキュメント
• 🌐 ウェブサイト
• 🧩 Chrome 拡張機能
• 🧠 Memory Studio
• 📦 MCP レジストリ
• 🔧 Smithery