Netlify

공식

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

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

  • 프로젝트 생성 및 배포 — 어시스턴트에게 새 Netlify 프로젝트를 스캐폴드하고, 빌드하고, API와 CLI를 통해 배포하도록 요청하세요.
  • 액세스 제어 관리 — 어시스턴트에게 인증 및 액세스 설정을 수정하여 프로젝트 보안을 강화하도록 지시하세요.
  • 확장 프로그램 처리 — 어시스턴트가 사이트 전반에 걸쳐 Netlify 확장 프로그램을 설치하거나 제거하도록 하세요.
  • 계정 세부 정보 가져오기 — 멤버십 및 권한을 포함한 사용자 및 팀 정보를 요청하세요.
  • 양식 관리 — 양식 제출을 활성화하고 수신되는 양식 데이터를 보거나 관리하세요.
  • 환경 변수 구성 — 프로젝트의 환경 변수와 비밀을 생성, 업데이트 또는 삭제하세요.

호스팅형 MCP 서버

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

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

문서

Netlify MCP 서버

Netlify MCP 서버는 Model Context Protocol (MCP)을 따르며, 코드 에이전트가 Netlify API와 CLI를 사용할 수 있게 해줍니다—자연어 프롬프트를 사용하여 새 프로젝트를 만들고, 빌드하고, 배포하고, Netlify 리소스를 관리할 수 있습니다.


개요

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

다양한 MCP 클라이언트를 사용하여 Netlify MCP 서버에 연결할 수 있습니다:


사용 사례

Netlify MCP 서버를 사용하면 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를 제거하세요.


새 개인 액세스 토큰 (PAT) 생성

  1. Netlify 대시보드에서 사용자 아이콘을 선택하세요.
  2. 사용자 설정 > OAuth > 새 액세스 토큰으로 이동하세요.
  3. 토큰을 복사하여 위와 같이 MCP 구성에 (임시로) 추가하세요.
  4. MCP 클라이언트를 다시 시작하거나 새로 고치세요.

리소스