Dépannage par fonctionnalité

Résolvez les problèmes liés à des tâches ou fonctions précises de Genie.

Une fonction payante est indisponible

• Symptômes : Genie fournit des étapes lisibles mais pas Create ni Apply, ou une action de modèle, de données, du mode Application automatique ou de Workbench est indisponible.
• Cause : ces actions demandent un forfait payant, et cet ordinateur est sur le forfait Gratuit ou son activation n’est pas active.
• Solution : ouvrez Settings > General et vérifiez votre forfait et votre clé d’activation. Voir Licence et activation.

Local MCP Bridge : échec de connexion 400 / repli SSE

• Symptômes : les journaux de l’IDE montrent invalid_http_request en HTTP streamable, un repli SSE Non-200 (400) ou des échecs répétés de connexion du client.
• Cause : endpoint ou chemin MCP incorrect, en-tête d’authentification bearer manquant, ou Local MCP Bridge désactivé.
• Solution :
  1. Dans Settings > Local MCP, vérifiez que Local MCP Bridge est activé et en cours d’exécution.
  2. Vérifiez que la configuration de votre IDE utilise le chemin URL /mcp, et non la racine.
  3. Vérifiez que Authorization: Bearer <token> est présent.
  4. Recopiez l’extrait de configuration à jour depuis Settings > Local MCP.
  5. Assurez-vous que l’hôte et le port correspondent à ceux de Genie (127.0.0.1 et le port configuré).

Local MCP Bridge : Claude Desktop ne voit pas les outils Genie

• Symptômes : Claude Desktop démarre mais les outils et ressources Genie n’apparaissent pas, ou les journaux de Claude montrent l’arrêt d’un serveur stdio.
• Cause : Claude Desktop ne peut pas utiliser directement l’endpoint Streamable HTTP local de Genie depuis claude_desktop_config.json ; il lui faut l’extrait du pont stdio pour Claude Desktop.
• Solution :
  1. Dans Settings > Local MCP, choisissez Claude Desktop (stdio bridge).
  2. Copiez l’extrait dans la configuration développeur de Claude Desktop.
  3. Vérifiez que npx peut lancer mcp-remote@latest.
  4. Gardez Genie ouvert avec Local MCP activé, puis redémarrez Claude Desktop.

Local MCP Bridge : un agent envoie du XML pour des demandes normales

• Symptômes : Cursor, Codex, Claude ou un autre client MCP envoie fmxmlsnippet pour des demandes de script en langage courant.
• Cause : la préparation de scripts doit utiliser Script Schema avec fm_stage kind:script. Le XML sert aux demandes qui contiennent déjà un XML de script ou d’étapes complet.
• Solution :
  1. Demandez à l’agent d’appeler à nouveau fm_session.
  2. Pour un nouveau script, utilisez fm_search pour trouver Script Schema et les étapes utiles, puis appelez fm_stage kind:script avec result_type: "new_script".
  3. Pour une modification, lisez le contenu exact avec fm_read target:script (ou genie://context/scripts), puis appelez fm_stage kind:script avec result_type: "delta_edit". merge_ready:false ne bloque pas la préparation.
  4. N’utilisez fmxmlsnippet que si la demande contient un XML de script ou d’étapes complet.

Local MCP Bridge : l’agent demande des métadonnées pour des mots d’API

• Symptômes : un client MCP indique que Genie a besoin de métadonnées pour des mots comme URL, API, JSON ou le nom d’un service externe comme Asana.
• Cause : les métadonnées ne servent qu’aux vraies références FileMaker. Les mots qui décrivent un service externe ne sont pas des métadonnées FileMaker.
• Solution :
  1. Demandez à l’agent de préparer à nouveau la demande de script avec fm_stage kind:script.
  2. N’utilisez fm_read target:selection que si la demande nomme des tables, champs, modèles, scripts, fonctions personnalisées, listes de valeurs ou références de schéma ExecuteSQL FileMaker précis.
  3. Gardez fm_query pour les SELECT en lecture seule, pas pour générer un script Insert from URL.

Local MCP Bridge : l’agent utilise fm_query pour découvrir le schéma

• Symptômes : un client MCP essaie de connaître les listes de champs ou les liens en lançant des requêtes SELECT.
• Cause : fm_query sert uniquement à lire des lignes de données.
• Solution :
  1. Utilisez fm_read avec une cible exacte table, field, layout ou relationship_summary pour lire la structure.
  2. N’utilisez fm_query qu’une fois le schéma connu, lorsque la demande a besoin de lignes de données.
  3. Pour une modification de données, passez un ensemble metadata_selection issu de fm_read target:selection à fm_stage kind:data.

Genie : la réponse s’arrête sur une question

• Symptômes : Genie pose une question précise au lieu de fournir un script ou une réponse finale.
• Cause : Genie n’a pas pu déterminer l’intention, la cible, les métadonnées nécessaires, la portée d’une modification destructive ou si la modification peut être appliquée.
• Solution :
  1. Répondez à la question dans le chat.
  2. Nommez le script cible dans votre demande, ou sélectionnez les références utiles dans Metadata Explorer. Genie lit le contenu exact du script au besoin.
  3. S’il manque des métadonnées, actualisez ou sélectionnez les éléments concernés dans Metadata Explorer.

Échecs d’export (CSV/PNG)

• Symptômes : une boîte de dialogue d’enregistrement apparaît, mais le fichier n’est pas écrit ou reste vide.
• Cause : permission d’écriture manquante sur le dossier cible, ou erreur passagère pendant la préparation des données.
• Solution :
  1. Relancez une fois la requête ou le graphique.
  2. Choisissez un dossier local accessible en écriture, par exemple Documents ou Bureau.
  3. Vérifiez que votre ordinateur dispose de suffisamment d’espace libre.

Modification de données : désaccord de placeholders

• Symptômes : le chat signale un désaccord de placeholders ou de paramètres et la modification ne s’exécute pas.
• Cause : le nombre de placeholders SQL ne correspond pas aux valeurs fournies.
• Solution :
  1. Demandez à Genie de préparer à nouveau le SQL avec des valeurs littérales lorsque c’est pertinent.
  2. Ou demandez une liste complète de paramètres correspondant exactement aux placeholders.
  3. N’exécutez la modification qu’une fois l’avertissement disparu.

Modification de données : CREATE INDEX est bloqué

• Symptômes : le chat bloque une demande CREATE INDEX.
• Cause : FileMaker gère l’indexation par les options de stockage des champs ; Genie n’exécute donc pas CREATE INDEX.
• Solution :
  1. Retirez CREATE INDEX de la demande.
  2. Gérez l’indexation dans les options de stockage du champ dans FileMaker.
  3. Redemandez les autres modifications de schéma ou de données.

Claude Code ou Codex ne répond pas ou ne peut pas être choisi

• Symptômes : les lignes sous Your own agent sont grisées, le pied de page sous le composeur indique Local connection off, ou une réponse échoue avec un message sur le moteur.
• Cause : Local MCP est désactivé ou ne fonctionne pas, le Privacy Mode de Local MCP est actif, le programme n’est pas installé ou pas connecté, ou il est périmé. Ces messages n’ont pas de code numérique.
• Correction : cliquez sur Turn on si vous le voyez, désactivez le Privacy Mode de Local MCP, ou utilisez Install, Connect ou Update sur la carte dans Settings > Models. Chaque message et son remède sont listés dans Claude Code et Codex.

Pages associées

• Gratuit et Payant
• Guide des réglages
• Local MCP Bridge
• Modifier les données et le schéma
• Dépannage et récupération