Introdução ao ServBay MCP Server
O ServBay MCP Server é um servidor integrado ao ServBay, baseado no Model Context Protocol (MCP). Com ele, ferramentas de IA que suportam MCP, como Claude, Cursor e VS Code, podem literalmente “ver” e “controlar” seu ambiente de desenvolvimento local ServBay—consultando o status de serviços, gerenciando sites e domínios, operando bancos de dados, emitindo certificados, criando backups, lendo logs e indicadores do sistema—sem que você precise alternar o tempo todo entre o chat e a interface do ServBay.
Este artigo apresenta o que é o ServBay MCP Server e o que ele pode fazer. Para saber como conectar e usar regras de IA, consulte:
- Integração com Cliente de IA (IDE Integration) — Conecte facilmente o MCP ao Claude Code / Cursor / VS Code e outros IDEs compatíveis
- Regras de IA (AI Rule) — Garanta que a IA use o ServBay MCP de forma correta e segura
O que é MCP
O Model Context Protocol (MCP) é um protocolo aberto que permite que aplicações de IA se conectem a ferramentas externas e fontes de dados de forma padronizada. O ServBay encapsula suas capacidades de gerenciamento de ambiente em um MCP Server, permitindo que qualquer cliente de IA compatível utilize as funcionalidades do ServBay.
O MCP Server é distribuído junto com o ServBay, rodando localmente como um processo (usando comunicação padrão via stdio). A inicialização é feita sob demanda pelo cliente de IA—sem necessidade de instalação ou deploy extras.
O que o ServBay MCP faz
O ServBay MCP Server oferece acesso a todas as principais funções de gerenciamento do ServBay:
- Ambiente & Assinaturas — Consulta de informações do ambiente, status de assinaturas/planos e execução de diagnósticos.
- Informações e Métricas do Sistema — Acesso a informações e indicadores em tempo real de CPU, memória, disco, rede, etc. (Veja mais em Informações e Métricas do Sistema).
- Gerenciamento de Serviços — Listagem e consulta de status, inicialização/parada/reinício de PHP, Node.js, MySQL, MariaDB, PostgreSQL, Redis, Memcached, Mailpit, MinIO, Ollama e muito mais.
- Configuração e Logs de Serviços — Leitura e escrita de configurações, além de acesso aos logs de serviços.
- Sites e Domínios — Listagem, visualização, criação, atualização e exclusão de sites locais, ativação/desativação de sites, gerenciamento de registros hosts e domínios dnsmasq.
- Portas — Verificação de uso de portas.
- Certificados TLS/HTTPS — Listar, emitir, reemitir e deletar certificados.
- Bancos de Dados — Listar bancos de dados, criar novos, definir ou redefinir senhas.
- Pacotes de Software — Listagem de pacotes instalados e disponíveis, instalação, remoção, ativação/desativação, alternância de versões.
- Modelos Ollama — Listar ou remover modelos Ollama locais.
- Backups — Listar, criar, restaurar e excluir backups, além de consultar cronogramas de backup.
Com esses recursos, você pode, por exemplo, pedir ao seu assistente de IA: “Inicie o PHP 8.3 e crie um novo site para mim”, “Emita um certificado para este domínio”, ou até “Leia os logs de erro do MySQL”—tudo automatizado via MCP pelo ServBay.
Segurança
- O MCP Server opera apenas localmente, comunicando-se por stdio com clientes de IA que estejam no mesmo computador.
- Para operações de escrita ou potencialmente destrutivas (como deletar sites, redefinir senha de banco de dados ou restaurar backups), recomenda-se que a IA sempre detalhe as alterações antes e aguarde sua confirmação antes de prosseguir.
- Nunca cole chaves, tokens de acesso, DNS API Keys, senhas de bancos de dados ou chaves privadas em chats—o design do ServBay MCP não exige compartilhamento manual de informações sensíveis.
- Usar em conjunto com as Regras de IA torna o uso do ServBay MCP pela IA ainda mais seguro e eficiente.
Pré-requisitos
- ServBay instalado e em execução (compatível com macOS ou Windows).
- Ter um cliente de IA compatível com MCP (como Claude Code, Cursor, VS Code + Copilot, Claude Desktop, Codex, etc.).
Próximos Passos
- Vá até Integração com Cliente de IA e conecte o ServBay MCP à sua ferramenta de IA com apenas um clique.
- Instale as Regras de IA para garantir que a IA gerencie o ServBay MCP de maneira prioritária e correta.
Resumo
O ServBay MCP Server expande as capacidades de gerenciamento de ambiente do ServBay para ferramentas de IA, tornando possível administrar todo o seu ambiente de desenvolvimento local usando linguagem natural. É distribuído com o ServBay, integrado em um clique, sem necessidade de deploys extras, e é elemento essencial para o desenvolvimento IA-nativo com o ServBay.
