Integración con clientes de IA (Integración IDE)

ServBay permite conectar su servidor MCP incorporado con tus clientes de IA favoritos con un solo clic, escribiendo automáticamente la configuración MCP correspondiente para cada cliente, sin necesidad de editar archivos manualmente. Este artículo explica cómo integrarlo, qué clientes son compatibles y el método de integración para cada uno.

Requisitos previos

• ServBay debe estar instalado y en funcionamiento.
• El cliente de IA deseado debe estar instalado (ServBay determina la posibilidad de integración según la configuración).

Integración con un solo clic

Ingresa en Configuración de ServBay → Integraciones con clientes de IA (IDE Integrations). Selecciona tu cliente en la lista y haz clic en Integrar (Integrate). ServBay realizará lo siguiente:

1. Ubica el ejecutable servbay-mcp incluido en la distribución (no necesitas instalarlo por separado).
2. Escribe la configuración MCP según el formato requerido por el cliente correspondiente (añadiendo o actualizando solo el nodo servbay, sin modificar otras configuraciones MCP existentes).
3. Muestra el estado de la integración.

Para revocar la integración, simplemente haz clic en Eliminar (Remove).

Estado de integración

Cada cliente muestra su estado de integración respecto a “esta instancia local de ServBay”:

Estado	Significado
Integrado	El cliente apunta al ejecutable servbay-mcp de esta máquina/local ServBay.
Integrado (otra ruta)	El cliente tiene configurado servbay, pero apunta a otra ruta (por ejemplo, otro ServBay).
No integrado	El cliente está detectado, pero aún no está integrado.
No detectado	El cliente no ha sido encontrado en tu sistema.

Clientes soportados y métodos de integración

Cliente	Método de integración	Ubicación de configuración
Claude Code	CLI oficial: claude mcp add --scope user --transport stdio servbay -- <bin>	Configuración MCP de usuario Claude Code
Codex	CLI oficial: codex mcp add (si CLI no está disponible, escribe en ~/.codex/config.toml)	Configuración de Codex
Cursor	Escribe en ~/.cursor/mcp.json (clave superior mcpServers)	~/.cursor/mcp.json
VS Code / GitHub Copilot	Escribe en mcp.json de usuario (clave superior servers, type: stdio)	mcp.json de usuario de VS Code
Claude Desktop	Escribe en claude_desktop_config.json (clave superior mcpServers)	claude_desktop_config.json

Diferencias en el esquema de configuración

Las claves superiores en la configuración MCP varían según el cliente: VS Code utiliza servers, mientras que Cursor / Claude Desktop usan mcpServers. ServBay escribirá automáticamente la clave correcta según los requisitos de cada cliente; no necesitas preocuparte por estas diferencias.

Verificar integración

Tras la integración, realiza una solicitud relacionada con el entorno en el cliente de IA correspondiente (por ejemplo, “listar los servicios actualmente activos en ServBay”). Si la IA retorna una lista real de servicios, la integración ha sido exitosa.

Preguntas frecuentes (FAQ)

• P: ¿La integración sobrescribirá mi configuración MCP actual?
  • R: No. ServBay solo añade o actualiza el nodo servbay y mantiene el resto de tus servidores MCP.
• P: ¿Qué significa que el cliente muestre “No detectado”?
  • R: Significa que ese cliente no se ha encontrado en tu máquina. Instálalo y ejecútalo al menos una vez antes de intentar la integración.
• P: ¿Por qué falla la IA tras la integración?
  • R: Asegúrate de que ServBay está en funcionamiento. Para Claude Code / Codex, que utilizan integración por CLI, comprueba que el CLI oficial está disponible. Intenta eliminar y volver a integrar si es necesario.
• P: ¿Qué se recomienda hacer después de la integración?
  • R: Instala las reglas de IA para guiar a la IA a utilizar ServBay MCP de manera óptima y prioritaria.

Resumen

Gracias a la función de “Integraciones de clientes de IA”, puedes conectar ServBay MCP con las principales herramientas de IA sin editar configuraciones manualmente ni afectar tus ajustes actuales. Tras la integración, y junto con las reglas de IA, la IA podrá administrar tu entorno local de desarrollo de manera fluida.