Servidor MCP de FlyEnv
FlyEnv incluye un servidor MCP integrado que permite a los asistentes de codificación con IA operar tu stack local — listar y controlar servicios, inspeccionar registros y configuraciones, leer detalles de conexión de sitios y bases de datos — a través de una interfaz controlada. El servidor habla MCP sobre Streamable HTTP en 127.0.0.1:7682 por defecto, se autentica con un token Bearer y expone 18 herramientas con políticas de aprobación por herramienta. Cada llamada queda registrada en un Registro de auditoría, de modo que siempre sabes lo que hizo un asistente. La guía del espacio de trabajo de codificación con IA muestra la configuración completa en un proyecto real.
Opciones del servicio
El servidor se ejecuta dentro de la propia aplicación FlyEnv, así que no hay nada que instalar: la pestaña Servicio solo controla cómo escucha y cuándo se inicia.
- Host y puerto de escucha: la dirección por defecto es
127.0.0.1:7682; el puerto acepta cualquier valor entre 1024 y 65535. La escucha en direcciones no loopback se rechaza a menos que actives explícitamente el acceso remoto, lo que primero muestra un diálogo de advertencia. - Autenticación con token Bearer: los clientes deben presentar el token generado en cada petición. Regenéralo con un clic para revocar de golpe todos los clientes existentes.
- Inicio automático al abrir: el servidor puede arrancar automáticamente cada vez que se abre FlyEnv, para que tus asistentes nunca apunten a un endpoint muerto.
- Servicio independiente: el Servidor MCP de FlyEnv está excluido del grupo global de «iniciar todo», de modo que arrancar todo tu stack nunca activa la interfaz de IA sin querer.
- Puente stdio: para los clientes que prefieren stdio, FlyEnv copia un script puente
flyenv-mcp-stdio.mjsen su directorio de datos, listo para ser ejecutado por un runtime Node.js externo.
Configuración de clientes
La pestaña Configuración de clientes conecta el servidor con las seis herramientas CLI de IA que FlyEnv ya gestiona: Claude Code, Antigravity CLI, Codex, GitHub Copilot CLI, OpenCode y Kimi.
- Registro con un clic: un botón «Añadir al cliente» por herramienta escribe la entrada del servidor
flyenvdirectamente en la configuración MCP de ese CLI — sin editar archivos a mano, ya sea el cliente Codex, OpenCode o Kimi. - Fragmentos listos para copiar: bloques JSON o TOML preparados en las variantes HTTP y stdio, para pegar en clientes que configures tú mismo o en herramientas fuera de la gestión de FlyEnv.
- Combinado con los CLI gestionados: cada uno de estos asistentes tiene su propio módulo en FlyEnv — consulta Claude Code como ejemplo de la gestión de instalación, sesiones y plugins que reciben.
Herramientas
La pestaña Herramientas lista las 18 herramientas que expone el servidor y decide cuáles de ellas puede usar un asistente.
- Herramientas de lectura — inventario e inspección:
list_services,service_status,list_sites,resolve_site_runtime,resolve_site_urls,get_database_connection_info,get_service_exec_info,get_managed_file_map,list_log_files,list_config_filesylist_online_versions. - Herramientas de acción — cambios en tu entorno:
start_service,stop_service,restart_service,create_site,update_site,delete_siteyinstall_service. - Interruptor por herramienta: desactiva cualquier herramienta individual para eliminarla por completo de lo que los clientes pueden llamar.
- Políticas de aprobación para herramientas de riesgo: las 7 herramientas de ciclo de vida, escritura de sitios e instalación llevan cada una una política auto/confirmar — el valor por defecto es confirmar, de modo que las operaciones sensibles esperan tu aprobación a menos que decidas relajarla.
Registro de auditoría
La pestaña Registro de auditoría es un visor en vivo sobre audit.log en el directorio de datos MCP de FlyEnv — un registro en formato JSON Lines de cada llamada a herramienta que procesa el servidor.
- Historial completo de llamadas: cada entrada captura qué herramienta se ejecutó y con qué parámetros, dándote un rastro revisable de todo lo que tus asistentes de IA han tocado — contexto esencial cuando trabajas con asistentes de IA a diario.
- Enmascaramiento de secretos: los tokens y contraseñas se enmascaran antes de llegar al registro, de modo que revisar o compartir el archivo no filtra credenciales.
Guías, soluciones y demos relacionados
Continúa con una guía práctica, una solución, una demo o una perspectiva de la comunidad.
Notas de compatibilidad
El Servidor MCP de FlyEnv se ejecuta en el proceso principal de la aplicación, lo que define sus límites estrictos: solo existe mientras FlyEnv está en ejecución, así que al cerrar la aplicación el endpoint se cae para todos los clientes conectados. Se comporta igual en macOS, Windows y Linux, sin diferencias específicas de plataforma. El puente stdio depende de un runtime Node.js externo para ejecutar el script flyenv-mcp-stdio.mjs generado. El acceso remoto permanece desactivado a menos que lo actives deliberadamente — escuchar en cualquier dirección que no sea loopback requiere la activación explícita y pasa por un diálogo de advertencia.