AI 어시스턴트와 개발자용

AI 어시스턴트에서 50heads를 쓰세요.

50heads를 호환되는 AI 어시스턴트에 연결하면 어시스턴트가 실제 사람에게 질문하고 결과를 받을 수 있어요. 설정에 약 10분이 걸리고, 답변당 $0.25부터예요. 어시스턴트가 외부 도구를 쓸 수 있게 해 주는 표준인 MCP로 동작하므로, Claude, Cursor, ChatGPT, MCP를 지원하는 모든 호스트에서 쓸 수 있어요.

내 호스트에 추가하기

Claude

Claude에서 설정, 커넥터 순서로 열어 이 URL로 맞춤 커넥터를 추가하세요. 로그인하고 하루 지출 한도를 정해요.

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

Claude Code

터미널에서 실행하세요. Claude Code가 브라우저를 열면 로그인하고 하루 지출 한도를 정해요.

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

Cursor

~/.cursor/mcp.json에 추가한 다음, Cursor가 요청하면 로그인하세요.

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

ChatGPT

ChatGPT에서 설정, 앱 및 커넥터, 고급 설정 순서로 열어 개발자 모드를 켜세요. 만들기를 선택하고 이 URL을 붙여 넣은 다음 OAuth를 고르세요.

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

VS Code

작업 공간의 .vscode/mcp.json에 추가하거나 MCP: Add Server를 실행하세요. VS Code가 로그인 페이지를 열어요.

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

Windsurf

포털에서 받은 API 키와 함께 ~/.codeium/windsurf/mcp_config.json에 추가하세요.

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

기타 (npx)

로컬 명령을 실행하는 호스트용이에요. Node 20 이상과 포털에서 받은 API 키가 필요해요.

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

기본 흐름은 세 단계예요

추정은 무료이고 크레딧이 쓰이지 않아요. 질문하면 크레딧이 예약돼요. 결과를 기다리는 동안은 50heads가 대기를 맡아서, 어시스턴트가 계속 다시 확인하지 않고 한 번만 호출해요.

> 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

사용할 수 있는 도구

estimate: 질문의 가격, 시간, 유효성 검사. 크레딧이 쓰이지 않아요.
ask: 질문을 올려요. 멱등성 키가 필요해요. 같은 키로 다시 시도해도 질문이 두 번 만들어지거나 두 번 결제되지 않아요.
get_results: 기다리지 않고 지금까지의 결과를 가져와요.
wait_for_results: 질문에 답변이 모일 때까지 50heads 쪽에서 기다려요. 클라이언트가 계속 확인하지 않아도 돼요.
list_questions: 최근 질문 목록이에요. 에이전트가 다시 질문하기 전에 기존 결과를 재사용할 수 있어요.
cancel: 진행 중인 질문을 멈추고, 아직 받지 않은 답변만큼 환불해요.
templates: 가격이 정해진 질문 템플릿.
balance: 크레딧과, 이 연결의 하루 한도에서 남은 금액.

자동 실행을 위한 제어 장치

연결마다 하루 지출 한도(기본값 5,000크레딧)가 있어요. 한도를 넘는 질문은 서버가 거부해요.
질문에는 멱등성 키가 필요해요. 같은 키로 다시 시도해도 질문이 두 번 만들어지거나 두 번 결제되지 않아요.
질문은 다른 모든 사람의 질문과 같은 콘텐츠 규칙을 거쳐요. 거부된 질문에는 비용이 들지 않아요.
결과에서 응답자를 알아볼 수는 없어요.

또는 API를 직접 호출하세요

MCP 서버가 하는 모든 일은 일반 HTTPS 호출이에요. 키는 fh_live_로 시작하고 한 번만 보여 드려요.

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"

AI 어시스턴트가 실제 사람에게 질문하게 하세요.

API 문서 MCP 설정 웹훅