ポピュレーション・インテリジェンス · MCP

模擬フォーカスグループを、
エージェントが呼び出せるツールに。

AI エージェントは作業の途中で、CrowdOS の MCP サーバー経由で調査を実行します。Free を含むすべてのプランで利用できます。URL を 1 つ追加する、あるいは pip install を 1 回実行するだけです。パネルは国勢調査データから抽出され、互いの意見が食い違います。一つのモデルの意見ではありません。

MODEL CONTEXT PROTOCOL·CLAUDE DESKTOP · CURSOR · CLINE·エージェント呼び出し可能な 15 ツール·PRO・MAX に含む

MCPとは

Claudeがすでに話せるプロトコル

Model Context Protocol（モデル・コンテキスト・プロトコル）は、AI エージェントを外部サービスに接続するために Anthropic が策定したオープン標準です。Claude Desktop、Cursor、Cline、Zed、さらに増え続けるエージェントフレームワーク（LangGraph、CrewAI、AutoGPT、Devin）がネイティブに対応しています。MCP サーバーをホストの設定に追加するだけで、そのツールがモデルのツールピッカーに現れます。グルーコードも、アプリごとの SDK も必要ありません。

CrowdOS は 2 通りの方法で対応しています。API が直接提供するホスト型エンドポイントと、それに中継するデスクトップホスト向けの pip でインストールできる stdio サーバーです。どちらもお使いのアカウントに同じツールを提供し、リクエストの整形、レスポンスの圧縮、エラーのサニタイズを引き受けます。

HOSTS

LangGraph and CrewAI run the agent. CrowdOS is the crowd.

CrowdOS is the crowd an agent should query. LangGraph and CrewAI are hosts: the place the agent runs. Mount the server and the same tools show up in the model's tool picker. AutoGPT and Devin speak the protocol too, the same way Claude Desktop, Cursor and Cline do.

A PROMPT IS NOT A PANEL

An agent role-playing a panel isn't enough

One model acting like N personas (effectively n=1).

An LLM persona is a costume for one prompt. Ours is a database row: census-grounded people with a fixed identity, an opinion history, and a standing news habit. Query that crowd. Do not ask one model to play the panel.

  • 接続

    ホスト型：URLを追加するだけ、インストールは不要

    URL
    https://api.crowdos.ai/mcp

    MCP エンドポイントは API 自身が提供するため、常にプラットフォームと同期しており、更新すべきパッケージはありません。claude.ai（設定 → コネクタ）、Cursor、あるいはリモートサーバーに対応した任意のクライアントに、リモート MCP サーバーとして追加してください。OAuth に対応したクライアントであれば、初回接続時にサインインと同意の手順が案内されます。付与された権限は /account/api-keys に、取り消し可能なキーとして表示されます。ヘッダーを送るタイプのクライアントは、Authorization: Bearer crowd_... と MCP キーを使用します。

  • インストール

    セルフホスト：pipを1回、設定ブロックを1つ

    BASH
    pip install crowdos-mcp

    次に /account/api-keys で MCP キーを作成し（どのプランでも作成できます）、以下を Claude Desktop の設定ファイル（~/Library/Application Support/Claude/claude_desktop_config.json）に貼り付けます。

    JSON
    {
  "mcpServers": {
    "crowdos": {
      "command": "crowdos-mcp",
      "env": {
        "CROWDOS_API_KEY": "crowd_..."
      }
    }
  }
}

    Cursor と Cline も、MCP サーバー設定で同じ JSON 構造を使います。ホストを再起動すると、CrowdOS のツールがエージェントのツールピッカーに現れます。

BY RESEARCH JOB

The same tools, grouped by the question

The list below is every tool the server exposes. These four groups are the research jobs an agent is usually hired for.

  • OPINION

    What do people think?

    run_focus_group is a voting study: a sentiment summary and representative quotes. run_debate is a multi-round debate: convergence and the shift from round to round.

  • CHOICE

    Which option wins?

    compare_options is an A/B/C/D test on text options: a Borda leaderboard and a winner. rank_items is MaxDiff: a rank order with bootstrap rank intervals.

  • PRICING

    What would they pay?

    test_pricing runs a Van Westendorp or Gabor-Granger study: price points and a revenue curve.

  • BUDGET

    What will this study cost?

    preview_cost estimates the cost before the agent commits. It is free to call.

ツール

15個のツール、エージェントのための形

  • run_focus_group全プラン

    センチメント／投票調査——sentiment_summary と代表的な発言

  • run_debate全プラン

    複数ラウンドの模擬ディベート——収束度とラウンドごとの立場の変化

  • compare_options全プラン

    2〜10 個のテキスト選択肢（プラン上限：Free 3・Pro 5・Max 10）による A/B/C/D テスト——ボルダ順位表と勝者

  • test_pricingPRO + MAX

    Van Westendorp / Gabor-Granger による価格調査——価格帯と収益カーブ

  • rank_itemsPRO + MAX

    4〜200 項目の MaxDiff——ブートストラップ順位区間つきのランキング

  • pretest_questionsエンタープライズ

    調査票草案 1〜40 問の事前テスト——実査の前に設問ごとの判定を返す

  • estimate_reach全プラン

    custom_audience フィルタが示すオーディエンスの広さをプレビュー——無料

  • preview_cost全プラン

    実行を確定する前に費用と所要時間を見積もる——エージェントはここで予算を組む

  • list_demographic_presets全プラン

    利用できるオーディエンステンプレートを一覧する

  • get_simulation全プラン

    過去に実行した調査の完全な結果を取得する

  • cancel_simulation全プラン

    実行中の調査を停止し、確保した予算枠を解放する

  • crowd_sample全プラン

    稼働中のエージェント母集団を閲覧する（匿名化済み）

  • list_panelsエンタープライズ

    保存済みパネル（persist_panel / evolve_panel の実行で作成）を新しい順に一覧する — メタデータのみ

  • get_panelエンタープライズ

    保存済みパネル1件の詳細 — 人数、有効期限、属性構成、記録済みセッション（回答者名簿は含まない）

  • delete_panelエンタープライズ

    自分の保存済みパネルを削除する — 即時かつ永久

preview_cost は、多くのエージェントが最も使いこなせていないツールです。パネルが 100 を超える調査の前には必ず呼び出し、費用（セント）と所要時間（秒）の見積もりを確認したうえで、予算に収まるかどうかを判断してください。呼び出しは無料です。

実際の動き

エージェントの実行はこう見える

TEXT
> 週4日勤務を企業に義務づけるべきかについて
   フォーカスグループを実行して。us_general_population から 200 エージェントで。

[tool: preview_cost]   → estimate_cents=400 · ~33-88s
[tool: run_focus_group] → sim ad4b3736…
   sentiment_summary: { positive_pct: 71.5, negative_pct: 18.0,
                        neutral_pct: 10.5 }
   sample_responses: [ Maria Chen "It would be great for ...", ... ]
   billing.actual_cents: 400

母集団が小さくないため、エージェントはまず preview_cost を選び、4.00 ドルなら支払える範囲だと確認したうえで run_focus_group を実行します。圧縮されたレスポンス（センチメント要約 + 代表的な発言 5 件 + 課金情報）はコンテキストに収まります。回答者一人ひとりの理由づけが必要な場合は、get_simulation で完全なペイロードを取得できます。

ACCURACY

The opinion benchmark, published

On the Pew opinion benchmark, the crowd's opinion distribution matches published polling at 93.3% parity, with a mean absolute error of 3.36 percentage points and a Pearson r of 0.984. That published figure is the opinion benchmark. Creative ranking and in-market ad performance are measured separately.

料金

すべてのプランで

MCP は Free を含むすべてのプランでご利用いただけます。調査はウェブアプリと同じ回答者単価でウォレットから差し引かれます。小規模なフォーカスグループで約 0.40 ドルです。

パネルの上限はウェブと同じくプランに従います。Free は最大 20 名、Pro は 500 名、Max は 1,000 名で、リクエストは毎分 5 回・30 回・120 回、月間の MCP 利用上限は $5・$500・$2,500 です。料金 →

run_focus_group と run_debate のレスポンスには必ず billing.actual_cents フィールドが含まれるため、エージェント自身が使用額を集計できます。

フレームワーク

REST API はエンタープライズアカウント向けです

エージェントのホストではなく、自社のコードから CrowdOS を呼び出したい場合は、エンタープライズアカウントで REST API をご利用いただけます。エンタープライズ → LangGraph と CrewAI にはコミュニティ製の MCP ブリッジパッケージがあり、MCP ホストを動かさずに CrowdOS のサーバーをフレームワークのエージェントに組み込めます。

WHERE THIS FITS

The same crowd, in the browser

The MCP server is the way an agent runs a focus group. Pulse is a vote, a debate or a comparison. Screening Room pressure-tests a creative, a concept or a deck before you ship. Ads Labo reads which of two to four ad variants a panel prefers.

FAQ

What is a focus group MCP server?

A focus group MCP server is a Model Context Protocol endpoint an AI agent can call. CrowdOS speaks it two ways: a hosted endpoint the API serves directly, and a pip-installable server for desktop hosts. Both offer the same tools for your account. Claude Desktop, Cursor, Cline, Zed, LangGraph, CrewAI, AutoGPT and Devin speak the protocol. Drop the server into the host's config and its tools show up in the model's tool picker.

Does it work with Claude, Cursor and Cline?

Yes. Claude Desktop, Cursor and Cline speak Model Context Protocol natively. Cursor and Cline use the same JSON shape in their MCP-server settings. Restart the host and the CrowdOS tools appear in the agent's tool picker.

How is CrowdOS different from LangGraph or CrewAI?

CrowdOS is the crowd an agent should query. LangGraph and CrewAI are hosts: the place the agent runs. LangGraph and CrewAI have community MCP-bridge packages that let you mount the CrowdOS server into a framework agent without running an MCP host.

Why not prompt an agent to role-play a panel?

One model acting like N personas (effectively n=1). An LLM persona is a costume for one prompt. Ours is a database row: census-grounded people with a fixed identity, an opinion history, and a standing news habit. Query that crowd. Do not ask one model to play the panel.

How accurate is the crowd an agent queries?

On the Pew opinion benchmark, the crowd's opinion distribution matches published polling at 93.3% parity, with a mean absolute error of 3.36 percentage points and a Pearson r of 0.984. That is the published opinion benchmark. The full ledger is on the benchmarks page. Creative ranking and in-market ad performance are measured separately.

MCP キーは 30 秒で手に入ります。

無料で登録 →ログイン済みですか？キーを管理 →