Local MCP Bridge

Utilisez Local MCP Bridge lorsqu’un éditeur ou agent externe sur le même Mac doit travailler avec Genie comme workbench FileMaker.

C’est la couche de transfert agentique pour des outils comme Codex, Cursor ou un agent IDE compatible MCP. Elle permet à l’agent d’inspecter le contexte détenu par Genie, de choisir la bonne route, puis de préparer du travail pris en charge dans Genie sans contourner la révision.

Local MCP n’est pas un canal d’application caché. C’est un bridge localhost avec trois rôles :

• exposer les métadonnées et le contexte détenus par Genie aux clients locaux de confiance
• offrir de petits outils en lecture seule pour inspecter le schéma et les requêtes SELECT
• permettre aux agents de préparer du travail CODE ou DATA séparé dans Workbench afin que vous puissiez le relire et l’exécuter dans Genie

Ce que cela fait

Lorsqu’il est activé, Genie expose un serveur MCP local sur 127.0.0.1 et sur le port choisi dans Settings. Les clients se connectent avec un bearer token généré par Genie.

Les clients externes peuvent :

• preparer dans Workbench du XML FileMaker brut produit par un agent, pour revue utilisateur, lorsque la capacite MCP courante l’annonce
• lire les ressources de métadonnées
• lire les ressources du contexte courant
• appeler les outils Genie en lecture seule
• demander les règles courantes de capacité et de routage
• préparer des prompts CODE ou DATA pris en charge dans Workbench

Les appels d’outils MCP ne génèrent pas de code, ne modifient pas FileMaker et n’appliquent aucun changement. L’exécution d’un item préparé se fait plus tard depuis Genie Workbench et repasse par le pipeline normal de Genie.

Où l’activer

Ouvrez Guide des réglages et configurez Local MCP Bridge.

Vous pouvez contrôler :

• Enable Local MCP Bridge
• Port
• Status
• Setup guide
• Copy snippet

Le guide de configuration peut afficher :

• Codex (Streamable HTTP)
• Cursor / generic JSON
• Endpoint URL
• Bearer token

L’aperçu visible masque le token lorsque c’est nécessaire. Les actions de copie utilisent le vrai token local.

Workflow agent conseillé

Les agents externes devraient utiliser le bridge dans cet ordre :

1. Appeler genie_get_capabilities avant de préparer du travail.
2. Inspecter les métadonnées et le contexte avec les ressources ou outils en lecture seule.
3. Utiliser genie_query seulement pour les requêtes SELECT en aperçu ou exécution, hors Workbench.
4. Pour du travail script qui nomme des modèles, tables, rubriques, scripts ou fonctions personnalisées, appeler genie_prepare_metadata_selection.
5. Préparer un seul item CODE ou DATA pris en charge avec l’outil de staging dédié.
6. Demander à l’utilisateur de relire l’item dans Genie Workbench.
7. L’utilisateur exécute, copie ou supprime l’item depuis Workbench.

Quand vous exécutez un item Workbench, Genie applique d’abord la sélection de métadonnées stockée, puis envoie le prompt dans le même pipeline CODE ou DATA que le composer. CODE conserve Stage A/B, l’abaissement AST, la sécurité aperçu/copie/application et la révision normale. DATA conserve les confirmations et garde-fous SQL.

Ressources exposées par Genie

• 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

Outils en lecture seule

Outil	Usage	Entrée requise
genie_get_fields_on_layout	Retourner les noms de rubriques fiables d’un modèle FileMaker.	layoutName
genie_get_layout_info	Retourner les métadonnées du modèle et les rubriques visibles.	layoutName
genie_get_table_info	Retourner les métadonnées de table et les détails de rubriques déjà chargés.	tableName
genie_get_field_info	Résoudre une rubrique avec un éventuel filtre table/modèle.	fieldName
genie_get_fields_for_table	Retourner les rubriques de schéma pour une table.	tableName
genie_get_script_content	Retourner le XML enregistré pour un script ingéré. Lire scriptKey depuis genie://metadata/scripts.	scriptKey préféré
genie_query	Prévisualiser ou exécuter un SELECT en lecture seule.	intent, mode

genie_query accepte mode: "preview" ou mode: "run". Il est séparé de Workbench. Ne préparez pas de prompts QUERY dans Workbench.

Outils Workbench

Outil	Usage	Notes
genie_get_capabilities	Lire le contrat de routage et le playbook de l’agent IDE.	À appeler avant le staging.
genie_prepare_metadata_selection	Résoudre modèles, tables, rubriques, scripts et fonctions personnalisées chargés dans un bundle metadata_selection.	À utiliser avant du CODE ancré aux métadonnées.
genie_stage_new_script	Préparer une seule demande de nouveau script FileMaker.	Outil CODE de création préféré.
genie_stage_edit_script	Préparer une seule modification du script déjà attaché ou sélectionné dans Genie.	Exige un contexte Add Selection ou Add Scripts.
genie_stage_data	Préparer une demande FileMaker SQL data/schéma relue.	DATA seulement.
genie_list_workbench_items	Lister les items Workbench préparés.	Révision seulement.
genie_get_workbench_item	Récupérer un item par job_id.	Révision seulement.
genie_get_job_status	Récupérer le statut d’un item par job_id.	Révision seulement.

Ce qui peut être préparé

Mode	À préparer quand	Limites importantes
CODE : nouveau script	Créer un seul script FileMaker.	Utilisez genie_stage_new_script. Un item Workbench par script. Pas de DATA, QUERY, ASK ni de travail manuel UI/relationnel.
CODE : modifier un script	Modifier un script déjà attaché ou sélectionné dans Genie.	Utilisez genie_stage_edit_script. Pas de modification de script nommé non attaché. Pas d’opération create or replace.
DATA	Préparer une seule demande FileMaker SQL data/schéma prise en charge.	Utilisez genie_stage_data. Inspectez les métadonnées d’abord. Pas de IF NOT EXISTS, relations SQL, travail script, QUERY ou index.
Artefact XML brut	Preparer du XML FileMaker produit par un agent pour revue.	A utiliser seulement lorsque genie_get_capabilities annonce le staging XML. Ce n’est pas un chemin d’export de ressources et rien ne s’applique pendant l’appel MCP.

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

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_local]
enabled = true
url = "http://127.0.0.1:3845/mcp"

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

Pour Cursor ou les clients MCP JSON génériques :

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

Bons cas d’usage

• garder un agent côté IDE aligné sur les métadonnées FileMaker
• vérifier les détails d’un modèle, d’une table ou d’une rubrique depuis la même machine
• lire le contexte courant de Genie pendant que vous travaillez ailleurs
• préparer une demande de script relue depuis Cursor, Codex ou un autre client MCP
• permettre à un agent IDE d’inspecter les métadonnées avant de demander à Genie de créer des tables ou un script

Pages associées

• Workbench
• Guide des réglages
• Configuration requise
• Utiliser MCP avec votre IDE web
• Dépannage par fonctionnalité