Utilisez Entity Enricher depuis un client compatible MCP pour transformer la connaissance des modèles et vos documents en données structurées. Concevez des schémas, enrichissez des entités en plusieurs langues, fusionnez des modèles, assurez la curation des identités sémantiques, évaluez la qualité par benchmark et synchronisez des tables relationnelles vers votre propre base de données.
La validation de schéma et l'accord entre modèles ne garantissent ni l'exactitude factuelle ni la fraîcheur des données. Inspectez les sources, les échecs et les résultats partiels en base de données. Le MCP offre un accès conversationnel ; n8n et Make assurent l'automatisation des workflows sur ce même service.
Pour claude.ai, Claude Code, Cursor et tout client MCP prenant en charge le flux OAuth standard. Aucune clé API à créer ou à coller — le client découvre automatiquement le serveur d'autorisation.
https://entityenricher.ai/api/mcp/.Pour les clients configurés via un fichier JSON plutôt que par une connexion interactive (Claude Desktop, Continue, Zed).
ent_… — elle n'est affichée qu'une seule fois.Pour Claude Desktop, modifiez ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) :
{
"mcpServers": {
"entityenricher": {
"url": "https://entityenricher.ai/api/mcp/",
"headers": { "X-API-Key": "ent_your_key_here" }
}
}
}Utilisez le point de terminaison et l'en-tête ci-dessus dans la configuration MCP distante de votre client. La syntaxe de configuration et la prise en charge du transport HTTP dépendent du client.
Dans une nouvelle conversation : « Listez mes schémas Entity Enricher, puis enrichissez Sanofi avec le schéma d'entreprise pharmaceutique en utilisant Claude Sonnet. »Le client peut découvrir les outils et les utiliser pour sélectionner un schéma et lancer l'enrichissement. Les demandes de confirmation, l'affichage de la progression et l'accès aux ressources dépendent du client.
58 outils couvrent la création de schémas, l'enrichissement, les benchmarks, la synchronisation de base de données et les identités sémantiques. Ils réutilisent les services backend pour la validation, la facturation et le traitement. Chaque outil expose ses propres paramètres pris en charge. Les opérations longues (enrichissement par traitement par lot, génération d'échantillons, exécutions de benchmark) sont asynchrones : l'outil de démarrage renvoie un job_id, le client interroge get_job_statuspuis lit les enregistrements ou les résultats de benchmark obtenus. Inspectez les échecs et les résultats partiels avant d'annoncer une réussite.
| Catégorie | Outil | Description |
|---|---|---|
| Découverte | list_models | Listez les clés de modèles disponibles, les capacités nominales, les langues, les stratégies, les valeurs par défaut sélectionnées automatiquement et les profile_limits de l'organisation. |
| Schémas | generate_sample | Générez un JSON d'échantillon modifiable à partir d'une demande en texte libre, pour la création de schémas. |
| Schémas | list_schemas | Listez les schémas enregistrés de votre organisation, les épinglés en premier. |
| Schémas | get_schema | Consultez un schéma enregistré avec ses propriétés, ses annotations et son input_contract. |
| Schémas | create_schema_from_sample | Générez et enregistrez automatiquement un schéma à partir d'échantillons validés ; renvoie schema_id, le contenu du schéma et les liens vers les enregistrements. |
| Schémas | save_schema | Enregistrer un schéma rédigé directement et renvoyer son ID et son lien. |
| Schémas | update_schema | Modifiez les métadonnées d'un schéma enregistré ou remplacez l'intégralité de son schema_content sans appel au LLM. |
| Schémas | get_schema_part | Ne lisez que le fragment de schéma nécessaire à une modification. |
| Schémas | get_enum_candidates | Listez les valeurs observées en dehors du vocabulaire actuel de chaque énumération ouverte, avec leur nombre d'occurrences dans les enregistrements d'enrichissement récents. |
| Schémas | update_schema_property | Modifiez ou supprimez une propriété par son chemin, sans remplacer le schéma complet. |
| Schémas | add_schema_property | Ajoutez une propriété sous la racine (parent_path='), sous un chemin d'objet ou sous '$defs.X'. |
| Schémas | move_schema_property | Déplacez une propriété vers la racine, un chemin d'objet ou '$defs.X', en conservant ses indicateurs et son expertise. |
| Schémas | resolve_unify_proposal | Résolvez une proposition d'unification de types d'entités en attente issue de get_schema. |
| Schémas | nest_schema_region | Imbriquer une région d’entité plate issue du x-entityMap de get_schema dans un sous-objet de l’objet qui contient ses champs : les membres plats de la région (p. ex. product_id, product_name sur une commande… |
| Schémas | publish_schema | Publiez la copie de travail d'un schéma lié à une base de données en tant que contrat utilisé par l'enrichissement et les répliques. |
| Schémas | delete_schema | Effectuez une suppression logique d'un schéma enregistré par UUID. |
| Schémas | analyze_sample | Analysez l'ambiguïté des propriétés des échantillons et la portée d'identité des relations avant la génération du schéma. |
| Schémas | analyze_schema | Analysez l'ambiguïté des propriétés et la portée d'identité des relations d'un schéma enregistré, en écrivant les annotations dans le schéma. |
| Enrichissement et fusion | start_batch_enrichment | Lancer l'enrichissement asynchrone facturé d'une liste d'entités selon exactement un paramètre parmi schema_id et target_schema. |
| Enrichissement et fusion | fetch_entities | Récupérez des entités depuis une API REST externe via un GET côté serveur. |
| Enrichissement et fusion | enrich_entity | Enrichissez une entité selon exactement l'un des paramètres schema_id ou target_schema ; renvoie une sortie structurée, record_id, les coûts et le résultat éventuel côté base de données. |
| Enrichissement et fusion | retry_expertises | Relancez uniquement les domaines d'expertise en échec d'un enregistrement existant, puis mettez à jour sa sortie et tentez la fusion/synchronisation de l'exécution. |
| Enrichissement et fusion | merge_records | Fusionnez au moins deux enregistrements d'une même entité en un nouvel enregistrement d'arbitrage. |
| Contrôle des tâches | get_job_status | Consultez le statut, la progression et le résumé final compact d'une tâche, avec les ID des enregistrements persistés. |
| Contrôle des tâches | cancel_job | Demandez l'annulation d'une tâche LLM en attente, en cours ou en pause. |
| Contrôle des tâches | answer_job_question | Reprenez une tâche en pause en fournissant les réponses aux questions renvoyées lors de la mise en pause. |
| Enregistrements et statistiques | list_records | Listez les enregistrements de votre organisation sous forme compacte et paginée, du plus récent au plus ancien. |
| Enregistrements et statistiques | get_record | Consultez le structured_output, l'entity_input_data, les erreurs de validation, les verdicts d'expertise et les métriques d'un enregistrement persisté. |
| Enregistrements et statistiques | get_stats | Consultez les totaux d'enregistrements, le taux de réussite, les tokens et le récapitulatif des coûts à l'échelle de l'organisation. |
| Benchmarks | list_benchmark_scenarios | Listez les résumés compacts des scénarios de benchmark ainsi que le total. |
| Benchmarks | get_benchmark_scenario | Consultez un scénario de benchmark avec les résultats de qualité, de coût et de vitesse par modèle. |
| Benchmarks | get_benchmark_scenario_results | Filtrez, classez et limitez les résultats de benchmark par modèle d'un scénario. |
| Benchmarks | create_benchmark_scenario | Créez un benchmark réutilisable avec un juge de notation obligatoire. |
| Benchmarks | update_benchmark_scenario | Modifiez la définition de test ou la configuration de notation d'un benchmark. |
| Benchmarks | set_benchmark_reference | Enregistrer la référence gold d'un benchmark d'enrichissement ou de génération de schéma. |
| Benchmarks | delete_benchmark_scenario | Supprimez un scénario de benchmark et ses résultats enregistrés. |
| Benchmarks | run_benchmark | Lancer l'exécution et la notation asynchrones facturées d'un benchmark. |
| Pièces jointes | upload_attachment | Téléverser des octets de fichier encodés en base64 comme matériau source réutilisable ; renvoie id et requires_capability. |
| Pièces jointes | delete_attachment | Supprimez définitivement une pièce jointe de votre organisation, y compris son fichier stocké. |
| Database Sync | list_database_syncs | Listez les déclarations de bases de données, les schémas liés, les options et les hôtes de synchronisation d'un schéma enregistré. |
| Database Sync | list_entity_states | Parcourez les lignes d'entités fusionnées actuelles d'un schéma, et non les enregistrements par exécution. |
| Database Sync | create_database_sync | Déclarez un schéma enregistré pour la synchronisation relationnelle vers PostgreSQL, MySQL ou SQLite. |
| Database Sync | assign_sync_host | Attribuez ou retirez l'hôte qui provisionne une synchronisation de base de données. |
| Database Sync | classify_database_model | Lancer une analyse facturée proposant des clés de base de données, des types SQL, des index et la propriété des relations sur un schéma lié. |
| Database Sync | delete_database_sync | Supprimez une base de données enregistrée et ses deltas en file d'attente, ce qui interrompt son flux. |
| Database Sync | create_database_credential | Émettez un identifiant à usage unique pour le client de synchronisation, avec des suggestions de commandes d'installation, d'appairage et d'exécution. |
| Database Sync | fetch_database_deltas | Lisez la fenêtre ordonnée suivante des deltas SQL et des charges utiles canoniques d'une synchronisation de base de données. |
| Database Sync | ack_database_deltas | Accusez réception de chaque delta via up_to_id après une application réussie, ce qui libère son bail. |
| Database Sync | sync_records_to_database | Valider et injecter une sortie d'enrichissement stockée ou fournie dans la couche entité et les synchronisations liées. |
| ID sémantiques | list_semantic_concepts | Parcourez les concepts de l'organisation avec leurs alias, leurs compteurs d'usage et les facettes type/modèle. |
| ID sémantiques | get_semantic_concept | Consultez les alias, les clés d'identité source, les enregistrements liés et les plus proches voisins d'un concept au sein de son propre segment type/modèle. |
| ID sémantiques | probe_semantic_concept | Prévisualisez la résolution d'identité sans ajouter de concept ni augmenter son utilisation. |
| ID sémantiques | add_semantic_concept | Ajoutez un concept d'identité avec un usage à zéro, ou ajoutez un texte comme alias via alias_of. |
| ID sémantiques | update_concept_alias | Supprimez ou promouvez un alias de concept à l'aide des ID d'alias fournis par get_semantic_concept. |
| ID sémantiques | import_semantic_concepts | Résolvez de 1 à 1000 textes pour un même type de concept. |
| ID sémantiques | merge_semantic_concepts | Fusionnez un concept perdant dans un concept gagnant. |
| ID sémantiques | delete_semantic_concepts | Supprimez les concepts sélectionnés par ids, concept_types ou unused_only. |
| ID sémantiques | migrate_semantic_embeddings | Inspectez ou migrez l'espace d'embeddings de concepts de l'organisation. |
Les instructions du serveur expliquent les workflows disponibles ; les descriptions des outils expliquent chaque appel. Pour les décisions de modélisation ou la reprise après erreur, votre client peut lire l'index des guides sur enricher://docs et sélectionner un guide via les ressources MCP. La lecture d'un guide n'exécute aucun modèle. Les liens ci-dessous ouvrent ces mêmes guides, en anglais, dans le dépôt public.
Concevez un schéma réutilisable à partir d'exemples validés, avec identité, relations et champs multilingues.
Lisez, créez et modifiez des documents de schéma Entity Enricher sans confondre le JSON Schema sérialisé, les données d'exemple et les chemins des outils de propriétés.
Choisissez l'extraction, l'enrichissement par les connaissances ou une combinaison en deux passes, et préservez la provenance des pièces jointes d'un appel à l'autre.
Enrichissez une entité, interprétez son résultat réel et rattrapez les échecs partiels de modèles sans refaire le travail déjà réussi.
Enrichissez une liste d'entités de façon asynchrone et distinguez les résultats ignorés, en échec, fusionnés et admis en base de données.
Comparez les modèles sur l'enrichissement, la génération d'échantillons ou la génération de schémas, en utilisant la bonne référence et la bonne interprétation des scores.
Transformez vos schémas d'enrichissement en tables relationnelles dans votre propre base de données et vérifiez séparément l'admission, la migration et la livraison vers les réplicas.
Reconnaissez les entités récurrentes au-delà de leurs formes de surface, examinez les correspondances incertaines et comprenez l'impact des changements de vocabulaire sur les répliques.
Les ressources exposent les données de schémas et d'enregistrements, ainsi que les guides de workflow, au format Markdown. Les clients choisissent comment les découvrir et les charger ; le contenu des ressources consomme malgré tout du contexte du modèle.
| Modèle d'URI | Description |
|---|---|
| enricher://docs | Index des guides de workflow, chacun disponible à l'URI de ressource indiquée. |
| enricher://schemas/{schema_id} | Copie de travail d'un schéma enregistré, au format Markdown ; utilisez get_schema avec version="published" pour obtenir le contrat lié actif. |
| enricher://records/{record_id} | Un enregistrement d'enrichissement passé rendu en Markdown — métadonnées + sortie structurée + erreurs de validation. |
Lorsque vous demandez à enrich_entity d'utiliser un modèle de classification et que l'entité ne correspond pas au type du schéma, l'outil renvoie une réponse sans erreur avec des détails structurés. Claude la lit, vous présente le raisonnement et (après votre confirmation) réessaie avec force_after_classification_warning=true — ce qui désactive le classificateur lors de la nouvelle tentative.
{
"success": false,
"error_code": "classification_warning",
"message": "Pre-flight classification rejected the entity. ...",
"classification": {
"status": "mismatch",
"reasoning": "Titan is a moon of Saturn, not a planet.",
"confidence": 0.97
},
"job_id": "..."
}La réponse MCP conserve les détails de la classification afin que votre client puisse expliquer la décision avant de lancer un nouvel appel.
La même interactivité alimente un second flux : lorsque generate_sample s'exécute avec des documents sources, son planificateur peut se mettre en pause avec des questions de clarification structurelles. Claude vous les relaie et reprend la tâche avec answer_job_question — cycle après cycle, jusqu'à ce que l'échantillon soit généré.
La plupart des erreurs d'outil renvoient un objet structuré avec un champ error_code, afin que le client puisse distinguer les échecs de quota, de classification, de délai d'attente et de provider. Certaines réponses plus anciennes ne comportent qu'un champ error ou message ; inspectez le résultat lui-même autant que le statut de transport.
| error_code | Quand |
|---|---|
| invalid_request | UUID mal formé, arguments mutuellement exclusifs (schema_id + target_schema) ou échec de la validation du corps de la requête. |
| prompt_limit_reached | Quota de prompts quotidien / hebdomadaire / mensuel épuisé (HTTP 402). Le corps de la réponse inclut period, limit, used, needed. |
| insufficient_credits | L'organisation a la facturation activée mais le solde de crédits est trop faible pour démarrer la tâche (HTTP 402). Le corps de la réponse inclut le solde et une URL d'achat. |
| model_limit_exceeded | Plus de modèles demandés que le forfait n'en autorise (HTTP 402). Renvoie la limite + le nombre demandé. |
| language_limit_exceeded | Plus de langues demandées que le forfait n'en autorise (HTTP 402). |
| concurrent_job_limit_reached | Trop de tâches d'enrichissement actives pour cette organisation. Patientez ou passez à un forfait supérieur. |
| classification_warning | ⚡ Non-erreur : le classificateur préliminaire a rejeté l'entité. La réponse contient le contexte de classification afin que Claude puisse demander confirmation à l'utilisateur et réessayer avec force_after_classification_warning=true. |
| benchmarks_not_in_plan | Le plan de l'organisation n'inclut pas les Benchmarks de modèles (HTTP 403). Les outils de benchmark en écriture vérifient également le rôle de propriétaire. |
| ambiguity_check_disabled | analyze_schema a été appelé sur un schéma dont la vérification d'ambiguïté est désactivée (HTTP 400). Réactivez-la d'abord via update_schema avec ambiguity_check_enabled=true. |
| enrichment_timeout | La tâche a dépassé timeout_seconds. Essayez avec moins de modèles ou en divisant l'entité. |
| schema_generation_timeout | La génération du schéma a dépassé timeout_seconds. |
| schema_generation_failed | Erreur LLM en amont lors de la génération du schéma (HTTP 502). |
| model_output_invalid | Le modèle a renvoyé une sortie qui ne correspond pas au schéma (HTTP 502). Le corps de la réponse indique le modèle, le chemin de la propriété en cause et retryable: true — appelez à nouveau l'outil, ou choisissez un modèle plus puissant. |
| cancelled | La tâche a été annulée en cours d'exécution (HTTP 499). |
| not_found | Le schéma ou l'ID d'enregistrement n'existe pas dans votre organisation. |
| http_error | Cas générique pour les erreurs HTTP sans corps de détail structuré. |
get_stats fournit les résumés côté chat ; les tableaux de bord complets restent dans l'application.