Puente MCP local

Usa Local MCP Bridge cuando un editor o agente externo en la misma Mac deba trabajar con Genie como workbench de FileMaker.

Local MCP Bridge requiere Coding Access. AGENT integrado conserva sus capacidades gratuitas de lectura y la ejecución confirmada de un script existente sin habilitar el servidor externo.

Local MCP no es un canal oculto de apply. Expone un servidor localhost protegido por bearer token para que clientes de confianza puedan leer contexto, usar herramientas acotadas y preparar trabajo revisable en Genie. La antigua beta de creacion automatica de scripts esta archivada y ya no esta disponible.

Donde activarlo

Abre Guia de ajustes y configura Local MCP Bridge.

Puedes controlar:

• Enable Local MCP Bridge
• Port
• Status
• Setup guide
• Copy snippet

La guia de configuracion puede mostrar Codex Streamable HTTP, Cursor/generic JSON, endpoint URL o bearer token. La vista previa visible enmascara el token cuando corresponde; las acciones de copia usan el token local real.

Flujo recomendado para agentes

Los agentes externos deberian usar el puente en este orden:

1. Usa fm_session action:status cuando haga falta la identidad de la sesion.
2. Busca guias, esquemas y definiciones con fm_search y una query no vacia, o lee recursos genie://.... Los resultados de busqueda nunca son autoridad para un destino en vivo.
3. Usar fm_session para confirmar archivos abiertos y el documento normal que esta realmente en primer plano, informado por separado del contexto de calculo del plugin. Un calculationContextFileName no vacio que nombra un archivo abierto basta para lecturas en vivo (metadatos, contenido de script, hooks) aunque FileMaker no este en primer plano; no tratar calculationContextMatchesForeground:false solo como un bloqueo de lectura cuando FileMaker simplemente no es la app activa. activate es un enfoque de UI opcional y solo es una operacion nula cuando el archivo solicitado es propietario de ese documento; Script Workspace nunca cuenta. En caso contrario, Genie usa el propietario nativo cuando esta disponible. FileMaker 26 puede exponer un titulo Cocoa sin propietario como <valor WindowNames> (<cuenta>); Genie solo lo acepta cuando compararlo con WindowNames(file) de cada archivo abierto resuelve un unico propietario, por lo que las colisiones con ventanas renombradas fallan de forma segura. Fallar cerrado solo cuando falta el contexto de calculo, entra en conflicto con el archivo solicitado, o un documento en primer plano confirmado diverge del contexto de calculo (foreground_file_context_not_rebound).
4. Usa fm_read con un destino y una identidad exactos para scripts y metadatos; una identidad ausente o ambigua falla de forma segura.
5. Usa fm_search para descubrimiento y fm_read target:selection para preparar una seleccion exacta de metadatos.
6. Usa fm_evaluate con una expression para comprobar un calculo. Usa fm_stage kind=script|layout action=validate|compile_preview para comprobar un artefacto sin ponerlo en cola; solo action=stage crea un item de Workbench.
7. Usar fm_query solo para filas SELECT de solo lectura.
8. Pon exactamente un item en cola con fm_stage kind=script|data|layout.
9. Pedir al usuario que revise el item en Genie Workbench.

La ejecucion ocurre despues desde la UI de Genie. El usuario revisa, copia, ejecuta o elimina el item; la llamada MCP por si sola no modifica FileMaker.

Recursos que expone Genie

Recursos principales:

• genie://schemas/script-schema
• genie://schemas/script-catalog
• genie://schemas/layout-schema
• genie://context/project
• genie://context/scripts
• genie://session/files
• genie://session/open-files-metadata
• genie://metadata/all
• genie://metadata/selected
• genie://metadata/relationships
• genie://metadata/relationship-graph

genie://context/project incluye el nombre efectivo del proyecto, descripcion, reglas activadas, convenciones de nombres, patrones reutilizables, plantilla de script y guidance_sources para mostrar si cada campo heredado viene de Project o Generic Personalization. Esta guia puede orientar nombres, comentarios, patrones y estructura de scripts, pero nunca amplia herramientas, staging Workbench, Apply, alcance Stage A/B ni autoridad de mutacion.

Guias:

• genie://guides/delta-edit-workflow
• genie://guides/metadata-selection
• genie://guides/stage-contract
• genie://guides/relationships-and-data
• genie://guides/what-not-to-stage
• genie://guides/layout-design

Usa fm_search con una query no vacia cuando el cliente expone herramientas pero no recursos MCP.

Herramientas MCP actuales

Herramienta	Uso	Limite
fm_session	Estado, archivos abiertos, destino activo, contexto del proyecto y refresh explicito.	Solo contexto; no muta FileMaker.
fm_search	Descubrimiento de guias, esquemas, pasos, funciones y pruebas de layout.	Requiere query; nunca da autoridad sobre un destino vivo.
fm_read	Evidencia exacta en vivo de un script o destino de metadatos.	Requiere identidad exacta y falla cerrado si falta.
fm_query	Filas SELECT de solo lectura.	No descubre el esquema.
fm_evaluate	Evaluacion de calculos FileMaker.	Sandbox de calculo solamente; no valida artefactos ni crea items.
fm_stage	Validacion, compile-preview o cola de script/layout; cola de un item DATA.	validate/compile_preview no crean items; solo stage crea un item de Workbench.
fm_workbench	Inspección, eliminación de cola, ChangeSets atómicos y verify_apply.	Apply y DATA Execute siguen en la UI de Genie.
fm_run	Inicio de un script existente exacto y lectura de estado.	Cada inicio exige una confirmación nativa nueva.

Que puede prepararse

Lane	Preparalo cuando	Limites importantes
Script: nuevo	Crear un solo script FileMaker.	Usa fm_stage kind:script con Script Schema y result_type: "new_script".
Script: editar	Editar un script nombrado usando contenido exacto en vivo o adjunto.	Lee con fm_read target:script y usa fm_stage kind:script.
DATA	Preparar una solicitud SQL/schema o plan de migracion admitido.	Usa fm_stage kind:data; inspecciona destinos exactos primero.
Objetos de layout	Preparar objetos copy-only para pegar en FileMaker.	Usa fm_stage kind:layout; no aplica layouts en el host.

Las preguntas y la planificación permanecen en el IDE o AGENT. Query usa fm_query fuera de Workbench.

Klai y BetterForms

En Settings > Advanced > Agent / MCP, activa Activar la integracion de Klai para mostrar las herramientas Klai de conjuntos de hooks y funciones personalizadas, y exponer recursos y guias de Klai/BetterForms. El ajuste sigue disponible aunque Local MCP este desactivado. Las herramientas se actualizan de inmediato; vuelve a conectar el cliente MCP para actualizar su indice de guias.

Configuracion del IDE

Para Codex, usa Streamable HTTP en ~/.codex/config.toml:

# Genie usa Streamable HTTP. No configures stdio para este puente.
[mcp_servers.genie_filemaker]
enabled = true
url = "http://127.0.0.1:3845/mcp"

[mcp_servers.genie_filemaker.http_headers]
Authorization = "Bearer <generated-token>"

Para Cursor o clientes MCP JSON genericos:

{
  "mcpServers": {
    "genie_filemaker": {
      "url": "http://127.0.0.1:3845/mcp",
      "headers": {
        "Authorization": "Bearer <generated-token>"
      }
    }
  }
}

Paginas relacionadas

• Workbench
• Modo AGENT
• Guia de ajustes
• Usar MCP con tu IDE web
• Troubleshooting por funcionalidad