Pro AI asistenty a vývojáře

Používejte 50heads z AI asistenta.

Propojte 50heads s kompatibilním AI asistentem, aby se mohl zeptat skutečných lidí a dostat výsledek. Nastavení trvá asi deset minut a odpověď stojí od 0,25 €. Funguje přes MCP, standard, který asistentovi umožňuje používat externí nástroje, takže běží v nástrojích Claude, Cursor, ChatGPT i v každém hostiteli s podporou MCP.

Přidejte to do svého hostitele

Claude

V Claude otevřete Nastavení, potom Konektory a přidejte vlastní konektor s touto adresou URL. Přihlásíte se a nastavíte denní limit útraty.

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

Claude Code

Spusťte to v terminálu. Claude Code otevře prohlížeč, kde se přihlásíte a nastavíte denní limit útraty.

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

Cursor

Přidejte to do ~/.cursor/mcp.json a až se Cursor zeptá, přihlaste se.

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

ChatGPT

V ChatGPT otevřete Nastavení, potom Aplikace a konektory, potom Pokročilá nastavení a zapněte režim vývojáře. Zvolte Vytvořit, vložte tuto adresu URL a vyberte OAuth.

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

VS Code

Přidejte to do .vscode/mcp.json ve svém pracovním prostoru, nebo spusťte MCP: Add Server. VS Code otevře přihlašovací stránku.

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

Windsurf

Přidejte to do ~/.codeium/windsurf/mcp_config.json s klíčem API z portálu.

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

Jiné (npx)

Pro hostitele, kteří spouštějí místní příkaz. Vyžaduje Node 20 nebo novější a klíč API z portálu.

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

Základní postup má tři kroky

Odhad je zdarma a nikdy nic neutrácí. Zeptat se rezervuje kredity. Počkat na výsledky: 50heads čekání drží za vás, takže váš asistent udělá jedno volání, místo aby se ptal pořád dokola.

> 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

Dostupné nástroje

estimate: Cena, čas a kontrola otázky. Nikdy nic neutrácí.
ask: Zveřejní otázku. Vyžaduje klíč idempotence: opakování se stejným klíčem nemůže vytvořit druhou otázku ani druhou platbu.
get_results: Dosavadní výsledky, bez čekání.
wait_for_results: Čeká na naší straně, dokud otázka není zodpovězena, takže klient se nemusí neustále ptát.
list_questions: Nedávné otázky, aby mohl agent znovu použít výsledek, než se zeptá znovu.
cancel: Zastaví běžící otázku a vrátí kredity za odpovědi, které nepřišly.
templates: Šablony otázek s pevnou cenou.
balance: Kredity a to, co zbývá z denního limitu připojení.

Ochrany pro provoz bez dohledu

Každé připojení má denní limit útraty. Výchozí je 5 000 kreditů, dokud ho nezměníte. Server odmítne dotaz, který by ho překročil.
Zeptat se vyžaduje klíč idempotence. Opakování se stejným klíčem nemůže vytvořit druhou otázku ani druhou platbu.
Otázky procházejí stejnými pravidly obsahu jako všechny ostatní. Odmítnutá otázka nestojí nic.
Výsledky nikdy neprozradí, kdo odpovídal.

Nebo volejte API

Vše, co server MCP dělá, je obyčejné volání HTTPS. Klíče začínají fh_live_ a zobrazí se jen jednou.

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"

Nechte svého AI asistenta ptát se skutečných lidí.

Dokumentace API Nastavení MCP Webhooky