Servidor MCP Render

Implante no Render.com diretamente por meio de assistentes de IA.

Este servidor MCP (Model Context Protocol) permite que assistentes de IA como o Claude interajam com a API do Render, possibilitando a implantação e o gerenciamento de serviços no Render.com.

Recursos

Este servidor cobre tudo o que o servidor MCP oficial do Render faz além de operações de mutação que o servidor deles omite intencionalmente (acionar implantações, excluir recursos, gerenciar domínios personalizados, reiniciar e cancelar implantações).

Serviços

Listar todos os serviços e obter detalhes de um serviço específico
Criar serviços: create_service genérico, além de create_web_service, create_static_site e create_cron_job tipados
Implantar, reiniciar e excluir serviços
Gerenciar variáveis de ambiente e domínios personalizados

Implantações

Obter histórico de implantações, obter uma única implantação e cancelar uma implantação em andamento

Workspaces

Listar workspaces, obter detalhes do workspace e selecionar um workspace padrão para que as ferramentas de criação/logs/métricas não precisem de um ownerId a cada chamada

Observabilidade

Listar e filtrar logs (list_logs) e enumerar valores de rótulos de log
Buscar métricas de desempenho (get_metrics): CPU, memória, solicitações/latência HTTP, largura de banda, número de instâncias, conexões ativas

Datastores

Postgres: listar, obter, criar e executar consultas SQL somente leitura (query_render_postgres)
Key Value (Redis): listar, obter e criar instâncias

Observação sobre query_render_postgres: esta ferramenta conecta-se ao seu banco de dados usando o driver pg e impõe acesso somente leitura (instrução única, apenas SELECT/WITH/ EXPLAIN/SHOW, executada dentro de uma transação READ ONLY). Execute npm install após instalar o pacote para garantir que a dependência pg esteja presente.

Instalação

npm install -g @niyogi/render-mcp

Configuração

Obtenha sua chave de API do Render no Render Dashboard
Configure o servidor MCP com sua chave:

node bin/render-mcp.js configure --api-key=YOUR_API_KEY

Alternativamente, você pode executar node bin/render-mcp.js configure sem o sinalizador --api-key para ser solicitado a informar sua chave de API.

Uso

Iniciando o Servidor

node bin/render-mcp.js start

Verificando a Configuração

node bin/render-mcp.js config

Executando Diagnósticos

node bin/render-mcp.js doctor

Observação: Se você instalou o pacote globalmente, também pode usar os comandos mais curtos:

render-mcp start
render-mcp config
render-mcp doctor

Uso com Diferentes Assistentes de IA

Uso com Claude Code

A maneira mais rápida é a CLI claude mcp add, que registra o servidor via npx (sem necessidade de instalação global):

claude mcp add render -e RENDER_API_KEY=YOUR_API_KEY -- npx -y @niyogi/render-mcp start

Por padrão, isso adiciona o servidor ao projeto atual. Use um sinalizador de escopo para alterar isso:

-s user — disponível em todos os seus projetos
-s project — compartilhado com sua equipe por meio de um .mcp.json versionado
-s local (padrão) — apenas neste projeto, somente para você

Alternativamente, adicione-o manualmente ao seu arquivo de configuração MCP (.mcp.json na raiz do projeto, ou ~/.claude.json para escopo do usuário):

{
  "mcpServers": {
    "render": {
      "command": "npx",
      "args": ["-y", "@niyogi/render-mcp", "start"],
      "env": {
        "RENDER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Em vez de passar a chave via env, você pode armazená-la uma vez com npx @niyogi/render-mcp configure (salva em ~/.render-mcp/config.json) e omitir o bloco env.

Em seguida, verifique a conexão dentro do Claude Code com o comando /mcp — render deve aparecer como conectado e suas ferramentas listadas.

Uso com Cline

Adicione o seguinte ao seu arquivo de configurações MCP do Cline:

{
  "mcpServers": {
    "render": {
      "command": "node",
      "args": ["/path/to/render-mcp/bin/render-mcp.js", "start"],
      "env": {
        "RENDER_API_KEY": "your-render-api-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Reinicie o Cline para que as alterações tenham efeito
Agora você pode interagir com o Render por meio do Claude:
```
Claude, please deploy my web service to Render
```

Uso com Windsurf/Cursor

Instale o pacote render-mcp:
```
npm install -g @niyogi/render-mcp
```

Configure sua chave de API:

node bin/render-mcp.js configure --api-key=YOUR_API_KEY

Inicie o servidor MCP em um terminal separado:
```
node bin/render-mcp.js start
```
Nas configurações do Windsurf/Cursor, adicione o servidor MCP do Render:
- Nome do Servidor: render
- Tipo de Servidor: stdio
- Comando: node
- Argumentos: ["/path/to/render-mcp/bin/render-mcp.js", "start"]
Agora você pode usar os comandos do Render no seu assistente de IA

Uso com Integrações da API Claude

Para aplicações personalizadas que usam a API do Claude diretamente:

Certifique-se de que o servidor render-mcp esteja em execução:
```
node bin/render-mcp.js start
```

Na sua aplicação, ao enviar mensagens ao Claude via API, inclua as conexões do servidor MCP na sua solicitação:

{
  "mcpConnections": [
    {
      "name": "render",
      "transport": {
        "type": "stdio",
        "command": "node",
        "args": ["/path/to/render-mcp/bin/render-mcp.js", "start"]
      }
    }
  ]
}

O Claude agora poderá interagir com o seu servidor MCP do Render

Exemplos de Prompts

Aqui estão alguns exemplos de prompts que você pode usar com o Claude depois que o servidor MCP estiver conectado:

"Liste todos os meus serviços no Render"
"Implante meu serviço web com ID srv-123456"
"Crie um novo site estático no Render a partir do meu repositório GitHub"
"Mostre-me o histórico de implantações do meu serviço"
"Adicione uma variável de ambiente ao meu serviço"
"Adicione um domínio personalizado ao meu serviço"
"Liste meus workspaces do Render e selecione o da equipe"
"Mostre-me os logs de erro de srv-123456 da última hora"
"Qual é o uso de CPU e memória de srv-123456?"
"Consulte meu Postgres do Render: SELECT count(*) FROM users"
"Reinicie meu serviço srv-123456"
"Crie um banco de dados Postgres e uma instância Redis para meu aplicativo"

Desenvolvimento

Compilando a partir do Código-Fonte

git clone https://github.com/niyogi/render-mcp.git
cd render-mcp
npm install
npm run build

Executando Testes

npm test

Licença

MIT

Render

Documentação