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.

Es la capa de entrega agentic para herramientas como Codex, Cursor o un agente IDE compatible con MCP. Permite que el agente inspeccione el contexto que posee Genie, tome decisiones de enrutamiento con base real y prepare trabajo admitido en Genie sin saltarse la revisión.

Local MCP no es un canal oculto de apply. Es un puente localhost con tres funciones:

• exponer metadatos y contexto de Genie a clientes locales de confianza
• dar a los agentes pequeñas herramientas de solo lectura para inspeccionar esquema y consultas SELECT
• permitir que los agentes preparen trabajo CODE o DATA separado en Workbench para que puedas revisarlo y ejecutarlo dentro de Genie

Qué hace

Cuando está habilitado, Genie expone un servidor MCP local en 127.0.0.1 y el puerto que elijas en Settings. Los clientes se conectan con un bearer token generado por Genie.

Los clientes externos pueden:

• preparar en Workbench XML FileMaker bruto producido por un agente, para revision del usuario, cuando la capacidad MCP actual lo anuncie
• leer recursos de metadatos
• leer recursos del contexto actual
• llamar a herramientas Genie de solo lectura
• consultar las reglas actuales de capacidad y enrutamiento
• preparar prompts CODE o DATA admitidos en Workbench

Las llamadas de herramientas MCP no generan código, no modifican FileMaker y no aplican cambios. La ejecución de un item preparado ocurre después desde Genie Workbench y vuelve a entrar en el pipeline normal de Genie.

Dónde activarlo

Abre Guía de ajustes y configura Local MCP Bridge.

Puedes controlar:

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

La guía de configuración puede mostrar:

• Codex (Streamable HTTP)
• Cursor / generic JSON
• Endpoint URL
• 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 deberían usar el puente en este orden:

1. Llamar a genie_get_capabilities antes de preparar trabajo.
2. Inspeccionar metadatos y contexto con recursos o herramientas de solo lectura.
3. Usar genie_query solo para tareas SELECT de vista previa o ejecución fuera de Workbench.
4. Para trabajo de scripts que nombre layouts, tablas, campos, scripts o funciones personalizadas, llamar a genie_prepare_metadata_selection.
5. Preparar un solo item CODE o DATA admitido con la herramienta de staging dedicada.
6. Pedir al usuario que revise el item en Genie Workbench.
7. El usuario ejecuta, copia o descarta el item desde Workbench.

Cuando ejecutas un item Workbench, Genie aplica primero la selección de metadatos guardada y luego envía el prompt por el mismo pipeline CODE o DATA que usarías desde el composer. CODE conserva Stage A/B, reducción AST, seguridad de preview/copy/apply y revisión normal. DATA conserva confirmaciones y guardarraíles SQL.

Recursos que expone Genie

• genie://metadata/all
• genie://metadata/selected
• genie://metadata/layouts
• genie://metadata/tables
• genie://metadata/scripts
• genie://metadata/custom-functions
• genie://context/live
• genie://context/attached

Herramientas de solo lectura

Herramienta	Uso	Entrada requerida
genie_get_fields_on_layout	Devolver nombres de campos fiables para un layout de FileMaker.	layoutName
genie_get_layout_info	Devolver metadatos del layout y campos visibles.	layoutName
genie_get_table_info	Devolver metadatos de tabla y detalles de campos ya cargados.	tableName
genie_get_field_info	Resolver un campo con posible acotación por tabla/layout.	fieldName
genie_get_fields_for_table	Devolver campos de esquema para una tabla.	tableName
genie_get_script_content	Devolver XML guardado para un script ingerido. Lee scriptKey desde genie://metadata/scripts.	preferir scriptKey
genie_query	Previsualizar o ejecutar un SELECT de solo lectura.	intent, mode

genie_query acepta mode: "preview" o mode: "run". Está separado de Workbench. No prepares prompts QUERY en Workbench.

Herramientas Workbench

Herramienta	Uso	Notas
genie_get_capabilities	Leer el contrato de enrutamiento y el playbook del agente IDE.	Llámala antes del staging.
genie_prepare_metadata_selection	Resolver layouts, tablas, campos, scripts y funciones personalizadas cargados en un bundle metadata_selection.	Úsala antes de CODE con metadatos.
genie_stage_new_script	Preparar una sola solicitud de nuevo script FileMaker.	Herramienta preferida para creación CODE.
genie_stage_edit_script	Preparar una sola edición del script ya adjunto o seleccionado en Genie.	Requiere contexto Add Selection o Add Scripts.
genie_stage_data	Preparar una solicitud SQL data/esquema de FileMaker revisada.	Solo DATA.
genie_list_workbench_items	Listar items Workbench preparados.	Solo revisión.
genie_get_workbench_item	Obtener un item por job_id.	Solo revisión.
genie_get_job_status	Obtener el estado de un item por job_id.	Solo revisión.

Qué puede prepararse

Modo	Prepáralo cuando	Límites importantes
CODE: nuevo script	Crear un solo script FileMaker.	Usa genie_stage_new_script. Un item Workbench por script. Sin DATA, QUERY, ASK ni trabajo manual de UI/relaciones.
CODE: editar script	Editar un script ya adjunto o seleccionado en Genie.	Usa genie_stage_edit_script. Sin ediciones de scripts nombrados pero no adjuntos. Sin operación create or replace.
DATA	Preparar una sola solicitud SQL data/esquema de FileMaker admitida.	Usa genie_stage_data. Inspecciona metadatos antes. Sin IF NOT EXISTS, relaciones SQL, trabajo de script, QUERY ni índices.
Artefacto XML bruto	Preparar XML FileMaker producido por un agente para revision.	Usalo solo cuando genie_get_capabilities anuncie staging XML. No es una ruta de exportacion de recursos y no aplica nada durante la llamada MCP.

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

Configuración del IDE

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

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

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

Para Cursor o clientes MCP JSON genéricos:

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

Buen uso

• mantener un agente del IDE alineado con los metadatos de FileMaker
• consultar detalles de layouts, tablas y campos desde la misma máquina
• leer el contexto actual de Genie mientras trabajas en otra parte
• preparar una solicitud de script revisada desde Cursor, Codex u otro cliente MCP
• permitir que un agente IDE inspeccione metadatos antes de pedir a Genie crear tablas o generar un script

Páginas relacionadas

• Workbench
• Guía de ajustes
• Requisitos del sistema
• Usar MCP con tu IDE web
• Troubleshooting por funcionalidad