Configuración del servidor MCP¶

El proyecto generado desde la plantilla de Flexygo ya trae la configuración necesaria. No hace falta tocarla para empezar.

El fichero `.mcp.json`¶

En la raíz del proyecto, .mcp.json le dice a Claude Code cómo arrancar el servidor:

JSON

{
  "mcpServers": {
    "flexygo": {
      "command": "flexygo-mcp",
      "env": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

command es la herramienta global flexygo-mcp, instalada con el .NET 10 SDK (ver Prerrequisitos).
ASPNETCORE_ENVIRONMENT decide qué appsettings del Backend se leen. Con Development, se lee appsettings.Development.json.

El fichero .claude/settings.json del proyecto deja el servidor flexygo activado, para que Claude Code no tenga que preguntarlo cada vez.

Diseño con Google Stitch

La plantilla trae también una entrada stitch en .mcp.json, que usa /flx-design para dibujar las pantallas. Necesita la variable de entorno STITCH_API_KEY. Si no la usas, no estorba.

Las bases de datos¶

El servidor no tiene conexiones propias: lee ConfConnectionString y DataConnectionString del appsettings del Backend del proyecto. Si no están configuradas, /flx-setup te guía para crear o elegir las bases de datos y escribirlas.

Telemetría de errores¶

Los errores de las herramientas del servidor se registran en un recolector del propio equipo. La variable de entorno FLEXYGO_MCP_ERROR_TELEMETRY los envía a otro recolector, o los apaga con off. Consulta Telemetría de errores.

Comprobaciones de seguridad¶

El servidor toma algunas direcciones de ficheros que viajan con el proyecto, como launchSettings.json o appsettings.json. Un proyecto clonado podría traerlas cambiadas, así que el servidor las comprueba antes de usarlas:

Direcciones de la aplicación. El panel, el tablero y el script tools/app.ps1 solo usan una dirección http o https de este equipo (localhost, 127.0.0.1 o [::1]). De ella solo se toman el esquema, el equipo y el puerto. Cualquier otra cosa se ignora y no se abre ni se arranca nada con ella: un esquema como file:, una dirección de otro equipo o texto añadido detrás de la dirección.
Recarga de la caché. Para recargar la caché de la aplicación, el servidor inicia sesión con tu usuario y contraseña. Si el Backend está en este equipo, lo hace sin preguntar. Si está en otro equipo, no envía nada: el agente te dice el nombre exacto de ese equipo y te pregunta si quieres enviarle tus credenciales. Solo con tu sí, y solo a ese equipo, inicia sesión. Con el Backend en este equipo, puede usar la contraseña del usuario de pruebas guardada en *.InterfaceTest/appsettings.local.json, siempre que git ignore ese fichero; nunca la repite ni la escribe en ningún sitio, y si no está o no vale, te la pide.
Ficheros protegidos. El agente no puede leer ni imprimir el fichero con las contraseñas de los usuarios de prueba (*.InterfaceTest/appsettings.local.json): se le dice qué usar en su lugar. Tampoco puede escribir desde la consola dentro de .flexygo/, que solo escriben las herramientas del servidor.
Secretos en git. El estado del proyecto avisa si un conf/appsettings*.json que sigue git guarda secretos, sin enseñar nunca su valor.