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/mcpClaude 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/mcpCursor
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/mcpVS 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/mcpOnde 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/mcpJá disponível. Nada a instalar: adicione o endereço e inicie sessão.- Pacote npm
npx -y @50heads/mcpJá 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/mcpJá 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 highPerguntar 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.