Solución de problemas específicos de funciones

Resuelve problemas relacionados con tareas o funciones concretas de Genie.

Una función de pago no está disponible

Síntomas: Genie da pasos legibles pero no Create ni Apply, o no está disponible una acción de layout, de datos, del modo Aplicación automática o de Workbench.
Causa: estas acciones requieren un plan de pago, y este ordenador está en el plan Gratis o su activación no está activa.
Solución: abre Settings > General y revisa tu plan y tu clave de activación. Consulta Licencias y activación.

Síntomas: los logs del IDE muestran invalid_http_request en streamable HTTP, Non-200 (400) en SSE fallback o fallos repetidos de conexión del cliente.
Causa: endpoint o ruta MCP incorrectos, falta la cabecera bearer auth o Local MCP Bridge está desactivado.
Solución:
1. En Settings > Local MCP, confirma que Local MCP Bridge está activado y en marcha.
2. Comprueba que la configuración de tu IDE usa la ruta /mcp, no la raíz.
3. Comprueba que está presente Authorization: Bearer <token>.
4. Vuelve a copiar el fragmento de configuración actual desde Settings > Local MCP.
5. Asegúrate de que host y puerto coinciden con Genie (127.0.0.1 y el puerto configurado).

Síntomas: Claude Desktop arranca pero no aparecen las herramientas ni los recursos de Genie, o los logs de Claude muestran que un servidor stdio se cerró.
Causa: Claude Desktop no puede usar directamente el endpoint Streamable HTTP local de Genie desde claude_desktop_config.json; necesita el fragmento del puente stdio para Claude Desktop.
Solución:
1. En Settings > Local MCP, elige Claude Desktop (stdio bridge).
2. Copia el fragmento en la configuración de desarrollador de Claude Desktop.
3. Confirma que npx puede ejecutar mcp-remote@latest.
4. Mantén Genie abierto con Local MCP activado y reinicia Claude Desktop.

Síntomas: Cursor, Codex, Claude u otro cliente MCP envía fmxmlsnippet para peticiones de script en lenguaje normal.
Causa: la preparación de scripts debe usar Script Schema con fm_stage kind:script. El XML es para peticiones que ya incluyen un XML completo de script o de pasos.
Solución:
1. Pide al agente que vuelva a llamar a fm_session.
2. Para un script nuevo, usa fm_search para encontrar Script Schema y los pasos necesarios, y llama a fm_stage kind:script con result_type: "new_script".
3. Para una edición, lee el contenido exacto con fm_read target:script (o genie://context/scripts) y llama a fm_stage kind:script con result_type: "delta_edit". merge_ready:false no bloquea la preparación.
4. Usa fmxmlsnippet solo cuando la petición incluye un XML completo de script o de pasos.

Síntomas: un cliente MCP dice que Genie necesita metadatos para palabras como URL, API, JSON o el nombre de un servicio externo como Asana.
Causa: los metadatos solo hacen falta para referencias reales de FileMaker. Las palabras sobre un servicio externo no son metadatos de FileMaker.
Solución:
1. Pide al agente que vuelva a preparar la petición de script con fm_stage kind:script.
2. Usa fm_read target:selection solo cuando la petición nombra tablas, campos, layouts, scripts, funciones personalizadas, listas de valores o referencias de esquema ExecuteSQL de FileMaker concretas.
3. Deja fm_query para consultas SELECT de solo lectura, no para generar un script con Insert from URL.

Síntomas: un cliente MCP intenta conocer listas de campos o relaciones lanzando consultas SELECT.
Causa: fm_query solo sirve para leer filas de datos.
Solución:
1. Usa fm_read con un destino exacto table, field, layout o relationship_summary para leer la estructura.
2. Usa fm_query solo cuando ya conoces el esquema y la petición necesita filas de datos.
3. Para cambios de datos, pasa un conjunto metadata_selection de fm_read target:selection a fm_stage kind:data.

Síntomas: Genie hace una pregunta concreta en lugar de dar un script o una respuesta final.
Causa: Genie no pudo determinar la intención, el destino, los metadatos necesarios, el alcance de un cambio destructivo o si el cambio se puede aplicar.
Solución:
1. Responde a la pregunta en el chat.
2. Nombra el script de destino en tu petición o selecciona las referencias pertinentes en Metadata Explorer. Genie lee el contenido exacto del script cuando hace falta.
3. Si faltan metadatos, actualiza o selecciona los elementos correspondientes en Metadata Explorer.

Síntomas: aparece un diálogo para guardar, pero el archivo no se escribe o queda vacío.
Causa: falta permiso de escritura en la carpeta de destino o hubo un error temporal al preparar los datos.
Solución:
1. Vuelve a ejecutar la consulta o el gráfico una vez.
2. Elige una carpeta local con permiso de escritura, como Documentos o Escritorio.
3. Comprueba que tu ordenador tiene espacio libre suficiente.

Síntomas: el chat muestra un desajuste de placeholders o parámetros y el cambio no se ejecuta.
Causa: el número de placeholders SQL no coincide con los valores proporcionados.
Solución:
1. Pide a Genie que prepare el SQL de nuevo con valores literales cuando tenga sentido.
2. O pide una lista completa de parámetros que coincida exactamente con los placeholders.
3. Ejecuta el cambio solo cuando haya desaparecido el aviso.

Síntomas: el chat bloquea una petición CREATE INDEX.
Causa: FileMaker gestiona la indexación con las opciones de almacenamiento de los campos, así que Genie no ejecuta CREATE INDEX.
Solución:
1. Quita CREATE INDEX de la petición.
2. Gestiona la indexación en las opciones de almacenamiento del campo en FileMaker.
3. Vuelve a pedir el resto de cambios de esquema o de datos.

Síntomas: las filas de Your own agent aparecen en gris, el pie bajo el compositor dice Local connection off, o una respuesta falla con un mensaje sobre el motor.
Causa: Local MCP está desactivado o no funciona, el Privacy Mode de Local MCP está activado, el programa no está instalado o no tiene la sesión iniciada, o está desactualizado. Estos mensajes no tienen código numérico.
Solución: haz clic en Turn on si lo ves, desactiva el Privacy Mode de Local MCP, o usa Install, Connect o Update en la tarjeta de Settings > Models. Cada mensaje y su remedio están en Claude Code y Codex.