Guia de ajustes

Usa Settings para controlar idioma, tema, activacion, permisos, personalizacion, enrutamiento de modelos, opciones avanzadas y Local MCP Bridge.

Settings General tab with activation and permissions

Distribucion

Settings usa una navegacion lateral con paginas enfocadas:

General: idioma, tema, activacion y permisos
Personalization: tono del asistente e instrucciones personalizadas
Models: claves de proveedor, enrutamiento de modelos, esfuerzo de razonamiento y endpoints personalizados
Advanced: presupuesto de aclaracion, diccionarios de funciones plugin y analytics privadas
Local MCP: fragmentos de configuracion del puente local y estado de conexion

La entrada Docs en la navegacion abre esta documentacion.

General

General incluye acceso al producto y permisos locales del sistema.

Setting	Description
App Language	Elige el idioma de Settings y de la UI cuando se necesita un cambio manual.
Theme	Elige interfaz clara u oscura.
Activation	Permite ingresar una clave, comprar, activar, desactivar y leer el estado de activacion.
Permissions	Muestra el estado de Microphone y Accessibility para la app que ejecuta Genie.

Permissions

Los permisos aparecen junto a la activacion para que la recuperacion sea visible antes de CODE o acciones de captura.

Microphone habilita dictado en el composer.
Accessibility permite que Genie lea FileMaker Script Workspace y aplique cambios.
Open Settings abre los ajustes de macOS cuando falta un permiso.

Personalization

Usa Personalization para configurar guia global y guia del proyecto activo desde un solo lugar. Build 53 reemplaza la antigua ventana separada de Project Rules por esta superficie consolidada en Settings.

Personalization con pestañas Generic y Project

Ambito Generic

Generic contiene valores por defecto que Genie puede usar en todos los proyectos:

Setting	Description
Personality	Elige un estilo de respuesta friendly, balanced o pragmatic.
Custom instructions	Envia preferencias de estilo y workflow con las solicitudes al modelo. No guardes secretos aqui.
Naming conventions	Define preferencias globales de nombres, como estilo de scripts o casing de variables.
Patterns	Captura patrones reutilizables, contratos, manejo de errores y tecnicas preferidas.
Script template	Proporciona la estructura por defecto que Genie debe seguir para scripts nuevos o revisiones importantes.

Campos Generic para convenciones de nombre, patrones y plantilla de script

Ambito Project

Project contiene configuracion para el archivo FileMaker activo:

Setting	Description
Project name	Nombre visible de la solucion FileMaker activa.
Description	Resumen especifico del proyecto: solucion, usuarios, objetivo y restricciones importantes.
Project rules	Reglas activadas o desactivadas para este archivo FileMaker.
Naming convention override	Guia de nombres especifica del proyecto. Un campo vacio hereda las convenciones Generic.
Pattern override	Patrones especificos del proyecto. Un campo vacio hereda los patrones Generic.
Script template override	Estructura de script especifica del proyecto. Un campo vacio hereda el Script template Generic.

Ajustes Project con nombre, descripcion y reglas de proyecto

La descripcion del proyecto y Project Rules siguen siendo especificos del proyecto y no heredan valores Generic. Los valores Generic se guardan como preferencias de la app, no se copian en cada perfil de proyecto.

La configuracion efectiva se incluye en project_context para modos Genie estandar, AGENT embebido, Script Workspace AGENT y Local MCP. Puede influir en nombres, comentarios, patrones y estructura de scripts, pero nunca amplia herramientas, alcance de objetivos, staging Workbench, Apply, alcance Stage A/B ni autoridad de mutacion.

Models

Models controla credenciales de proveedor y enrutamiento para Coding y Logistics.

Settings Models tab

Setting	Description
OpenAI / Anthropic / Google / xAI keys	Credenciales guardadas para cada familia de proveedores cloud.
Use one model	Cuando esta activo, Coding tambien gestiona preguntas, refinamiento y coordinacion. Desactivalo para elegir una ruta Logistics separada.
Coding Provider	Familia de proveedor para generacion de codigo: `Custom / Local`, `OpenAI`, `Anthropic`, `xAI / Grok` o `Google`.
Coding Model	Modelo seleccionado para trabajo de codigo.
Coding Reasoning Effort	Profundidad vs velocidad para el rol Coding.
Logistics Provider	Familia de proveedor para planificacion, refinamiento, QUERY, DATA y coordinacion ASK.
Logistics Model	Modelo seleccionado para la ruta Logistics.
Logistics Reasoning Effort	Profundidad de planificacion/refinamiento para la ruta Logistics.
Custom Token	Credencial para un proveedor local o personalizado compatible con OpenAI.
Coding Endpoint	Endpoint compatible con OpenAI usado cuando Coding provider es `Custom / Local`.
Logistics Endpoint	Endpoint compatible con OpenAI usado cuando Logistics provider es `Custom / Local`.
Test Connection	Verifica un endpoint personalizado configurado antes de guardar.

xAI / Grok

Elige xAI / Grok cuando quieras un modelo Grok alojado para Coding, Logistics o ambos roles.

xAI usa su propia API key guardada en Settings.
Los modelos Grok aparecen en el selector normal de modelos.
Genie enruta el trafico xAI por la ruta cloud compatible con OpenAI de xAI.
Los campos custom model id, endpoint y test de conexion son solo para Custom / Local.
Web Search no esta conectado a xAI en esta version.

Advanced

Advanced contiene controles que afectan el manejo de solicitudes y diagnosticos opcionales.

Setting	Description
Preflight Questions	Presupuesto compartido de aclaracion para CODE, QUERY y DATA. `0` mantiene preflight activo pero evita preguntas de seguimiento.
BaseElements plugin	Permite que Genie use el diccionario de funciones BaseElements durante resolucion y planificacion CODE.
MBS plugin	Permite que Genie use el diccionario de funciones MBS durante resolucion y planificacion CODE.
Expose Klai hook guidance	Expone guias y recursos Klai/BetterForms para agentes MCP locales. Reconecta el cliente MCP despues de cambiarlo.
Send Analytics	Permite diagnosticos operativos privados. Prompts, scripts y metadata de base de datos no se incluyen.

Deja un diccionario desactivado cuando el plugin no este instalado o no quieras que el codigo generado dependa de el. Los diccionarios desactivados se ignoran durante la resolucion de funciones.

Settings Advanced tab with clarification budget and plugin dictionaries

Local MCP Bridge

Usa Local MCP Bridge cuando clientes MCP externos en la misma maquina deban consumir metadata/contexto de Genie y preparar trabajo revisado en Workbench.

Ajustes Local MCP con la opcion beta de creacion automatica de scripts

Usa Local MCP Bridge para la guia dedicada y entradas de troubleshooting.

Que configuras

Setting	Description
Enable Local MCP Bridge	Inicia o detiene el puente local.
Automatically create scripts in FileMaker	Beta. Permite que clientes Local MCP de confianza ejecuten inmediatamente el flujo Create Script de Genie para stages de script correctos y compatibles. Los scripts existentes nunca se reemplazan; las ediciones crean una nueva version.
Port	Puerto local del servidor MCP. El host se muestra como `127.0.0.1`.
Status	Estado de ejecucion, deshabilitado, arranque o error.
Setup guide	Muestra Codex Streamable HTTP, Cursor/generic JSON, endpoint URL o bearer token.
Copy snippet	Copia el fragmento elegido con el bearer token local actual.

Deja Automatically create scripts in FileMaker desactivado salvo que confies en el cliente local conectado y quieras que los stages de script compatibles creen scripts inmediatamente mediante el flujo Create Script existente de Genie. El puente es local, pero todo cliente autenticado con el token actual puede usar esta beta mientras este activada.

Comportamiento del token

El token de autenticacion lo genera y guarda Genie.
El campo token no se edita directamente en la UI visible.
Las vistas previas visibles enmascaran el token cuando corresponde.
Copy snippet incluye automaticamente el bearer token real actual.

Recursos MCP locales

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

genie://context/project expone la guia efectiva Generic/Project Personalization a clientes AGENT y MCP conectados. Es solo guia y no amplia la autoridad de mutacion.

Herramientas MCP actuales

genie_get_capabilities
genie_files
genie_scripts
genie_metadata
genie_get_guides
genie_evaluate
genie_query
genie_stage_data
genie_stage_layout
genie_workbench

Estas herramientas son para agentes externos y workflows IDE. No reemplazan la UI de Genie.

El staging Workbench normalmente no ejecuta proveedores ni aplica cambios durante la llamada MCP. El usuario revisa scripts, DATA, layouts o XML preparados en Genie y los ejecuta o copia por el flujo de seguridad correspondiente. 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; los scripts existentes nunca se reemplazan. QUERY usa genie_query fuera de Workbench, y ASK/planificacion queda en el IDE o en el chat normal.

Ejemplo de configuracion Codex

# 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>"

Ejemplo Cursor o JSON generico

Copy snippet tambien puede producir un JSON como:

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

Acceso de activacion

La activacion vive en Settings > General.

El estado de activacion aplica a ASK, CODE, QUERY, DATA, ejecuciones Workbench y la mayoria de acciones de captura.
Soporte sigue disponible para recuperacion de activacion.
Las credenciales de proveedor no desbloquean el producto por si solas.

Consulta: Licensing and Activation

Guardado

Save aplica los cambios actuales.
Cancel o cerrar descarta los cambios no guardados.