@firsthandapi/mcp-server — FirstHandAPI MCP 서버

에이전트를 위한 Zero-to-job (부트스트랩 모드)

아직 API 키가 없으신가요? 그래도 서버를 시작할 수 있습니다 — 단일 signup 도구만 노출됩니다:

npx @firsthandapi/mcp-server        # no env var needed

org_name과 email로 signup을 호출하면 API 키와 $2.50의 무료 크레딧을 받을 수 있습니다(키는 한 번만 표시되므로 저장하세요). 그런 다음 설정을 마치고 재시작하세요:

claude mcp add firsthandapi -e FIRSTHAND_API_KEY=fh_live_... -- npx @firsthandapi/mcp-server

키가 설정되면 7개의 작업 도구가 모두 잠금 해제됩니다: create_job, create_job_and_wait, get_job, list_jobs, get_job_files, cancel_job, get_credits.

FirstHandAPI의 공식 MCP 서버 — 인간 참여(HITL) 크라우드소싱 데이터 수집을 위한 서버입니다. Claude Code, Cursor 및 기타 AI 에이전트가 자동화된 AI 품질 평가를 통해 실제 인간 작업자로부터 사진, 오디오, 비디오 및 화면 녹화를 수집할 수 있게 해줍니다.

사용 사례: UGC 수집, AI 평가를 위한 ground truth 데이터, 멀티모달 모델을 위한 LLM 학습 데이터.

Related MCP server: simple-fal-mcp

설치

npm install @firsthandapi/mcp-server

구성

Claude Code

{
  "mcpServers": {
    "firsthand": {
      "command": "npx",
      "args": ["@firsthandapi/mcp-server"],
      "env": {
        "FIRSTHAND_API_KEY": "fh_live_your_key_here"
      }
    }
  }
}

Cursor

.cursor/mcp.json에 추가:

{
  "firsthand": {
    "command": "npx @firsthandapi/mcp-server",
    "env": { "FIRSTHAND_API_KEY": "fh_live_..." }
  }
}

도구

모든 작업 생성 도구는 선택적 location 매개변수를 허용합니다: 텍스트 기반의 경우 { city, state }, 좌표 기반 제약 조건의 경우 { latitude, longitude, radius_km }.

환경 변수

• FIRSTHAND_API_KEY (필수) — API 키

• FIRSTHAND_BASE_URL (선택) — API 기본 URL (기본값: https://api.firsthandapi.com)

• FIRSTHAND_TIMEOUT_MS (선택) — 요청 시간 초과 (기본값: 30000)

라이선스

사유