Cómo conectar Fine Structure a Claude Code con MCP

Guía para personas no técnicas que quieren que Claude Code construya, pruebe y mejore aplicaciones de Fine Structure mediante MCP.

Claude Code puede trabajar con Fine Structure como un compañero de equipo que conoce el sistema: puede leer la estructura de la aplicación, entender los archivos, proponer cambios, ejecutar pruebas del sistema y solicitar la publicación solo cuando tiene el permiso adecuado. La conexión se realiza mediante MCP, es decir, con un token controlado y no con una contraseña personal.

Qué te aporta: Puedes pedirle a Claude Code que construya una pantalla nueva, corrija un error, revise una versión antes de publicarla o prepare un cambio para un cliente, sin copiar archivos del sistema manualmente.

Para quién es: Para dueños de negocios, agencias y responsables de producto que quieren que un agente de IA trabaje sobre el producto dentro de límites claros.

Qué tan seguro es: El token está limitado por aplicación y por permisos. Puedes crear uno Read only para revisar, Build para trabajar, o Full access solo cuando confías en el agente.

Primer paso: crear un token MCP

Abre la página de MCP, crea un token nuevo y copia el valor que empieza por fse2_mcp_. Sin el token, Claude Code no puede acceder a tu cuenta de Fine Structure.

Pasos sencillos

• Inicia sesión en tu cuenta de Fine Structure.
• Abre la página de MCP con el botón Create MCP token de la documentación, o directamente desde /mcp.
• Elige si el agente tendrá acceso a todas las aplicaciones de tu propiedad o solo a una.
• Elige los permisos: Read only para revisar, Build para editar, Full access solo para un agente en el que confías.
• Pulsa Create MCP setup y copia el token o el bloque de configuración. El token se muestra una sola vez.
• Abre una Terminal en la carpeta del proyecto en la que trabajas con Claude Code.
• Pega el comando de abajo y sustituye fse2_mcp_<token> por tu token.
• Abre Claude Code y escribe /mcp para comprobar que el servidor fine-structure está conectado.

claude mcp add --transport http fine-structure https://finestructure.ai/api/mcp --header "Authorization: Bearer fse2_mcp_<token>"

{
  "mcpServers": {
    "fine-structure": {
      "type": "http",
      "url": "https://finestructure.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer fse2_mcp_<token>"
      }
    }
  }
}

Qué decirle a Claude después de la conexión

• Pídele al agente: "Use the Fine Structure MCP and call get_platform_guide first."
• Si trabajas sobre una aplicación existente, indícale también el nombre de la aplicación o el app_id.
• Antes de publicar o de hacer un cambio importante, pídele al agente que ejecute validate_app e inspect_preview.
• Si la conexión falla, crea un token nuevo en /mcp y revoca el anterior para no dejar accesos abiertos.

Consejo de marketing interno: Si eres una agencia, crea un token bloqueado a una sola aplicación por cada cliente. Así Claude Code recibe exactamente el proyecto correspondiente y no toda la cuenta.