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 호환 클라이언트