Local MCP Bridge

Utilisez Local MCP Bridge lorsqu’un editeur ou agent externe sur le meme Mac doit travailler avec Genie comme workbench FileMaker.

Local MCP n’est pas un canal d’application cache. Il expose un serveur localhost protege par bearer token afin que des clients de confiance puissent lire le contexte, utiliser des outils bornes et preparer du travail revisable dans Genie. Il inclut aussi un reglage beta explicite pour les clients de confiance qui peuvent lancer automatiquement le flux Create Script de Genie pour les stages de script pris en charge.

Ou l’activer

Ouvrez Guide des reglages et configurez Local MCP Bridge.

Vous pouvez controler :

• Enable Local MCP Bridge
• Automatically create scripts in FileMaker (beta)
• Port
• Status
• Setup guide
• Copy snippet

Le guide de configuration peut afficher Codex Streamable HTTP, Cursor/generic JSON, endpoint URL ou bearer token. L’apercu visible masque le token lorsque c’est necessaire ; les actions de copie utilisent le vrai token local.

Beta : creer automatiquement des scripts dans FileMaker

Le reglage beta Automatically create scripts in FileMaker est reserve a l’automatisation locale de confiance. Lorsqu’il est actif, un client MCP connecte avec le bearer token courant peut soumettre des stages de script pris en charge et Genie lance immediatement le flux Create Script existant.

Limites importantes :

• Le flux passe par Create Script dans Genie; ce n’est pas un outil de mutation cache separe.
• Les scripts existants ne sont jamais remplaces. Les edits creent une nouvelle version.
• Tout client Local MCP authentifie avec le token courant peut utiliser cette beta pendant qu’elle est activee.
• Desactivez-la lorsque vous ne travaillez pas avec un agent de confiance qui doit creer des scripts immediatement.

Workbench conserve les sections Pending et Submitted afin que vous puissiez inspecter l’historique du handoff et les avertissements.

Workflow agent conseille

Les agents externes devraient utiliser le bridge dans cet ordre :

1. Appeler genie_get_capabilities.
2. Lire les guides pertinents via genie://guides/* ou genie_get_guides, et le guidage projet effectif via genie://context/project ou la reference compatible project_context.
3. Utiliser genie_files pour confirmer les fichiers ouverts ou le fichier actif.
4. Utiliser genie_scripts pour contexte de scripts, contenu borne, Script Schema, etapes, fonctions, validation, preview de compilation ou staging de scripts.
5. Utiliser genie_metadata pour tables, occurrences, rubriques, layouts, relations, describe cible et parse_selection.
6. Utiliser genie_evaluate pour verifier des calculs FileMaker sans effets secondaires.
7. Utiliser genie_query seulement pour des lignes SELECT en lecture seule.
8. Preparer DATA avec genie_stage_data ou des objets de layout copy-only avec genie_stage_layout.
9. Demander a l’utilisateur de relire l’item dans Genie Workbench.

L’execution se fait ensuite depuis l’interface Genie. L’utilisateur relit, copie, execute ou supprime l’item ; l’appel MCP seul ne modifie normalement pas FileMaker. Si la beta Automatically create scripts in FileMaker est activee, les stages de script pris en charge depuis des clients locaux authentifies peuvent lancer immediatement le flux Create Script revise.

Ressources exposees par Genie

Ressources 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 inclut le nom de projet effectif, la description, les regles activees, les conventions de nommage, les patterns reutilisables, le template de script et guidance_sources pour montrer si chaque champ herite vient de Project ou de Generic Personalization. Ce guidage peut orienter les noms, commentaires, patterns et structures de scripts, mais n’elargit jamais les outils, le staging Workbench, Apply, la portee Stage A/B ou l’autorite de mutation.

Guides :

• 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

Utilisez genie_get_guides lorsqu’un client expose les outils mais pas les ressources MCP.

Outils MCP actuels

Outil	Usage	Limite
genie_get_capabilities	Contrat MCP actuel, routes et limites.	A appeler tot.
genie_files	Lister les fichiers FileMaker ouverts, lire l’actif, obtenir des metadonnees bornees ou activer une fenetre deja ouverte.	Activation = mise au premier plan seulement.
genie_scripts	Contexte, contenu borne, Script Schema, catalogue, etapes, fonctions, validation, preview et staging de scripts.	Outil unique pour le travail script.
genie_metadata	Tables, occurrences, rubriques, layouts, relations, describe cible et parse_selection.	Ne pas utiliser genie_query pour decouvrir le schema.
genie_get_guides	Fallback de guides quand les ressources ne sont pas exposees.	Sans key, liste les guides.
genie_evaluate	Evaluer des calculs FileMaker sans effets secondaires.	Utilisez des mocks Let() pour les variables runtime.
genie_query	Lignes de donnees SELECT en lecture seule.	Lecture seule ; pas de decouverte de schema.
genie_stage_data	Une demande DATA SQL/schema relue.	L’utilisateur confirme dans Genie.
genie_stage_layout	Objets de layout copy-only depuis Layout Schema, Figma/import JSON ou XML LayoutObjectList.	Collage manuel en mode Layout FileMaker.
genie_workbench	Lister, recuperer ou verifier le statut des items prepares.	Run/Apply reste dans l’UI Genie.

Ce qui peut etre prepare

Lane	A preparer quand	Limites importantes
Script : nouveau	Creer un seul script FileMaker.	Utilisez genie_scripts avec Script Schema et result_type: "new_script".
Script : modifier	Modifier un script nommé avec du contenu live exact ou attaché.	Utilisez genie_scripts action=get_content ou genie://context/scripts; merge_ready n’est pas requis pour le staging. Sélectionnez la cible avant Apply.
DATA	Preparer une demande SQL/schema ou un plan de migration pris en charge.	Utilisez genie_stage_data; inspectez metadonnees/relations d’abord.
Objets de layout	Preparer des objets copy-only a coller dans FileMaker.	Utilisez genie_stage_layout; pas d’application host layout.
XML brut expert	Relire un artefact XML FileMaker complet produit hors Genie.	Pour scripts nouveaux/edits, utilisez normalement Script Schema.

ASK et la planification restent dans l’IDE ou le chat normal. QUERY reste avec genie_query hors Workbench.

Klai et BetterForms

Dans Settings > Advanced > Agent / MCP, activez Expose Klai hook guidance lorsque vous voulez que le bridge expose les ressources et guides de hooks Klai/BetterForms. Reconnectez le client MCP apres ce changement afin qu’il decouvre le nouveau contexte.

Configuration IDE

Pour Codex, utilisez Streamable HTTP dans ~/.codex/config.toml :

# Genie utilise Streamable HTTP. Ne configurez pas stdio pour ce bridge.
[mcp_servers.genie_filemaker]
enabled = true
url = "http://127.0.0.1:3845/mcp"

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

Pour Cursor ou les clients MCP JSON generiques :

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

Pages associees

• Workbench
• Mode AGENT
• Guide des reglages
• Utiliser MCP avec votre IDE web
• Depannage par fonctionnalite