Para assistentes de IA e programadores

Use o 50heads a partir de um assistente de IA.

Ligue o 50heads a um assistente de IA compatível para que ele possa fazer uma pergunta a pessoas verificadas e receber o resultado. Custa a partir de 20 créditos por resposta. Funciona através de MCP, o padrão que permite a um assistente usar ferramentas externas, por isso serve com Claude, Cursor, ChatGPT e qualquer anfitrião que suporte MCP.

Adicione-o ao seu anfitrião

Claude

No Claude, abra Definições, depois Conectores, e adicione um conector personalizado com este URL. Vai iniciar sessão e definir um limite de gasto diário.

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

Claude Code

Execute isto num terminal. O Claude Code abre o navegador para iniciar sessão e definir um limite de gasto diário.

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

Cursor

Adicione isto a ~/.cursor/mcp.json e inicie sessão quando o Cursor pedir.

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

ChatGPT

No ChatGPT, abra Definições, depois Apps e conectores, depois Definições avançadas, e ative o modo de programador. Escolha Criar, cole este URL e selecione OAuth.

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

VS Code

Adicione isto a .vscode/mcp.json no seu espaço de trabalho, ou execute MCP: Add Server. O VS Code abre a página de início de sessão.

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

Windsurf

Adicione isto a ~/.codeium/windsurf/mcp_config.json, com uma chave de API do portal.

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

Outros (npx)

Para anfitriões que executam um comando local. Requer o Node 20 ou posterior e uma chave de API do portal.

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

Onde encontrar o 50heads

Cada opção dá as mesmas ferramentas ao seu assistente de IA. Use a que ele suportar.

Servidor alojado
https://mcp.50heads.com/mcp Já disponível. Nada a instalar: adicione o endereço e inicie sessão.
Pacote npm
npx -y @50heads/mcp Já disponível, para assistentes que executam um comando local. Requer o Node 20 ou posterior e uma chave de API.
Registo oficial de MCP
com.50heads/mcp Já disponível. Os assistentes e os diretórios que leem o registo vão encontrar o 50heads lá.
Diretórios
Brevemente nos diretórios do Claude, do ChatGPT e do Cursor, e no Smithery, Glama, PulseMCP e mcp.so. Até lá, adicione o servidor alojado manualmente.

O fluxo básico tem três passos

Estimar é gratuito e nunca gasta. Perguntar reserva os créditos. Aguardar resultados: o 50heads trata da espera, por isso o seu assistente faz uma chamada em vez de verificar repetidamente.

> 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

Perguntar se deve avançar ou não

Defina uma linha numa pergunta de sim ou não, por exemplo Sim acima de 60%. Recebe um veredicto com um intervalo: avançar, não avançar ou pouco claro. A linha não custa nada a mais.

Ferramentas disponíveis

estimate
Preço, prazo e validação de uma pergunta. Nunca gasta.
ask
Publica uma pergunta. Exige uma chave de idempotência: repetir com a mesma chave não pode criar uma segunda pergunta nem uma segunda cobrança.
results
Os resultados até agora, as respostas uma a uma, ficheiros e as suas perguntas recentes, para reutilizar um resultado antes de voltar a perguntar. Pode esperar pelas respostas do nosso lado.
questions
Para uma pergunta ativa e reembolsa as respostas não dadas, acrescenta mais respostas, assinala uma resposta fraca ou arquiva uma pergunta.
projects
Projetos e etiquetas para encontrar as perguntas com facilidade.
webhooks
Pontos de ligação de webhooks, as suas entregas e os últimos eventos, para que um script não tenha de verificar sem parar.
organization
Só de leitura: a organização, os seus domínios, SCIM, contas de serviço e as ligações do Slack e do Zapier.
audit
Só de leitura: o registo de auditoria da organização, em lista ou exportado.
help
Pesquisa o centro de ajuda e envia comentários ao apoio.

Controlos para uso sem supervisão

  • Cada ligação tem um limite de gasto diário, 5000 créditos salvo se o alterar. O servidor recusa um pedido de pergunta que o ultrapasse.
  • Perguntar exige uma chave de idempotência. Repetir com a mesma chave não pode criar uma segunda pergunta nem uma segunda cobrança.
  • As perguntas seguem as mesmas regras de conteúdo que as de toda a gente. Uma pergunta recusada não custa nada.
  • Os resultados nunca identificam um head.

Os seus dados não treinam IA

Não usamos as suas perguntas, as respostas que compra nem as razões que os heads escrevem para treinar modelos de IA, e não as vendemos. A IA e os seus dados

Ou chame a API

Tudo o que o servidor MCP faz é uma simples chamada HTTPS. As chaves começam por fh_live_ e só são mostradas uma vez.

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"

Usar o 50heads a partir do Zapier

Sem código. No Zapier pode fazer uma pergunta, adicionar heads, cancelar e obter os resultados com o veredicto go ou no go. Os Zaps também podem começar quando uma pergunta termina. O Zapier liga-se por OAuth como qualquer outra app, com os mesmos âmbitos e o mesmo limite diário.

Zapier na documentação para programadores

Deixe o seu assistente de IA perguntar a pessoas verificadas.

Atalhos de teclado

Prima ? em qualquer página para os ver. Ficam desligados enquanto escreve num campo.

Geral

Ver os atalhos de teclado
?
Pesquisar na ajuda
/
Faça uma pergunta
n
Fechar os menus
Esc

Ir para

Início
gdepoish
Preços
gdepoisp
Como funciona
gdepoisw
Como verificamos
gdepoisv
Para agentes de IA
gdepoisa
Para equipas
gdepoist
Ganhar
gdepoise
Blogue
gdepoisb
Documentação da API
gdepoisd
A sua conta
gdepoiso