Til AI-assistenter og udviklere

Brug 50heads fra en AI-assistent.

Forbind 50heads med en kompatibel AI-assistent, så den kan stille rigtige mennesker et spørgsmål og modtage resultatet. Det tager cirka ti minutter at sætte op og koster fra 0,25 € pr. svar. Det virker via MCP, standarden der lader en assistent bruge eksterne værktøjer, så det kører i Claude, Cursor, ChatGPT og enhver vært, der understøtter MCP.

Føj det til din vært

Claude

Åbn Indstillinger i Claude, derefter Connectors, og tilføj en brugerdefineret connector med denne URL. Du logger ind og sætter en daglig udgiftsgrænse.

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

Claude Code

Kør dette i en terminal. Claude Code åbner en browser, hvor du logger ind og sætter en daglig udgiftsgrænse.

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

Cursor

Føj dette til ~/.cursor/mcp.json, og log derefter ind, når Cursor beder om det.

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

ChatGPT

Åbn Indstillinger i ChatGPT, derefter Apps og connectors, derefter Avancerede indstillinger, og slå Developer mode til. Vælg Create, indsæt denne URL og vælg OAuth.

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

VS Code

Føj dette til .vscode/mcp.json i dit workspace, eller kør MCP: Add Server. VS Code åbner siden til login.

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

Windsurf

Føj dette til ~/.codeium/windsurf/mcp_config.json, med en API-nøgle fra portalen.

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

Andet (npx)

Til værter, der starter en lokal kommando. Kræver Node 20 eller nyere og en API-nøgle fra portalen.

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

Det grundlæggende forløb har tre trin

Beregning er gratis og bruger aldrig penge. Spørg reserverer kreditterne. Vent på resultater: 50heads holder ventetiden, så din assistent foretager ét kald i stedet for at tjekke igen og igen.

> 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

Tilgængelige værktøjer

estimate: Pris, tid og validering af et spørgsmål. Bruger aldrig penge.
ask: Sender et spørgsmål. Kræver en idempotensnøgle: et nyt forsøg med samme nøgle kan ikke skabe et andet spørgsmål eller en anden betaling.
get_results: Resultaterne indtil nu, uden at vente.
wait_for_results: Venter hos os, til spørgsmålet er besvaret, så klienten ikke skal blive ved med at tjekke.
list_questions: Seneste spørgsmål, så en agent kan genbruge et resultat, før den spørger igen.
cancel: Stopper et aktivt spørgsmål og refunderer de svar, der ikke er givet.
templates: Spørgsmålsskabeloner til fast pris.
balance: Kreditter og det, der er tilbage under forbindelsens daglige grænse.

Kontrol ved uovervåget brug

Hver forbindelse har en daglig udgiftsgrænse, 5.000 kreditter, medmindre du ændrer den. Serveren afviser et spørgsmål, der ville overskride den.
Spørg kræver en idempotensnøgle. Et nyt forsøg med samme nøgle kan ikke skabe et andet spørgsmål eller en anden betaling.
Spørgsmål følger de samme indholdsregler som alle andres. Et afvist spørgsmål koster ingenting.
Resultater afslører aldrig en head.

Eller kald API'et

Alt, hvad MCP-serveren gør, er et almindeligt HTTPS-kald. Nøgler starter med fh_live_ og vises kun én gang.

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"

Lad din AI-assistent spørge rigtige mennesker.

API-dokumentation MCP-opsætning Webhooks