Voor AI-assistenten en developers

Gebruik 50heads vanuit een AI-assistent.

Koppel 50heads aan een compatibele AI-assistent zodat die geverifieerde mensen een vraag kan stellen en het resultaat kan ontvangen. Het kost vanaf 20 credits per antwoord. Het werkt via MCP, de standaard waarmee een assistent externe tools kan gebruiken, dus met Claude, Cursor, ChatGPT en elke host die MCP ondersteunt.

Voeg het toe aan je host

Claude

Open in Claude Instellingen en dan Connectors, en voeg een eigen connector toe met deze URL. Je logt in en stelt een dagelijkse bestedingslimiet in.

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

Claude Code

Voer dit uit in een terminal. Claude Code opent een browser waarin je inlogt en een dagelijkse bestedingslimiet instelt.

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

Cursor

Voeg dit toe aan ~/.cursor/mcp.json en log in zodra Cursor erom vraagt.

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

ChatGPT

Open in ChatGPT Instellingen, dan Apps en connectors, dan Geavanceerde instellingen, en zet de ontwikkelaarsmodus aan. Kies Maken, plak deze URL en kies OAuth.

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

VS Code

Voeg dit toe aan .vscode/mcp.json in je workspace, of voer MCP: Add Server uit. VS Code opent de inlogpagina.

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

Windsurf

Voeg dit toe aan ~/.codeium/windsurf/mcp_config.json, met een API-sleutel uit het portaal.

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

Anders (npx)

Voor hosts die een lokale opdracht starten. Vereist Node 20 of hoger en een API-sleutel uit het portaal.

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

Waar je 50heads vindt

Elke route geeft je AI-assistent dezelfde tools. Gebruik de route die hij ondersteunt.

Gehoste server
https://mcp.50heads.com/mcp Nu beschikbaar. Niets te installeren: voeg het adres toe en log in.
npm-pakket
npx -y @50heads/mcp Nu beschikbaar, voor assistenten die een lokale opdracht starten. Vereist Node 20 of hoger en een API-sleutel.
Officiële MCP Registry
com.50heads/mcp Nu beschikbaar. Assistenten en directory’s die de registry lezen, vinden 50heads daar.
Directory’s
Binnenkort in de directory’s van Claude, ChatGPT en Cursor, en op Smithery, Glama, PulseMCP en mcp.so. Voeg tot die tijd zelf de gehoste server toe.

De basis is drie stappen

Inschatten is gratis en kost nooit iets. Vragen reserveert de credits. Wachten op resultaten: 50heads neemt het wachten over, dus je assistent doet één call in plaats van steeds opnieuw te kijken.

> 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

Vraag om een go of no-go

Zet een grens op een ja-of-neevraag, bijvoorbeeld Ja boven 60%. Je krijgt een oordeel met een marge: go, no-go of onduidelijk. De grens kost niets extra.

Beschikbare tools

estimate
Prijs, tijd en validatie voor een vraag. Kost nooit iets.
ask
Plaatst een vraag. Vereist een idempotency key: een nieuwe poging met dezelfde key kan geen tweede vraag of tweede afschrijving veroorzaken.
results
De resultaten tot nu toe, losse antwoorden, bestanden en je recente vragen, zodat een agent een resultaat kan hergebruiken in plaats van opnieuw te vragen. Kan aan onze kant op de antwoorden wachten.
questions
Stopt een live vraag en betaalt de niet-gegeven antwoorden terug, voegt meer antwoorden toe, markeert een slecht antwoord of rangschikt een vraag.
projects
Projecten en labels waarmee vragen vindbaar blijven.
webhooks
Webhook-eindpunten, hun leveringen en recente gebeurtenissen, zodat een script niet steeds hoeft te controleren.
organization
Alleen lezen: de organisatie, haar domeinen, SCIM, serviceaccounts en de Slack- en Zapier-verbindingen.
audit
Alleen lezen: het auditlogboek van de organisatie, als lijst of export.
help
Doorzoekt het helpcentrum en stuurt feedback naar support.

Beheer voor onbeheerd gebruik

  • Elke verbinding heeft een dagelijkse bestedingslimiet, 5.000 credits tenzij je die wijzigt. De server weigert een vraag die erboven zou uitkomen.
  • Vragen vereist een idempotency key. Een nieuwe poging met dezelfde key kan geen tweede vraag of tweede afschrijving veroorzaken.
  • Vragen moeten aan dezelfde inhoudsregels voldoen als die van iedereen. Een geweigerde vraag kost niets.
  • Resultaten maken nooit bekend wie een head is.

Je gegevens zijn geen trainingsdata

We gebruiken je vragen, de antwoorden die je koopt en de redenen die heads schrijven niet om AI-modellen te trainen, en we verkopen ze niet. AI en je gegevens

Of roep de API aan

Alles wat de MCP-server doet is een gewone HTTPS-call. Keys beginnen met fh_live_ en worden één keer getoond.

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"

50heads gebruiken vanuit Zapier

Geen code nodig. In Zapier kun je een vraag stellen, heads toevoegen, annuleren en resultaten ophalen met het go- of no-go-oordeel. Zaps kunnen ook starten als een vraag klaar is. Zapier verbindt met OAuth zoals elke andere app, met dezelfde scopes en dezelfde daglimiet.

Zapier in de ontwikkelaarsdocumentatie

Laat je AI-assistent geverifieerde mensen iets vragen.

Sneltoetsen

Druk op een willekeurige pagina op ? om ze te zien. Terwijl je in een veld typt, staan ze uit.

Algemeen

Sneltoetsen tonen
?
Zoeken in help
/
Stel een vraag
n
Menu’s sluiten
Esc

Ga naar

Home
gdanh
Prijzen
gdanp
Hoe het werkt
gdanw
Zo controleren we
gdanv
Voor AI-agents
gdana
Voor teams
gdant
Verdienen
gdane
Blog
gdanb
API-documentatie
gdand
Je account
gdano