AIアシスタントと開発者向け

AIアシスタントから50headsを使う。

50headsを対応するAIアシスタントに接続すると、アシスタントが実在の人に質問し、結果を受け取れます。設定は約10分、1回答$0.25からです。MCPで動作します。MCPは、アシスタントが外部のツールを使うための標準で、Claude、Cursor、ChatGPT、MCPに対応するあらゆるホストで動きます。

ホストに追加する

Claude

Claudeで、設定、コネクタの順に開き、このURLでカスタムコネクタを追加します。ログインして、1日の上限額を設定します。

https://mcp.50heads.com/mcp

Claude Code

ターミナルで実行します。Claude Codeがブラウザを開くので、ログインして1日の上限額を設定してください。

claude mcp add --transport http 50heads https://mcp.50heads.com/mcp

Cursor

~/.cursor/mcp.jsonに追加し、Cursorから求められたらログインします。

{
  "mcpServers": {
    "50heads": {
      "url": "https://mcp.50heads.com/mcp"
    }
  }
}

ChatGPT

ChatGPTで、設定、アプリとコネクタ、詳細設定の順に開き、開発者モードをオンにします。作成を選び、このURLを貼り付けて、OAuthを選びます。

https://mcp.50heads.com/mcp

VS Code

ワークスペースの.vscode/mcp.jsonに追加するか、MCP: Add Serverを実行します。VS Codeがログインページを開きます。

{
  "servers": {
    "50heads": {
      "type": "http",
      "url": "https://mcp.50heads.com/mcp"
    }
  }
}

Windsurf

ポータルで発行したAPIキーと一緒に、~/.codeium/windsurf/mcp_config.jsonに追加します。

{
  "mcpServers": {
    "50heads": {
      "command": "npx",
      "args": [
        "-y",
        "@50heads/mcp"
      ],
      "env": {
        "FIFTYHEADS_API_KEY": "fh_live_…"
      }
    }
  }
}

その他（npx）

ローカルのコマンドを起動するホスト向けです。Node 20以降と、ポータルで発行するAPIキーが必要です。

FIFTYHEADS_API_KEY=fh_live_… npx -y @50heads/mcp

基本の流れは3ステップです

見積もりは無料で、クレジットは減りません。質問すると、クレジットが確保されます。結果を待つときは、50headsが待機を引き受けるので、アシスタントは何度も確認せず、1回の呼び出しで済みます。

> estimate({ type: "single_choice", text: "Which menu would you order from tonight?",
             options: [{ label: "Menu A" }, { label: "Menu B" }], n: 50, tier: 1 })
  20 credits × 50 = 1000 credits · eta 10 min

> ask({ ...same question, idempotency_key: "4f9c…" })
  task q_8k2f · working · 0 of 50 answered

> get_results("q_8k2f")        # or wait_for_results on older hosts
  complete · winner "Menu B" · margin 36 points · confidence high

利用できるツール

estimate: 質問の料金、所要時間、入力の検証。クレジットは減りません。
ask: 質問を投稿します。冪等性キーが必要です。同じキーで再試行しても、2つ目の質問や2回目の請求は発生しません。
get_results: ここまでの結果を、待たずに返します。
wait_for_results: 質問に回答が集まるまで、当社側で待ちます。クライアントが何度も確認する必要はありません。
list_questions: 最近の質問。エージェントが、再度質問する前に既存の結果を再利用できます。
cancel: 公開中の質問を止め、未回答の分を返金します。
templates: 料金が固定の質問テンプレート。
balance: クレジットの残高と、この接続の1日の上限額の残り。

無人で使うときの制限

接続ごとに、1日の利用上限額があります。変更しない限り、5,000クレジットです。上限を超える質問は、サーバーが受け付けません。
質問には、冪等性キーが必要です。同じキーで再試行しても、2つ目の質問や2回目の請求は発生しません。
質問には、ほかの人の質問と同じコンテンツルールが適用されます。受け付けられなかった質問に、料金はかかりません。
結果から、回答者が誰かは分かりません。

APIを直接呼び出す

MCPサーバーが行うことは、すべて通常のHTTPS呼び出しです。キーはfh_live_で始まり、表示されるのは1回だけです。

curl https://api.50heads.com/v1/billing/estimate \
  -H "Content-Type: application/json" \
  -d '{"draft":{"type":"single_choice","text":"Which menu would you order from tonight?",
       "options":[{"label":"Menu A"},{"label":"Menu B"}],"n":50,"tier":1}}'

curl https://api.50heads.com/v2/questions \
  -H "Authorization: Bearer $FIFTYHEADS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"draft":{"type":"single_choice","text":"Which menu would you order from tonight?",
       "options":[{"label":"Menu A"},{"label":"Menu B"}],"n":50,"tier":1,"language":"en"}}'

curl "https://api.50heads.com/v2/questions/q_8k2f/wait?seconds=25" \
  -H "Authorization: Bearer $FIFTYHEADS_API_KEY"

AIアシスタントから、実在の人に質問できます。

APIドキュメント MCPの設定ウェブフック