본문으로 건너뛰기

MCP (Model Context Protocol)

Gency MCP 서버를 설치해 Claude Code, Codex CLI 등 MCP를 지원하는 AI 개발 도구에서 자연어로 상세페이지를 생성하고 결과물을 받는 방법을 안내합니다.

젠시 API는 REST API뿐만 아니라 MCP(Model Context Protocol)도 지원합니다.

MCP를 사용하면 Claude Code, Codex CLI 등 MCP를 지원하는 AI 개발 도구에서 별도의 API 구현 없이 자연어로 서비스를 사용할 수 있습니다.

예를 들어 다음과 같은 작업을 AI에게 직접 요청할 수 있습니다.

  • "상품 상세페이지를 생성해줘."
  • "이 이미지로 상세페이지를 만들어줘."
  • "작업 상태를 확인해줘."
  • "완성된 결과물을 다운로드해줘."

MCP를 통해 호출되는 기능은 기존 REST API와 동일한 인증 및 과금 정책이 적용됩니다.


설치 패키지​

아래 npm 패키지를 통해 MCP 서버를 설치하고 실행할 수 있습니다.

npx -y @gency-ai/gency-mcp

Claude Code 연동 방법​

터미널에서 다음 명령으로 MCP 서버를 등록합니다.

claude mcp add gency -- npx -y @gency-ai/gency-mcp

등록 후 Claude Code를 실행하면 OAuth 인증이 진행되며, 인증 완료 후 즉시 사용할 수 있습니다.


Codex CLI 연동 방법​

터미널에서 다음 명령으로 MCP 서버를 등록합니다.

codex mcp add gency -- npx -y @gency-ai/gency-mcp

등록 후 Codex를 실행하면 브라우저가 열리며 OAuth 인증을 완료할 수 있습니다.


기타 MCP 지원 클라이언트​

다음과 같은 다양한 MCP 호환 도구에서도 동일하게 사용할 수 있습니다.

  • Cursor
  • Claude Desktop
  • 기타 MCP 호환 클라이언트