Netlify

공식

자연어를 사용하여 Netlify 리소스를 생성, 빌드, 배포 및 관리합니다.

Netlify MCP(으)로 무엇을 할 수 있나요?

  • 프로젝트 생성 및 배포 — 자연어 프롬프트로 어시스턴트에게 Netlify 프로젝트의 생성, 관리 및 배포를 요청하세요.
  • 액세스 제어 관리 — Netlify 프로젝트의 보안 설정을 조정하도록 프로젝트 액세스 제어를 수정하세요.
  • 확장 기능 관리 — 프로젝트에 Netlify 확장 기능을 설치하거나 제거하세요.
  • 환경 변수 관리 — 프로젝트의 환경 변수와 비밀 정보를 생성하고 관리하세요.
  • 배포 확인 — "내 프로젝트의 최근 배포를 보여 줘"라고 요청해 배포 상태, 브랜치, 오류 및 링크를 확인하세요.
  • 계정 정보 가져오기 — 사용자 및 팀 정보를 가져오고, 양식 제출을 활성화하거나 관리하세요.

호스팅형 MCP 서버

npx add-mcp 'https://netlify-mcp.netlify.app/mcp'

Claude Code, Codex, Cursor 등에 설치됩니다

문서

Netlify MCP Server

Netlify MCP Server는 Model Context Protocol (MCP)을 따라 코드 에이전트가 Netlify API와 CLI를 사용할 수 있도록 합니다. 이를 통해 자연어 프롬프트로 새 프로젝트를 만들고, 빌드하고, 배포하고, Netlify 리소스를 관리할 수 있습니다.


개요

Model Context Protocol은 코드 에이전트를 MCP 서버에 연결하기 위한 새로운 표준 프로토콜로, 에이전트가 자연어를 사용해 리소스를 관리하고 작업을 수행할 수 있도록 합니다. Netlify MCP Server는 브리지 역할을 하며, 에이전트에 API 액세스, CLI 도구, 프롬프트 등을 제공합니다.

다양한 MCP 클라이언트를 사용해 Netlify MCP Server에 연결할 수 있습니다. 예를 들면 다음과 같습니다.


사용 사례

Netlify MCP Server를 사용하면 AI 에이전트가 다음 작업을 수행할 수 있습니다.

  • Netlify 프로젝트 생성, 관리 및 배포
  • 프로젝트 보안 강화를 위한 액세스 제어 수정
  • Netlify 확장 프로그램 설치 또는 제거
  • 사용자 및 팀 정보 가져오기
  • 양식 제출 활성화 및 관리
  • 환경 변수 및 시크릿 생성 및 관리
  • 그 외 다양한 작업...

사전 요구 사항

  • Node.js 22 이상 다음 명령어로 확인합니다: node --version
  • Netlify 계정
  • MCP 클라이언트(예: Windsurf, Cursor, Claude, Copilot)

팁: 최상의 사용 경험을 위해 Netlify CLI를 전역으로 설치하세요. npm install -g netlify-cli


MCP 구성

프로덕션 MCP 서버에는 다음 구성을 사용하세요.

원클릭 설치를 지원하는 편집기:

Install MCP Server on Cursor

Add MCP Server netlify to LM Studio

Install on VS Code

Install on VS Code Insiders Edition

Install on Goose

  • 링크가 표시되지 않거나 열리지 않으면 브라우저에서 다음 링크를 사용하세요: goose://extension?cmd=npx&arg=-y&arg=%40netlify%2Fmcp&id=netlify&name=Netlify&description=Build%2C%20deploy%2C%20and%20manage%20sites%20with%20Netlify's%20official%20MCP%20server.

MCP 구성 파일 설정:

{
  "mcpServers": {
    "netlify": {
      "command": "npx",
      "args": [
        "-y",
        "@netlify/mcp"
      ]
    }
  }
}

로컬 개발 환경 설정은 로컬 MCP 구성 설정을 참조하세요.


문제 해결

Node 버전

  • 최상의 결과를 얻으려면 Node.js 22 이상을 사용하세요.

  • nvm를 사용하는 경우 다음을 실행하세요.

    nvm install 22
    nvm use 22
    

Netlify 인증 문제 해결

{
  "mcpServers": {
    "netlify-mcp": {
      "command": "npx",
      "args": ["-y", "@netlify/mcp"],
      "env": {
        "NETLIFY_PERSONAL_ACCESS_TOKEN": "YOUR-PAT-VALUE"
      }
    }
  }
}

PAT를 저장소에 커밋하지 마세요! 문제가 해결되면 구성에서 PAT를 제거하세요.


새 Personal Access Token (PAT) 생성

  1. Netlify 대시보드에서 사용자 아이콘을 선택합니다.
  2. User settings > OAuth > New access token으로 이동합니다.
  3. 토큰을 복사한 다음 위와 같이 MCP 구성에 임시로 추가합니다.
  4. MCP 클라이언트를 다시 시작하거나 새로 고칩니다.

배포 카드(호스팅된 MCP)

MCP Apps 호환 클라이언트에 다음과 같이 요청하세요. “내 프로젝트의 최근 배포를 보여 줘.” netlify-open-deployments 도구는 siteId을 사용하며(deployId은 선택 사항), 상태, 브랜치, 레이블이 지정된 생성 시간, 오류 및 링크와 함께 일치하는 배포를 최대 5개 표시하고 프로젝트의 팀 및 대시보드 링크도 보여 줍니다. 상태별로 프로젝트 목록을 필터링하세요. 도구는 status도 허용합니다. 결과 수를 제한하기 전에 Netlify에서 필터링을 적용합니다. 특정 deployId에는 필터가 적용되지 않습니다. 표시된 배포가 진행 중인 동안 카드는 5초마다 새로 고쳐지며, 배포가 완료되거나 숨겨져 있던 시간을 포함해 15분이 지나면 새로 고침을 중지합니다. Refresh 버튼을 누르면 수동으로 다시 확인하고 자동 업데이트를 위한 새 15분 구간이 시작됩니다. 필터를 적용해도 새 구간이 시작됩니다. MCP Apps를 지원하지 않는 클라이언트에는 텍스트 요약이 표시됩니다.

기존 Netlify OAuth 연결을 사용하므로 환경 변수나 프런트엔드 빌드 단계가 추가되지 않습니다. 배포한 후 클라이언트의 MCP 도구 카탈로그를 새로 고치세요. 첫 번째 버전에는 빌드 로그나 여러 프로젝트 조회 기능이 포함되지 않습니다. 전체 빌드 세부 정보를 보려면 카드의 Open in Netlify 링크를 사용하세요.

ChatGPT에서 간단히 테스트하려면 배포된 프리뷰의 /mcp 엔드포인트에 연결하고, 실행 중인 배포가 있는 프로젝트를 연 다음 카드가 배포 완료까지 업데이트되는지 확인하세요. 또한 비어 있는 프로젝트, 실패한 배포, MCP Apps를 지원하지 않는 클라이언트에서의 텍스트 대체 표시도 확인하세요.

리소스