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 Bridge exige Coding Access. AGENT intégré conserve ses capacités gratuites de lecture et le lancement confirmé d’un script existant sans activer le serveur externe.

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. L’ancienne beta de creation automatique de scripts est mise de cote et n’est plus disponible.

Ou l’activer

Ouvrez Guide des reglages et configurez Local MCP Bridge.

Vous pouvez controler :

• Enable Local MCP Bridge
• 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.

Workflow agent conseille

Les agents externes devraient utiliser le bridge dans cet ordre :

1. Utiliser fm_session action:status lorsque l’identite de session est necessaire.
2. Rechercher les guides, schemas et definitions via fm_search avec une query non vide, ou lire les ressources genie://.... Les resultats de recherche ne font jamais autorite sur une cible live.
3. Utiliser fm_session pour confirmer les fichiers ouverts et le document ordinaire reellement au premier plan, signale separement du contexte de calcul du plugin. Un calculationContextFileName non vide qui nomme un fichier ouvert suffit pour les lectures live (metadonnees, contenu de script, hooks) meme si FileMaker n’est pas au premier plan ; ne pas traiter calculationContextMatchesForeground:false seul comme un arret de lecture lorsque FileMaker n’est simplement pas l’app active. activate est une focalisation UI optionnelle et est sans effet uniquement si le fichier demande possede deja ce document ; Script Workspace ne compte jamais. Sinon, Genie utilise le proprietaire natif lorsqu’il est disponible. FileMaker 26 peut plutot exposer un titre Cocoa sans proprietaire sous la forme <valeur WindowNames> (<compte>) ; Genie ne l’accepte que si la comparaison avec WindowNames(file) de chaque fichier ouvert donne un seul proprietaire, donc les collisions de fenetres renommees echouent de maniere sure. Echec ferme seulement si le contexte de calcul manque, entre en conflit avec le fichier demande, ou si un document au premier plan confirme diverge du contexte de calcul (foreground_file_context_not_rebound).
4. Utiliser fm_read avec une cible et une identite exactes pour les scripts et metadonnees ; une identite absente ou ambigue echoue de maniere sure.
5. Utiliser fm_search pour la decouverte et fm_read target:selection pour preparer une selection de metadonnees exacte.
6. Utiliser fm_evaluate avec une expression pour verifier un calcul. Utiliser fm_stage kind=script|layout action=validate|compile_preview pour verifier un artifact sans le mettre en file ; seul action=stage cree un item Workbench.
7. Utiliser fm_query seulement pour des lignes SELECT en lecture seule.
8. Mettre exactement un item en file avec fm_stage kind=script|data|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 pas FileMaker.

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 fm_search avec une query non vide lorsqu’un client expose les outils mais pas les ressources MCP.

Outils MCP actuels

Outil	Usage	Limite
fm_session	Statut, fichiers ouverts, cible active, contexte projet et rafraichissement explicite.	Contexte seulement ; aucune mutation FileMaker.
fm_search	Decouverte de guides, schemas, etapes, fonctions et preuves layout.	query requise ; jamais une autorite de cible live.
fm_read	Preuve live exacte pour un script ou une cible de metadonnees.	Identite exacte requise ; echec ferme si elle manque.
fm_query	Lignes SELECT en lecture seule.	Pas de decouverte de schema.
fm_evaluate	Evaluation de calculs FileMaker.	Sandbox de calcul uniquement ; ne valide pas d’artifact et ne cree pas de file.
fm_stage	Validation, compile-preview ou mise en file d’un script/layout ; mise en file d’un item DATA.	validate/compile_preview ne creent pas d’item ; seul stage cree un item Workbench.
fm_workbench	Inspection, suppression de file, ChangeSets atomiques et verify_apply.	Apply et DATA Execute restent dans l’UI Genie.
fm_run	Lancement d’un script existant exact et lecture de statut.	Chaque lancement exige une nouvelle confirmation native.

Ce qui peut etre prepare

Lane	A preparer quand	Limites importantes
Script : nouveau	Creer un seul script FileMaker.	Utilisez fm_stage kind:script avec Script Schema et result_type: "new_script".
Script : modifier	Modifier un script nommé avec du contenu live exact ou attaché.	Lisez avec fm_read target:script, puis utilisez fm_stage kind:script.
DATA	Preparer une demande SQL/schema ou un plan de migration pris en charge.	Utilisez fm_stage kind:data; inspectez les cibles exactes d’abord.
Objets de layout	Preparer des objets copy-only a coller dans FileMaker.	Utilisez fm_stage kind:layout; pas d’application host layout.

Les questions et la planification restent dans l’IDE ou AGENT. Query reste avec fm_query hors Workbench.

Klai et BetterForms

Dans Settings > Advanced > Agent / MCP, activez Activer l’integration Klai pour afficher les outils Klai de jeux de hooks et de fonctions personnalisees, et pour exposer les ressources et guides Klai/BetterForms. Ce reglage reste disponible meme lorsque Local MCP est desactive. Les outils sont actualises immediatement; reconnectez le client MCP pour actualiser son index de guides.

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