Settings Guide

Use Settings to control provider routing, two-stage CODE behavior, clarification limits, Local MCP Bridge, and activation access.

Settings panel overview

Layout

On wide layouts, Settings uses two columns:

Left column: Coding, Two-stage CODE pipeline, Clarification Budget
Right column: Logistics, Local MCP Bridge

The key icon in the modal header opens Manage Activation.

Coding

Coding controls code generation work.

Setting	Description
Coding Provider	Provider family for coding work: `Custom / Local`, `OpenAI`, `Anthropic`, or `Google`.
Coding Model	Selected model for coding work.
Custom model id	Free-text model field shown when `Custom / Local` is selected.
Reasoning Effort	Depth vs speed for the coding role.
API Key	Credential for the selected coding provider.
Coding Endpoint (OpenAI-compatible)	Shown only when Coding provider is `Custom / Local`.
Test Connection	Checks the configured custom coding endpoint before save.

Two-stage CODE pipeline

The two-stage CODE pipeline separates planning/refinement from generation.

Setting	Description
Two-stage CODE pipeline	When enabled, Genie can use the dedicated Logistics role before generation. When disabled, logistics work falls back to the coding provider/model.

Clarification Budget

Setting	Description
Preflight Questions	Shared clarification budget for CODE, QUERY, and DATA. `0` keeps preflight active but prevents follow-up clarification prompts.

Logistics

Logistics controls preflight plus QUERY, DATA, and ASK coordination when the two-stage CODE pipeline is enabled.

Setting	Description
Logistics Provider	Provider family for planning/refinement work.
Logistics Model	Model used for the logistics role.
Custom model id	Free-text model field shown when `Custom / Local` is selected.
Reasoning Effort	Planning/refinement depth for the logistics role.
API Key	Credential for the selected logistics provider.
Logistics Endpoint (OpenAI-compatible)	Shown only when Logistics provider is `Custom / Local`.
Test Connection	Checks the configured custom logistics endpoint before save.

Language Settings

Use Language Settings to choose the language Genie uses in the Settings panel and related UI text.

Setting	Description
Language	Choose your preferred Genie language in Settings.

Recommended: use FileMaker in English for the best results.
Supported: English, French, and Spanish.

Local MCP Bridge

Use Local MCP Bridge when you want external MCP clients on the same machine to consume Genie metadata and context.

Use Local MCP Bridge for the dedicated guide and troubleshooting entry points.

What you configure

Setting	Description
Enable Local MCP Bridge	Starts or stops the local bridge.
Port	Local port for the MCP server. The host is shown inline as `127.0.0.1`.
Status	Running, disabled, or startup/error state.
Copy IDE JSON	Copies ready-to-paste MCP client JSON.

Token behavior

The auth token is generated and stored by Genie.
The token field is not directly edited in the visible UI.
Copy IDE JSON includes the current bearer token automatically.

Local MCP resources

genie://metadata/all
genie://metadata/selected
genie://context/live
genie://context/attached

Branded read-only MCP tools

genie_get_fields_on_layout
genie_get_layout_info
genie_get_table_info
genie_get_field_info
genie_query

These tools are intended for external assistants and IDE workflows. They do not replace the in-app UI.

IDE config shape

Copy IDE JSON produces a payload shaped like:

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

Activation access

Settings does not replace the activation modal. It gives you a direct entry point to it.

Click the key icon in the Settings header to open Manage Activation.
Activation state applies across ASK, CODE, QUERY, and DATA.
If activation blocks the UI, Settings itself is part of the locked surface until Genie is reactivated.

See: Licensing and Activation

Save behavior

Save applies the current changes.
Cancel or close discards unsaved changes.