Integração com Clientes de IA (IDE Integration)

O ServBay permite conectar seu MCP Server integrado com apenas um clique aos seus principais clientes de IA, inserindo automaticamente a configuração MCP adequada, sem necessidade de editar arquivos manualmente. Este guia explica como integrar, quais clientes são suportados e os métodos de integração para cada um.

Pré-requisitos

• ServBay instalado e em execução.
• Cliente de IA alvo já instalado (o ServBay verifica a possibilidade de integração com base na configuração do cliente).

Integração com um clique

Acesse Configurações do ServBay → Integrações com Clientes de IA (IDE Integrations), localize o cliente desejado na lista e clique em Integrar (Integrate). O ServBay irá:

1. Localizar o executável servbay-mcp incluído na distribuição (não é necessário instalar separadamente).
2. Escrever a configuração MCP conforme o padrão do cliente-alvo (adiciona/atualiza apenas o item servbay — mantendo suas outras configurações MCP existentes).
3. Exibir o status da integração.

Para desfazer a integração, basta clicar em Remover (Remove).

Status de Integração

Cada cliente exibirá seu status de integração em relação a esta instância local do ServBay:

Status	Significado
Integrado	O cliente está apontando para o servbay-mcp desta máquina
Integrado (outro caminho)	O cliente está configurado com servbay, mas aponta para outro caminho (por exemplo, outra instalação do ServBay)
Não Integrado	Cliente detectado, mas ainda não integrado
Não Detectado	Cliente não encontrado na máquina

Clientes suportados e métodos de integração

Cliente	Método de integração	Local de configuração
Claude Code	CLI oficial: claude mcp add --scope user --transport stdio servbay -- <bin>	Configuração MCP no modo usuário do Claude Code
Codex	CLI oficial: codex mcp add (se CLI indisponível, escreve em ~/.codex/config.toml)	Configuração Codex
Cursor	Escreve em ~/.cursor/mcp.json (chave superior mcpServers)	~/.cursor/mcp.json
VS Code / GitHub Copilot	Escreve na mcp.json do usuário (chave superior servers, type: stdio)	mcp.json do usuário, VS Code
Claude Desktop	Escreve em claude_desktop_config.json (chave superior mcpServers)	claude_desktop_config.json

Diferença de schemas de configuração

Os clientes de IA utilizam diferentes chaves superiores para a configuração MCP: VS Code usa servers, enquanto Cursor / Claude Desktop trabalham com mcpServers. O ServBay seleciona automaticamente a chave correta de acordo com o padrão de cada cliente, então você não precisa se preocupar com esses detalhes.

Validando a integração

Após a integração, faça uma solicitação relacionada ao ambiente no cliente de IA correspondente (por exemplo, "listar serviços atualmente em execução no ServBay"). Se a IA retornar a lista de serviços real, a integração foi bem-sucedida.

Perguntas Frequentes (FAQ)

• P: Integrar vai sobrescrever minhas configurações MCP existentes?
  • R: Não. O ServBay apenas adiciona/atualiza o item servbay e mantém suas demais configurações de Servidor MCP.
• P: O cliente mostra "Não Detectado"?
  • R: O cliente não foi encontrado na máquina. Instale e execute o cliente ao menos uma vez antes de tentar a integração.
• P: Após integrar, a IA não se conecta?
  • R: Confira se o ServBay está rodando; para Claude Code/Codex via CLI, confirme que o CLI está funcional. Tente remover e reintegrar o cliente.
• P: O que é recomendado após integrar?
  • R: Recomendamos instalar a Regra de IA para orientar a IA a utilizar o ServBay MCP corretamente e com prioridade.

Resumo

Com a "Integração com Clientes de IA", você conecta facilmente o ServBay MCP aos principais clientes de IA, sem precisar mexer nas configurações manualmente e sem afetar ajustes existentes. Após a integração, instale também a Regra de IA para permitir que a IA gerencie seu ambiente de desenvolvimento local de forma fluida e eficiente.