Ergora Specialists

Ergora Specialists MCP

Claude Desktop、Claude Code、Cursor、およびあらゆる MCP クライアントで利用できる、17 のビジネス分野の知識スペシャリスト（Sales、Marketing、Paid Ads、Content、Ecommerce、Entrepreneurship、Business Strategy、Community、Creator、Design & UX、Developer、Finance、HR、Leadership、Legal、Local Marketing、PR）をツールとして提供します。

各ツールは、第一線で活躍する実務家、ベストセラー書籍、学術・規制関連の情報源をまとめた厳選ナレッジベースから、要約と出典付きの知見を返します。無料プランでは、匿名の場合は1日5件、メールアドレスを登録すると1日30件まで利用できます。

Ergora では、これら17のスペシャリストをすべて、利用無制限の完全な AI スペシャリストエージェントとして提供しています：https://ergora.app

インストール：リモートサーバー（ダウンロード不要）

サーバー URL：https://ergora-specialists-gateway.contact-c9e.workers.dev/mcp（MCP Streamable HTTP、認証不要）

Claude Code

claude mcp add --transport http ergora-specialists https://ergora-specialists-gateway.contact-c9e.workers.dev/mcp --header "X-Ergora-Email: [email protected]"

Claude Desktop / claude.ai：設定からコネクタを開き、カスタムコネクタを追加を選択して、サーバー URL を貼り付けます。ログインは不要です。Claude に尋ねられたら、1日30件の利用枠を有効にするため、メールアドレスを伝えてください（email 引数としてツールに渡されます）。

Cursor：.cursor/mcp.json：

{
  "mcpServers": {
    "ergora-specialists": {
      "url": "https://ergora-specialists-gateway.contact-c9e.workers.dev/mcp",
      "headers": { "X-Ergora-Email": "[email protected]" }
    }
  }
}

その他の MCP クライアント：Streamable HTTP トランスポートを使用して、この URL に接続します。サーバーはステートレス（POST のみ、JSON 応答）です。オプションの X-Ergora-Email ヘッダーを使うと、1日30件の無料プラン向けに利用者を識別できます。

インストール：ローカル stdio サーバー（npm）

パッケージ：ergora-specialists-mcp（Node 18+）。

Claude Code

claude mcp add ergora-specialists -e [email protected] -- npx -y ergora-specialists-mcp

Claude Desktop / Cursor：claude_desktop_config.json / .cursor/mcp.json：

{
  "mcpServers": {
    "ergora-specialists": {
      "command": "npx",
      "args": ["-y", "ergora-specialists-mcp"],
      "env": { "ERGORA_EMAIL": "[email protected]" }
    }
  }
}

ソースから実行する場合：git clone https://github.com/ergoracloud/ergora-specialists && cd ergora-specialists/mcp && npm install を実行し、command に node /absolute/path/to/mcp/index.js を指定します。

ツール

• ergora_sales、ergora_marketing、ergora_ads、ergora_content、ergora_ecommerce、ergora_entrepreneurship、ergora_business_strategy、ergora_community、ergora_creator、ergora_design、ergora_developer、ergora_finance、ergora_hr、ergora_leadership、ergora_legal、ergora_local、ergora_pr：各スペシャリストに対応するツールです。入力：{ query, top_k?, email?, subscribe? }。
• ergora_ask：複数の分野を横断します（vertical を指定できます）。
• ergora_list_specialists：利用可能なスペシャリストを確認できます。

無料プラン

メールアドレスがアクセスキーとなり、1日30件まで利用できます。X-Ergora-Email ヘッダー（リモート）、ERGORA_EMAIL（ローカル）、またはツールの email 引数に指定してください。メールアドレスを指定しない場合、IP アドレスごとに1日5件までに制限されます。公正な利用のため、ネットワークごとに1分あたり約30件までです。これを超えると 429 が返されます。MCP バッチは5メッセージまでです。

無料プランの公平性を保つため、同じメールボックスは1件として数えます（大文字・小文字、+tags、Gmail のドットは区別されません）。1つのネットワークで1日に使用できる未確認メールアドレスは最大3件で、同じネットワークからの未確認リクエストには共通の1日あたり上限が適用されます。確認済みメールアドレスには、これらのネットワークごとの上限は適用されません。Claude など、送信元 IP アドレスを共有するホスト型クライアントでは、匿名利用枠は少なく、未確認メールアドレスでの利用は1日10件までです。

サービス全体にも共通の1日あたり上限（1日2,500件）があり、その一部は確認済みメールアドレスとホスト型クライアント用に確保されています。この上限に達すると、次の UTC 日になるまで、すべての利用者に「明日（00:00 UTC）にもう一度お試しください（または Ergora をご利用ください）」という明確なメッセージが表示されます。

メールアドレスの確認は任意です。数日間にわたってメールアドレスを使い、数件のクエリを実行した後（または subscribe: true を指定した場合はすぐに）、確認をお願いするメッセージを1通お送りすることがあります。Ergora のメーリングリストに追加されるのは、確認済みのメールアドレスのみです（不定期のお知らせを配信します。いつでも登録解除できます）。未確認のメールアドレスは利用枠の管理にのみ使用し、60日後に削除します。第三者と共有することはありません。

ゲートウェイは CORS ヘッダーを送信しません。ブラウザーの JavaScript からではなく、サーバー、MCP クライアント、または stdio パッケージから呼び出してください。

動作の仕組み

クエリは Cloudflare Worker ゲートウェイに送られます。ゲートウェイは Workers AI（bge-small-en-v1.5）で質問を埋め込み、Ergora ナレッジベースの分離されたベクトルストアを検索します（Ergora の本番顧客データベースは決して使用しません）。レビュー済みの許可リストにソースが含まれている、承認済みのエントリーのみが返されます。結果は元のソースへのリンク付きの要約で、原文をそのまま再現することはありません。ベクトル検索が利用できない場合、または予算を超過した場合、ゲートウェイは同じエントリーのキーワードインデックスから回答し、その旨を伝えます。

アーキテクチャ（このリポジトリ）

• worker/：Workers Free プランで動作するように構築された Cloudflare Worker（TypeScript）。
  • /mcp リモート MCP エンドポイント、POST /query JSON API、/health と /health/deep、/confirm メール確認。
  • セマンティック検索用の Vectorize ergora-kb-v2（384d）、キーワード検索へのフォールバック用の D1 ergora-kb-fts（FTS5）、クエリの埋め込み用の Workers AI。
  • SQLite Durable Object（Gate）で、クォータ、24 時間のレスポンスキャッシュ、アラートフラグ、保留中のメール確認を管理します。
  • PUBLIC_BASE_URL は確認リンクに使用する公開オリジンを設定します（空の場合はリクエストのオリジン）。そのため、カスタムドメインの設定に必要なのは変数の変更だけです。
  • npm run check で型チェック、Lint、テスト、ドライランのバンドルを実行します。npm run deploy でデプロイします（最初に事前チェックを実施してください）。詳しくは docs/RUNBOOK_v2.md を参照してください。
• sync/：週次の KB 同期（kb_v2_sync.py。Ergora のバックグラウンドサーバーで実行）：承認済みの行を読み込み、共通のソースポリシーを適用し、Worker と同じモデルで埋め込みを生成して、適格でなくなったエントリーを削除します。eval_models.py は実際の KB を使って埋め込みモデルを比較します。
• shared/source_policy.json：Worker と同期処理の両方で使用するソース許可リスト。
• mcp/：ローカル stdio MCP サーバー（/query の薄いクライアント）。node e2e-test.mjs（stdio）と node e2e-remote-test.mjs（リモート）は、稼働中のゲートウェイに対するエンドツーエンドチェックです。
• docs/COSTS.md：Free プランの制限に関する計算と、Free と Paid の比較。

MIT。詳しくは LICENSE をご覧ください。