Netlify MCP — Claude Code MCP 서버

Netlify 공식 MCP 서버. 사이트 생성/배포/관리, 환경변수·폼·함수 등 Netlify 플랫폼 작업을 AI가 수행한다.

Netlify MCP는 Netlify가 공식 제공하는 Model Context Protocol 서버로, Claude Code 같은 AI 에이전트가 Netlify 플랫폼 작업을 대화로 직접 수행하게 해줍니다. 핵심 목적은 "대시보드를 직접 클릭하거나 CLI 명령을 일일이 외우지 않고도, 자연어 지시로 사이트를 생성·배포·관리하는 것"입니다.

주요 기능은 Netlify 플랫폼 전반에 걸칩니다. 새 사이트 생성과 배포 트리거, 배포 상태 확인, 환경변수(빌드/런타임) 조회·설정, Netlify Forms(폼 제출 데이터)와 Functions(서버리스 함수) 같은 플랫폼 리소스 관리 등 일상적인 운영 작업을 AI가 수행할 수 있습니다. 구체적으로 지원하는 도구 목록과 동작 범위는 버전에 따라 달라질 수 있으므로 공식 문서 확인을 권장합니다.

이 MCP가 푸는 문제는 명확합니다. Jamstack/정적 사이트를 운영하다 보면 "배포 상태 확인 → 환경변수 수정 → 재배포" 같은 반복 작업이 잦은데, 컨텍스트를 코드 작업과 배포 도구 사이에서 오가며 전환해야 합니다. Netlify MCP를 붙이면 코드 편집과 배포·운영을 같은 AI 세션 안에서 이어서 처리할 수 있어 맥락 전환 비용이 줄어듭니다.

누가 쓰면 좋은가: Netlify로 프런트엔드·정적 사이트·Jamstack 앱을 호스팅하는 개발자, Netlify Functions/Forms를 함께 쓰는 팀, 그리고 AI 에이전트에게 배포 파이프라인 일부를 위임하려는 사람에게 적합합니다. 설치는 npx로 Netlify 공식 패키지를 Claude의 MCP로 추가하고, 인증용 Personal Access Token을 환경변수로 제공하는 방식입니다. Node 환경이 필요합니다. 자세한 토큰 발급과 권한 범위는 Netlify 공식 GitHub 저장소와 문서를 참고하세요.

언제 쓰나

Netlify로 사이트를 호스팅하면서 AI에게 배포·운영을 맡기고 싶을 때 적합합니다. 코드 수정 후 같은 세션에서 배포를 트리거하고 상태를 확인하거나, 환경변수를 일괄 조회·수정하거나, Functions·Forms 같은 플랫폼 리소스를 점검할 때 유용합니다. Jamstack/정적 사이트 워크플로에서 대시보드와 CLI를 오가는 반복 작업을 줄이려는 개발자에게 권장합니다.

설치

claude mcp add netlify -- npx -y @netlify/mcp

npx로 Netlify 공식 MCP 패키지를 Claude의 MCP 서버로 추가하므로 Node.js 실행 환경이 필요합니다. 인증을 위해 환경변수 NETLIFY_PERSONAL_ACCESS_TOKEN에 Netlify Personal Access Token을 설정해야 하며, 토큰이 없으면 사이트·배포 관련 작업이 동작하지 않습니다. 토큰 발급 위치와 지원 도구 범위는 버전에 따라 달라질 수 있으니 Netlify 공식 GitHub 저장소·문서 확인을 권장합니다. 등록 후 Claude 재시작이 필요할 수 있습니다.

필요 키(직접 발급, 플레이스홀더): NETLIFY_PERSONAL_ACCESS_TOKEN

보안 주의

NETLIFY_PERSONAL_ACCESS_TOKEN은 계정의 사이트 생성·배포·설정 변경 권한을 가질 수 있는 민감 자격증명입니다. 토큰을 코드·로그·커밋에 노출하지 말고 환경변수나 비밀 관리로만 주입하며, .gitignore 등재를 확인하세요. 가능하면 권한·범위를 최소화하고 정기적으로 회전하는 것이 안전합니다. AI가 배포 트리거·환경변수 변경·리소스 삭제 같은 파괴적·과금 영향 작업을 수행할 수 있으므로, 자동 실행 전 확인 단계를 두는 것을 권장합니다. 또한 Netlify Forms 제출 데이터 등 외부에서 들어온 콘텐츠에는 프롬프트 인젝션 위험이 있으니 신뢰할 수 없는 텍스트를 그대로 명령으로 취급하지 않도록 주의하세요.

자주 묻는 질문

Netlify MCP를 쓰려면 무엇이 필요한가요?

Node.js 실행 환경과 Netlify Personal Access Token이 필요합니다. npx로 공식 패키지를 Claude의 MCP로 추가하고, NETLIFY_PERSONAL_ACCESS_TOKEN 환경변수에 토큰을 설정하면 사이트·배포 작업을 AI가 수행할 수 있습니다.

AI가 실수로 사이트를 잘못 배포하거나 설정을 바꿀 수 있나요?

가능합니다. 토큰 권한 범위 내에서 배포 트리거·환경변수 변경 등 영향이 있는 작업을 수행할 수 있으므로, 파괴적 작업에는 확인 단계를 두고 토큰 권한을 최소화하는 것을 권장합니다.

Vercel MCP와 무엇이 다른가요?

둘 다 호스팅 플랫폼의 공식 MCP지만 대상 플랫폼이 다릅니다. Netlify MCP는 Netlify의 사이트·배포·Forms·Functions를, Vercel MCP는 Vercel 플랫폼 작업을 다룹니다. 사용 중인 호스팅에 맞는 것을 선택하세요.