AI 어시스턴트와 개발자용

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

50heads를 호환되는 AI 어시스턴트에 연결하면 어시스턴트가 인증된 사람에게 질문하고 결과를 받을 수 있어요. 답변당 20크레딧부터예요. 어시스턴트가 외부 도구를 쓸 수 있게 해 주는 표준인 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를 찾을 수 있는 곳

어느 방법이든 AI 어시스턴트에게 같은 도구를 줘요. 어시스턴트가 지원하는 방법을 쓰세요.

호스팅 서버
https://mcp.50heads.com/mcp 지금 쓸 수 있어요. 설치할 것은 없어요. 주소를 추가하고 로그인하세요.
npm 패키지
npx -y @50heads/mcp 지금 쓸 수 있어요. 로컬 명령을 실행하는 어시스턴트용이에요. Node 20 이상과 API 키가 필요해요.
공식 MCP 레지스트리
com.50heads/mcp 지금 쓸 수 있어요. 레지스트리를 읽는 어시스턴트와 디렉터리에서 50heads를 찾을 수 있어요.
디렉터리
Claude, ChatGPT, Cursor 디렉터리와 Smithery, Glama, PulseMCP, mcp.so에 곧 등록돼요. 그전까지는 호스팅 서버를 직접 추가하세요.

기본 흐름은 세 단계예요

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

> 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

진행 여부 판정 받기

예·아니요 질문에 기준선(예: ‘예’ 60% 초과)을 정하면 범위와 함께 판정을 받아요. 판정은 진행, 중단, 불명확 중 하나예요. 기준선 설정에 추가 비용은 없어요.

사용할 수 있는 도구

estimate
질문의 가격, 시간, 유효성 검사. 크레딧이 쓰이지 않아요.
ask
질문을 올려요. 멱등성 키가 필요해요. 같은 키로 다시 시도해도 질문이 두 번 만들어지거나 두 번 결제되지 않아요.
results
지금까지의 결과, 개별 답변, 파일, 최근 질문이에요. 에이전트가 다시 질문하기 전에 기존 결과를 재사용할 수 있어요. 답변이 모일 때까지 저희 쪽에서 기다릴 수도 있어요.
questions
진행 중인 질문을 멈추고 아직 받지 않은 답변만큼 환불하고, 답변을 더 받고, 부적절한 답변을 신고하고, 질문을 정리해요.
projects
질문을 쉽게 찾도록 돕는 프로젝트와 라벨.
webhooks
웹훅 엔드포인트, 전송 내역, 최근 이벤트예요. 스크립트가 계속 확인하지 않아도 돼요.
organization
읽기 전용: 조직, 도메인, SCIM, 서비스 계정, Slack과 Zapier 연결.
audit
읽기 전용: 조직의 감사 로그를 목록이나 내보내기로 보여줘요.
help
도움말 센터를 검색하고 지원팀에 의견을 보내요.

자동 실행을 위한 제어 장치

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

내 데이터는 AI 학습에 쓰이지 않아요

질문, 구매한 답변, 응답자가 쓴 이유를 AI 모델 학습에 쓰지 않으며, 판매하지도 않아요. AI와 내 데이터

또는 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"

Zapier에서 50heads 쓰기

코드는 필요 없습니다. Zapier에서 질문하기, 응답자 추가, 취소, 고/노고 판정이 담긴 결과 받기를 할 수 있습니다. 질문이 끝나면 Zap을 시작할 수도 있습니다. Zapier는 다른 앱처럼 OAuth로 연결되며, 같은 권한 범위와 일일 한도가 적용됩니다.

개발자 문서의 Zapier 안내

AI 어시스턴트가 인증된 사람에게 질문하게 하세요.

키보드 단축키

아무 페이지에서나 ?를 누르면 이 목록이 보여요. 입력란에 글을 쓰는 동안에는 꺼져요.

일반

키보드 단축키 보기
?
도움말 검색
/
질문하기
n
메뉴 닫기
Esc

이동

홈
g다음h
요금
g다음p
이용 방법
g다음w
인증 방법
g다음v
AI 에이전트용
g다음a
팀용
g다음t
수익
g다음e
블로그
g다음b
API 문서
g다음d
내 계정
g다음o