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 elegir el estilo de respuesta y agregar instrucciones cortas de trabajo.

Settings Personalization tab

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.

Las instrucciones personalizadas tienen limite en la UI. Mantenlas cortas y operativas.

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.
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.

Current Local MCP settings tab

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.
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.

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://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 MCP de solo lectura

genie_get_fields_on_layout
genie_get_layout_info
genie_get_table_info
genie_get_field_info
genie_get_fields_for_table
genie_get_script_content
genie_query

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

Herramientas MCP Workbench

genie_get_capabilities
genie_prepare_metadata_selection
genie_stage_new_script
genie_stage_edit_script
genie_stage_data
genie_list_workbench_items
genie_get_workbench_item
genie_get_job_status

El staging Workbench no ejecuta proveedores ni aplica cambios durante la llamada MCP. El usuario revisa items CODE o DATA en Genie y los ejecuta por el flujo de seguridad correspondiente. 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_local]
enabled = true
url = "http://127.0.0.1:3845/mcp"

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

Ejemplo Cursor o JSON generico

Copy snippet tambien puede producir un JSON como:

{
  "mcpServers": {
    "genie_local": {
      "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.