Netlify

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

Servidor MCP do Netlify

Servidor MCP do Netlify segue o Model Context Protocol (MCP) para permitir que agentes de código usem a API e a CLI do Netlify — assim, eles podem criar novos projetos, compilar, implantar e gerenciar seus recursos do Netlify usando prompts em linguagem natural.

---

Visão geral

O Model Context Protocol é um protocolo padrão emergente para conectar agentes de código a servidores MCP, permitindo que eles gerenciem recursos e realizem tarefas usando linguagem natural. O Servidor MCP do Netlify atua como uma ponte, fornecendo acesso à API, ferramentas da CLI, prompts e muito mais para seus agentes.

Você pode se conectar ao Servidor MCP do Netlify usando vários clientes MCP, incluindo:

• Windsurf
• Cursor
• Claude
• Copilot (VSCode)
• Cline
• Warp
• LM Studio
• Veja a lista completa

---

Casos de uso

Com o Servidor MCP do Netlify, seus agentes de IA podem:

• Criar, gerenciar e implantar projetos do Netlify
• Modificar controles de acesso para aumentar a segurança dos projetos
• Instalar ou desinstalar extensões do Netlify
• Buscar informações de usuários e equipes
• Habilitar e gerenciar envios de formulários
• Criar e gerenciar variáveis de ambiente e segredos
• e muito mais...

---

Pré-requisitos

• Node.js 22 ou superior Verifique com node --version
• Uma conta do Netlify
• Um cliente MCP (por exemplo, Windsurf, Cursor, Claude, Copilot)

Dica: Instale a CLI do Netlify globalmente para ter a melhor experiência: npm install -g netlify-cli

---

Configuração do MCP

Para o servidor MCP de produção, use a seguinte configuração:

Editores com instalação em um clique:

• use o link a seguir no navegador se o link não for exibido ou aberto: 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.

Configuração para arquivos de configuração do MCP:

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

Para desenvolvimento local, consulte Configurar a configuração local do MCP.

---

Solução de problemas

Versão do Node

• Use Node.js 22 ou superior para obter os melhores resultados.

• Se você usa nvm, execute:

  nvm install 22
  nvm use 22
  

Solução de problemas de autenticação do Netlify

• Se você tiver problemas de autenticação, poderá adicionar temporariamente um token de acesso pessoal (PAT) do Netlify à configuração do MCP:

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

Não faça commit do seu PAT no repositório! Depois de resolver o problema, remova o PAT da configuração.

---

Gerar um novo token de acesso pessoal (PAT)

1. No painel do Netlify, selecione o ícone do usuário.
2. Acesse Configurações do usuário > OAuth > Novo token de acesso.
3. Copie o token e adicione-o (temporariamente) à configuração do MCP, conforme descrito acima.
4. Reinicie ou atualize seu cliente MCP.

---

Cartão de implantação (MCP hospedado)

Peça a um cliente compatível com MCP Apps: “Mostre as implantações recentes do meu projeto.” A ferramenta netlify-open-deployments recebe um siteId (e um deployId opcional) e mostra até cinco implantações correspondentes, com status, branch, horário de criação identificado, erros e links, além da equipe do projeto e do link para o painel. Filtre a lista de projetos por status. As ferramentas também aceitam status; a filtragem é aplicada pelo Netlify antes de limitar os resultados. Os filtros não se aplicam a um deployId específico. O cartão é atualizado a cada cinco segundos enquanto uma implantação exibida estiver ativa e para quando ela terminar ou após 15 minutos, incluindo o tempo em que ficar oculto. O botão Atualizar faz uma nova verificação manual e inicia uma nova janela de 15 minutos para atualizações automáticas. A aplicação de filtros também inicia uma nova janela. Clientes sem suporte a MCP Apps recebem um resumo em texto.

Isso usa a conexão OAuth existente do Netlify e não adiciona variáveis de ambiente nem uma etapa de compilação do frontend. Após a implantação, atualize o catálogo de ferramentas MCP do cliente. Esta primeira versão não inclui logs de compilação nem busca em vários projetos; use o link Abrir no Netlify do cartão para ver os detalhes completos da compilação.

Para fazer um teste rápido no ChatGPT, conecte o endpoint /mcp de uma prévia implantada, abra um projeto com uma implantação em execução e verifique se o cartão é atualizado até a conclusão. Verifique também um projeto vazio, uma implantação com falha e a alternativa em texto em um cliente sem suporte a MCP Apps.

Recursos

• Documentação do Model Context Protocol
• Lista oficial de clientes MCP
• CLI do Netlify