조코헌트

Claude Code / Codex 업로드

MCP로 만든 제품을 바로 조코헌트에 올리기

개발이 끝난 워크스페이스에서 에이전트가 제품명, 설명, URL, 이미지, YouTube 링크를 정리해 조코헌트에 제출할 수 있습니다.

API 키 발급하기
01

개인 API 키 발급

설정 페이지에서 Claude Code / Codex 업로드 키를 발급합니다. 키는 다시 볼 수 없으니 안전한 곳에 보관하세요.

02

MCP 등록

아래 명령으로 공개 MCP 엔드포인트와 API 키를 등록합니다. 레포를 클론하거나 npm 패키지를 설치할 필요가 없습니다.

03

업로드 요청

에이전트에게 현재 프로젝트를 조코헌트에 올려달라고 요청하면 검증 후 제품을 제출합니다.

Codex 등록 명령

export JOCOHUNT_API_KEY=joco_live_발급받은_키
codex mcp add jocohunt \
  --url https://jocohunt.jocoding.io/api/mcp \
  --bearer-token-env-var JOCOHUNT_API_KEY

Claude Code 등록 명령

export JOCOHUNT_API_KEY=joco_live_발급받은_키
claude mcp add --transport http jocohunt \
  https://jocohunt.jocoding.io/api/mcp \
  -H "Authorization: Bearer $JOCOHUNT_API_KEY"

프롬프트 예시

jocohunt MCP를 사용해서 이 프로젝트를 조코헌트에 업로드해줘. README와 package.json을 참고하고, 로고/스크린샷 후보를 찾아서 업로드한 다음 jocohunt_submit_product까지 실행해줘.

제출 폼에서 MCP가 채우는 항목

웹 폼을 클릭하는 방식이 아닙니다. MCP는 조코헌트 제출 폼과 같은 제출 payload를 만들어 검증 후 제출합니다.

에이전트가 처음 연결했을 때는 jocohunt_get_submission_guide를 먼저 호출하면 필수값, 선택값, 업로드 순서, 예시 payload를 JSON으로 받을 수 있습니다.

Step 1 기본

`name`, `tagline`, `websiteUrl`, `githubUrl`, `twitterUrl`, `categories`, `stage`, `pricingModel`을 채웁니다.

Step 2 미디어

`logoUrl`, `galleryImages`, `demoVideoUrl`, `description`을 채웁니다. 이미지는 에이전트가 파일을 base64로 읽어 `jocohunt_upload_asset`에 전달하고 반환 URL을 사용합니다.

Step 3 메이커

`teamMembers`, `launchNow`, `scheduledDate`를 채웁니다. 팀 멤버는 `{ name, role, handle }` 배열입니다.

스크린샷은 galleryImages 배열 순서대로 저장됩니다. 첫 번째 이미지를 대표 스크린샷처럼 쓰고 싶으면 배열 첫 번째에 넣으면 됩니다.

일일 제한

스팸을 막기 위해 기본 제한은 제품 제출 일 3회, asset 업로드 일 20회입니다.

지원하는 제출 자료

  • 제품명과 한 줄 소개
  • 웹사이트/GitHub/Twitter URL
  • 로고와 스크린샷
  • 상세 설명
  • YouTube 데모 링크

MCP 도구

  • jocohunt_get_submission_guide
  • jocohunt_get_categories
  • jocohunt_get_my_quota
  • jocohunt_upload_asset
  • jocohunt_validate_submission
  • jocohunt_submit_product

문제가 생기면

  • 에이전트가 어떤 값을 채울지 모르면 jocohunt_get_submission_guide를 먼저 호출하게 하세요.
  • Codex는 JOCOHUNT_API_KEY 환경변수에 키만 넣고 --bearer-token-env-var로 연결하세요.
  • Claude Code는 HTTP transport와 Authorization 헤더가 함께 등록됐는지 확인하세요.
  • jocohunt_get_my_quota로 오늘 quota를 먼저 확인하세요.
  • 이미지는 base64와 contentType을 jocohunt_upload_asset에 전달한 뒤 반환 URL을 제출에 사용하세요.