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 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. Tambien incluye un ajuste beta explicito para clientes de confianza que pueden ejecutar automaticamente el flujo Create Script de Genie para stages de script compatibles.

Donde activarlo

Abre Guia de ajustes y configura Local MCP Bridge.

Puedes controlar:

• Enable Local MCP Bridge
• Automatically create scripts in FileMaker (beta)
• 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.

Beta: crear scripts automaticamente en FileMaker

El ajuste beta Automatically create scripts in FileMaker es solo para automatizacion local de confianza. Cuando esta activo, un cliente MCP conectado con el bearer token actual puede enviar stages de script compatibles y Genie ejecuta inmediatamente el flujo Create Script existente.

Limites importantes:

• El flujo pasa por Create Script en Genie; no es una herramienta de mutacion oculta aparte.
• Los scripts existentes nunca se reemplazan. Las ediciones crean una nueva version.
• Todo cliente Local MCP autenticado con el token actual puede usar esta beta mientras este activada.
• Desactivala cuando no estes trabajando con un agente de confianza que deba crear scripts inmediatamente.

Workbench conserva las secciones Pending y Submitted para que puedas inspeccionar el historial del handoff y las advertencias.

Flujo recomendado para agentes

Los agentes externos deberian usar el puente en este orden:

1. Llamar a genie_get_capabilities.
2. Leer las guias relevantes con recursos genie://guides/* o genie_get_guides, y la guia efectiva del proyecto mediante genie://context/project o la referencia compatible project_context.
3. Usar genie_files para confirmar archivos abiertos o el archivo activo.
4. Usar genie_scripts para contexto de scripts, contenido acotado, Script Schema, pasos, funciones, validacion, preview de compilacion o staging de scripts.
5. Usar genie_metadata para tablas, ocurrencias, campos, layouts, relaciones, describe dirigido y parse_selection.
6. Usar genie_evaluate para comprobar calculos FileMaker sin efectos secundarios.
7. Usar genie_query solo para filas SELECT de solo lectura.
8. Preparar DATA con genie_stage_data o objetos de layout copy-only con genie_stage_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 normalmente no modifica FileMaker. Si la beta Automatically create scripts in FileMaker esta activada, los stages de script compatibles desde clientes locales autenticados pueden ejecutar inmediatamente el flujo Create Script revisado.

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 genie_get_guides cuando el cliente expone herramientas pero no recursos MCP.

Herramientas MCP actuales

Herramienta	Uso	Limite
genie_get_capabilities	Contrato MCP actual, rutas y limites.	Llamala temprano.
genie_files	Listar archivos FileMaker abiertos, leer el activo, obtener metadatos acotados o activar una ventana ya abierta.	Activar solo trae la ventana al frente.
genie_scripts	Contexto, contenido acotado, Script Schema, catalogo, pasos, funciones, validacion, preview y staging de scripts.	Unifica el trabajo de scripts.
genie_metadata	Tablas, ocurrencias, campos, layouts, relaciones, describe dirigido y parse_selection.	No uses genie_query para descubrir schema.
genie_get_guides	Fallback de guias cuando no hay recursos.	Sin key lista guias.
genie_evaluate	Evaluar calculos FileMaker sin efectos secundarios.	Usa mocks Let() para variables de runtime.
genie_query	Filas de datos SELECT de solo lectura.	Solo lectura; no schema discovery.
genie_stage_data	Una solicitud DATA SQL/schema revisada.	El usuario confirma en Genie.
genie_stage_layout	Objetos de layout copy-only desde Layout Schema, Figma/import JSON o LayoutObjectList XML.	Pegado manual en FileMaker Layout mode.
genie_workbench	Listar, obtener o revisar estado de items preparados.	Run/Apply sigue en la UI de Genie.

Que puede prepararse

Lane	Preparalo cuando	Limites importantes
Script: nuevo	Crear un solo script FileMaker.	Usa genie_scripts con Script Schema y result_type: "new_script".
Script: editar	Editar un script nombrado usando contenido exacto en vivo o adjunto.	Usa genie_scripts action=get_content o genie://context/scripts; merge_ready no es un requisito de staging. Selecciona el destino antes de Apply.
DATA	Preparar una solicitud SQL/schema o plan de migracion admitido.	Usa genie_stage_data; inspecciona metadata/relaciones primero.
Objetos de layout	Preparar objetos copy-only para pegar en FileMaker.	Usa genie_stage_layout; no aplica layouts en el host.
XML bruto experto	Revisar un artefacto XML FileMaker completo producido fuera de Genie.	Normalmente usa Script Schema para scripts nuevos o edits.

ASK y planificacion se quedan en el IDE o en el chat normal. QUERY se queda con genie_query fuera de Workbench.

Klai y BetterForms

En Settings > Advanced > Agent / MCP, activa Expose Klai hook guidance cuando quieras que el puente exponga recursos y guias de hooks Klai/BetterForms. Reconecta el cliente MCP despues de cambiar este ajuste para que descubra el nuevo contexto.

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