AIアシスタントから50headsを使う。
50headsを対応するAIアシスタントに接続すると、アシスタントが確認済みの人に質問し、結果を受け取れます。1回答20クレジットからです。MCPで動作します。MCPは、アシスタントが外部のツールを使うための標準で、Claude、Cursor、ChatGPT、MCPに対応するあらゆるホストで動きます。
ホストに追加する
Claude
Claudeで、設定、コネクタの順に開き、このURLでカスタムコネクタを追加します。ログインして、1日の上限額を設定します。
https://mcp.50heads.com/mcpClaude Code
ターミナルで実行します。Claude Codeがブラウザを開くので、ログインして1日の上限額を設定してください。
claude mcp add --transport http 50heads https://mcp.50heads.com/mcpCursor
~/.cursor/mcp.jsonに追加し、Cursorから求められたらログインします。
{
"mcpServers": {
"50heads": {
"url": "https://mcp.50heads.com/mcp"
}
}
}ChatGPT
ChatGPTで、設定、アプリとコネクタ、詳細設定の順に開き、開発者モードをオンにします。作成を選び、このURLを貼り付けて、OAuthを選びます。
https://mcp.50heads.com/mcpVS 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/mcp50headsが使える場所
どの方法でも、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日の上限も同じです。