Pentru asistenți AI și dezvoltatori

Folosește 50heads dintr-un asistent AI.

Conectează 50heads la un asistent AI compatibil, ca să poată pune o întrebare unor persoane reale și să primească rezultatul. Configurarea durează cam zece minute, iar costul pornește de la 0,25 € per răspuns. Funcționează prin MCP, standardul care îi permite unui asistent să folosească unelte externe, deci rulează în Claude, Cursor, ChatGPT și în orice gazdă care acceptă MCP.

Adaugă-l în gazda ta

Claude

În Claude, deschide Setări, apoi Conectori, și adaugă un conector personalizat cu acest URL. Te vei conecta și vei stabili un plafon zilnic de cheltuieli.

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

Claude Code

Rulează asta într-un terminal. Claude Code deschide un browser în care te conectezi și stabilești un plafon zilnic de cheltuieli.

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

Cursor

Adaugă asta în ~/.cursor/mcp.json, apoi conectează-te când îți cere Cursor.

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

ChatGPT

În ChatGPT, deschide Setări, apoi Aplicații și conectori, apoi Setări avansate, și activează modul dezvoltator. Alege Creează, lipește acest URL și alege OAuth.

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

VS Code

Adaugă asta în .vscode/mcp.json din spațiul tău de lucru sau rulează MCP: Add Server. VS Code deschide pagina de conectare.

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

Windsurf

Adaugă asta în ~/.codeium/windsurf/mcp_config.json, cu o cheie API din portal.

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

Altele (npx)

Pentru gazdele care pornesc o comandă locală. Cere Node 20 sau mai nou și o cheie API din portal.

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

Fluxul de bază are trei pași

Estimarea este gratuită și nu cheltuiește nimic. Întrebarea rezervă creditele. Așteptarea rezultatelor: 50heads ține așteptarea, deci asistentul tău face un singur apel, în loc să verifice întruna.

> 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

Unelte disponibile

estimate: Preț, timp și validare pentru o întrebare. Nu cheltuiește niciodată.
ask: Postează o întrebare. Cere o cheie de idempotență: reîncercarea cu aceeași cheie nu poate crea o a doua întrebare sau o a doua taxare.
get_results: Rezultatele de până acum, fără așteptare.
wait_for_results: Așteaptă la noi până când întrebarea primește răspunsuri, ca să nu fie nevoie ca clientul să verifice întruna.
list_questions: Întrebări recente, ca un agent să poată refolosi un rezultat înainte să întrebe din nou.
cancel: Oprește o întrebare activă și rambursează răspunsurile care nu s-au dat.
templates: Șabloane de întrebări cu preț fix.
balance: Creditele și ce a mai rămas din plafonul zilnic al conexiunii.

Controale pentru utilizare nesupravegheată

Fiecare conexiune are un plafon zilnic de cheltuieli, 5.000 de credite dacă nu îl schimbi. Serverul refuză o întrebare care l-ar depăși.
Întrebarea cere o cheie de idempotență. Reîncercarea cu aceeași cheie nu poate crea o a doua întrebare sau o a doua taxare.
Întrebările trec prin aceleași reguli de conținut ca ale tuturor. O întrebare refuzată nu costă nimic.
Rezultatele nu identifică niciodată un head.

Sau apelează API-ul

Tot ce face serverul MCP este un simplu apel HTTPS. Cheile încep cu fh_live_ și se afișează o singură dată.

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"

Lasă-ți asistentul AI să întrebe persoane reale.

Documentație API Configurare MCP Webhooks