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

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

50headsを対応するAIアシスタントに接続すると、アシスタントが確認済みの人に質問し、結果を受け取れます。1回答20クレジットからです。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

50headsが使える場所

どの方法でも、AIアシスタントが使えるツールは同じです。アシスタントが対応している方法を使ってください。

ホスト型サーバー
https://mcp.50heads.com/mcp 今すぐ使えます。インストールは不要です。アドレスを追加してログインしてください。
npmパッケージ
npx -y @50heads/mcp 今すぐ使えます。ローカルのコマンドを起動するアシスタント向けです。Node 20以降とAPIキーが必要です。
公式MCPレジストリ
com.50heads/mcp 今すぐ使えます。レジストリを読み込むアシスタントやディレクトリから50headsを見つけられます。
ディレクトリ
Claude、ChatGPT、Cursorの各ディレクトリと、Smithery、Glama、PulseMCP、mcp.soに近日掲載予定です。それまでは、ホスト型サーバーをご自身で追加してください。

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

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

> estimate({ action: "quote", question: { 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

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

> results({ action: "get", question_id: "q_8k2f" })   # or action "wait" on older hosts
  complete · winner "Menu B" · margin 36 points · confidence high

実行か見送りかを判断する

はい・いいえの質問にライン(例:「はい」が60%超)を設定すると、範囲付きの判断が返ります。判断は実行、見送り、判断保留のいずれかです。ラインの設定に追加料金はかかりません。

利用できるツール

estimate
質問の料金、所要時間、入力の検証。クレジットは減りません。
ask
質問を投稿します。冪等性キーが必要です。同じキーで再試行しても、2つ目の質問や2回目の請求は発生しません。
results
ここまでの結果、個別の回答、ファイル、最近の質問。エージェントが再度質問する前に既存の結果を再利用できます。回答が集まるまで当社側で待つこともできます。
questions
公開中の質問を止めて未回答の分を返金し、回答を追加し、不適切な回答を報告し、質問を整理します。
projects
質問を見つけやすくするプロジェクトとラベル。
webhooks
Webhookのエンドポイント、その配信、最近のイベント。スクリプトが何度も確認する必要はありません。
organization
読み取り専用:組織、そのドメイン、SCIM、サービスアカウント、SlackとZapierの接続。
audit
読み取り専用:組織の監査ログを一覧またはエクスポートで返します。
help
ヘルプセンターを検索し、サポートにフィードバックを送ります。

無人で使うときの制限

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

あなたのデータはAIの学習に使いません

あなたの質問、購入した回答、回答者が書いた理由を、AIモデルの学習に使うことはありません。販売することもありません。 AIとあなたのデータ

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"

Zapierから50headsを使う

コードは不要です。Zapierでは、質問する、回答者を追加する、取り消す、ゴー/ノーゴーの判定つきで結果を取得する、といった操作ができます。質問が終わったときにZapを動かすこともできます。ZapierはほかのアプリとおなじくOAuthで接続し、スコープも1日の上限も同じです。

開発者ドキュメントのZapierの項

AIアシスタントから、確認済みの人に質問できます。

キーボードショートカット

どのページでも ? キーを押すと、この一覧が表示されます。入力欄に入力している間は、使えません。

全般

キーボードショートカットを表示
?
ヘルプを検索
/
質問する
n
メニューを閉じる
Esc

移動

ホーム
g次にh
料金
g次にp
使い方
g次にw
確認の仕組み
g次にv
AIエージェント向け
g次にa
チーム向け
g次にt
稼ぐ
g次にe
ブログ
g次にb
APIドキュメント
g次にd
アカウント
g次にo