Codex, Cursor, VS Code met GitHub Copilot, Claude Code en Claude maken verbinding met dezelfde Entity Enricher MCP-server. Hun agents kunnen schema's ontwerpen, entiteiten in meerdere talen verrijken, modellen fuseren, semantische identiteiten cureren, kwaliteit benchmarken en relationele tabellen naar een database synchroniseren — op de modellen van het platform of op het eigen model van de client wanneer de taak zijn LLM-aanroepen delegeert — en de supportassistent van het product vragen stellen wanneer een vraag over Entity Enricher zelf gaat.
Schemavalidatie en overeenstemming tussen modellen garanderen geen feitelijke juistheid of actualiteit. Bekijk bronnen, fouten en gedeeltelijke databaseresultaten. De MCP biedt conversationele toegang; n8n en Make bieden workflowautomatisering op dezelfde service.
Standaard draait elke start-tool zijn taak op je eigen model (met use_platform_models=true, of door een platformmodel op te geven, draait hij op de gefactureerde modellen van het platform). De taak doet geen enkele platformmodelaanroep en kost geen credits: het model achter je MCP-client — hetzelfde model dat je gesprek, je documenten en je verbonden tools al bij zich heeft — beantwoordt elke modelaanroep van de taak, en het platform blijft doen waar het goed in is: de prompts opbouwen, het uitvoerschema afdwingen, elk antwoord valideren en normaliseren, de records opslaan en de databases synchroniseren.
enable_web_search waar de tool dat accepteert: laat je het weg, dan krijg je web_search_undecided terug zodat je het eerst aan de gebruiker vraagt, want het zoeken zou van jou zijn. De taak pauzeert zodra de eerste modelaanroep klaarstaat.llm_requests in de jobstatus: elk item is één modelaanroep in de vorm van MCP sampling/createMessage — systeemprompt, berichten, tools en toolChoice — met een purpose die de stap benoemt en een deadline. Binaire bijlagen worden aangeduid alsenricher://attachments/{id}-resources en nooit inline opgenomen; geëxtraheerde tekst staat al in de berichten. Een client die het bestand heeft geüpload, leest zijn eigen kopie, dus een bijlage vereist nooit een platformmodel.answer_llm_request. Het platform valideert het tegen het schema, precies zoals het het antwoord van een provider valideert; een afgewezen antwoord komt terug als hetzelfde gesprek met de fout in een mislukt tool-resultaat, zodat je het kunt corrigeren en opnieuw kunt antwoorden.Protocoldetails en uitzonderingen — de opt-out, de beslissing over zoeken op het web, gelijktijdige verzoeken, herstelverzoeken bij verrijking, bijlagen, time-outs — vind je in de hieronder vermelde gids Gedelegeerde LLM-aanroepen.
Met OAuth kan een client verbinding maken zonder API-sleutel. Het toestemmingsscherm van Entity Enricher laat zien om welke client en organisatie het gaat en welke rol aan de verbinding wordt toegekend. Toegang beheer je of trek je in via API-sleutels → Verbonden apps.
Deze voorbeelden gebruiken aanmelden via de browser (OAuth) en hetzelfde Streamable HTTP-endpoint: https://entityenricher.ai/api/mcp/, inclusief de slash aan het eind. Elke client heeft zijn eigen configuratieformaat.
Codex deelt MCP-instellingen tussen zijn app, CLI en IDE-extensie via ~/.codex/config.toml. Het eerste commando registreert Entity Enricher; het login-commando opent het aanmelden via de browser wanneer authenticatie nodig is.
codex mcp add entity-enricher --url https://entityenricher.ai/api/mcp/
codex mcp login entity-enricherCursor leest projectservers uit .cursor/mcp.json of persoonlijke servers uit ~/.cursor/mcp.json. De vermelding van de externe server gebruikt mcpServers; Cursor handelt het OAuth-aanmeldproces af.
{
"mcpServers": {
"entity-enricher": {
"url": "https://entityenricher.ai/api/mcp/"
}
}
}VS Code gebruikt .vscode/mcp.json met een servers-object en een expliciet http-transport. Als je de server start, worden de tools na autorisatie beschikbaar voor de agent van GitHub Copilot.
{
"servers": {
"entity-enricher": {
"type": "http",
"url": "https://entityenricher.ai/api/mcp/"
}
}
}Dit commando registreert een externe HTTP-server in Claude Code. Met het commando /mcp in Claude Code open je de instellingen voor verbinding en authenticatie.
claude mcp add --transport http entity-enricher https://entityenricher.ai/api/mcp/Op claude.ai en Claude Desktop bieden de Connectors-instellingen de actie "Aangepaste connector toevoegen". De connector gebruikt de server-URL hierboven en opent het autorisatiescherm van Entity Enricher. Deze gehoste verbinding stel je in via Connectors; claude_desktop_config.json is bedoeld voor lokale servers.
Toegangssleutels voor de organisatie maak je aan onder Instellingen → API-sleutels, met een gekozen rol. Clients kunnen de sleutel meesturen in een X-API-Key-header in plaats van aan te melden met OAuth. Deze Codex-configuratie leest de sleutel bijvoorbeeld uit een omgevingsvariabele:
[mcp_servers.entity-enricher]
url = "https://entityenricher.ai/api/mcp/"
env_http_headers = { "X-API-Key" = "ENTITY_ENRICHER_API_KEY" }ENTITY_ENRICHER_API_KEY moet de sleutel bevatten in de omgeving van het proces dat Codex uitvoert. Cursor en VS Code accepteren deze HTTP-header in hun eigen headers-configuratieobject. De clientreferenties hierboven beschrijven welke instellingen ze ondersteunen.
Dezelfde vraag werkt in alle clients: "Toon mijn Entity Enricher-schema's, verrijk daarna Sanofi met mijn schema voor farmaceutische bedrijven en laat het opgeslagen resultaat zien."De client ontdekt de tools en gebruikt ze om een schema te kiezen en de verrijking uit te voeren. Bevestigingsvragen, voortgangsweergave en toegang tot resources verschillen per client.
62 tools dekken het opstellen van schema's, verrijking, benchmarks, database sync, semantische identiteiten en productondersteuning. Ze hergebruiken backendservices voor validatie, facturering en verwerking. Elke tool biedt zijn eigen ondersteunde parameters. Langlopend werk (batchverrijking, samplegeneratie, benchmarkruns) is asynchroon: de start-tool geeft een job_id terug, de client pollt get_job_statusen leest de resulterende records of benchmarkresultaten. Onderzoek fouten en gedeeltelijke resultaten voordat je succes rapporteert.
| Categorie | Tool | Beschrijving |
|---|---|---|
| Ontdekking | list_models | Toon beschikbare modelsleutels, nominale mogelijkheden, talen, strategieën, automatisch geselecteerde standaardwaarden en de profile_limits van de organisatie. |
| Schema's | generate_sample | Genereer bewerkbare voorbeeld-JSON uit een vrijetekstverzoek voor het opstellen van schema's. |
| Schema's | list_schemas | Toon opgeslagen schema's in je organisatie, vastgezette eerst. |
| Schema's | get_schema | Lees een opgeslagen schema met de properties, annotaties en input_contract. |
| Schema's | create_schema_from_sample | Genereer een schema uit beoordeelde samples en sla het automatisch op; retourneert schema_id, schema-inhoud en recordkoppelingen. |
| Schema's | save_schema | Sla een rechtstreeks geschreven schema op en geef de ID en link terug. |
| Schema's | update_schema | Bewerk de metadata van een opgeslagen schema of vervang de volledige schema_content zonder LLM-aanroep. |
| Schema's | get_schema_part | Lees alleen het schemafragment dat nodig is voor een bewerking. |
| Schema's | get_enum_candidates | Toon waargenomen waarden buiten de huidige woordenlijst van elke open enum, met aantallen uit recente verrijkingsrecords. |
| Schema's | update_schema_property | Bewerk of verwijder één property via het pad zonder het volledige schema te vervangen. |
| Schema's | add_schema_property | Voeg een property toe onder de root (parent_path='), een objectpad of '$defs.X'. |
| Schema's | move_schema_property | Verplaats één property naar de root, een objectpad of '$defs.X', met behoud van de flags en expertise ervan. |
| Schema's | resolve_unify_proposal | Handel één openstaand unificatievoorstel voor entiteitstypen uit get_schema af. |
| Schema's | nest_schema_region | Materialiseer een entiteitsregio uit de x-entityMap van get_schema. |
| Schema's | publish_schema | Publiceer de werkkopie van een database-gekoppeld schema als het contract dat door verrijking en replica's wordt gebruikt. |
| Schema's | delete_schema | Soft-delete een opgeslagen schema op UUID. |
| Schema's | analyze_sample | Analyseer de ambiguïteit van properties in samples en de identiteitsscoping van relaties vóór het genereren van het schema. |
| Schema's | analyze_schema | Analyseer de ambiguïteit van properties en de identiteitsscoping van relaties in een opgeslagen schema, en schrijf annotaties naar het schema. |
| Verrijking & fusie | start_batch_enrichment | Start betaalde asynchrone verrijking van een entiteitenlijst tegen precies één van schema_id of target_schema. |
| Verrijking & fusie | enrich_entity | Verrijk één entiteit tegen precies één van schema_id of target_schema, met gestructureerde output, record_id, kosten en een eventueel databaseresultaat. |
| Verrijking & fusie | retry_expertises | Probeer alleen de mislukte expertisedomeinen van een bestaand record opnieuw, werk vervolgens de output ervan bij en probeer de fusie/synchronisatie van de run. |
| Verrijking & fusie | merge_records | Fuseer twee of meer records van dezelfde entiteit tot een nieuw arbitragerecord. |
| Taakbeheer | get_job_status | Lees de status, voortgang en compacte eindsamenvatting van een taak, met de opgeslagen record-ID's. |
| Taakbeheer | cancel_job | Vraag annulering aan van een wachtende, lopende of gepauzeerde LLM-taak. |
| Taakbeheer | answer_job_question | Hervat een gepauzeerde taak met antwoorden op de vragen die bij de pauze zijn teruggegeven. |
| Taakbeheer | answer_llm_request | Lever het resultaat in van één openstaande modelaanroep van een gedelegeerde taak: een taak die de gebruiker op het eigen model van de client heeft gestart (de standaard van elke starttool, tenzij use_platform_models=true of een… |
| Records & statistieken | list_records | Toon compacte, gepagineerde records in je organisatie, meest recente eerst. |
| Records & statistieken | get_record | Lees de structured_output, entity_input_data, validatiefouten, expertise-oordelen en metrics van één opgeslagen record. |
| Records & statistieken | get_stats | Lees organisatiebrede recordtotalen, slagingspercentage, tokens en kostenoverzicht. |
| Benchmarks | list_benchmark_scenarios | Toon compacte samenvattingen van benchmarkscenario's en het totaal. |
| Benchmarks | get_benchmark_scenario | Lees één benchmarkscenario met kwaliteits-, kosten- en snelheidsresultaten per model. |
| Benchmarks | get_benchmark_scenario_results | Filter, rangschik en beperk de benchmarkresultaten per model van een scenario. |
| Benchmarks | create_benchmark_scenario | Maak een herbruikbare benchmark met een verplichte scorebeoordelaar. |
| Benchmarks | update_benchmark_scenario | Bewerk de testdefinitie of scoreconfiguratie van een benchmark. |
| Benchmarks | set_benchmark_reference | Sla de gouden referentie op voor een verrijkings- of schemageneratiebenchmark. |
| Benchmarks | revert_benchmark_reference_updates | Maak automatische bewerkingen ongedaan die een scoringsronde heeft aangebracht in de referentie van een scenario. |
| Benchmarks | delete_benchmark_scenario | Verwijder een benchmarkscenario en de opgeslagen resultaten ervan. |
| Benchmarks | run_benchmark | Start betaalde asynchrone uitvoering en scoring van een benchmark. |
| Bijlagen | upload_attachment | Upload base64-bestandsbytes als herbruikbaar bronmateriaal; geeft id en requires_capability terug. |
| Bijlagen | delete_attachment | Verwijder een bijlage in je organisatie permanent, inclusief het opgeslagen bestand. |
| Database Sync | list_database_syncs | Toon de databaseregistraties, gekoppelde schema's, opties en synchosts van een opgeslagen schema. |
| Database Sync | list_entity_states | Blader door de huidige samengevoegde entiteitsrijen van een schema, niet door records per run. |
| Database Sync | create_database_sync | Registreer een opgeslagen schema voor relationele synchronisatie naar PostgreSQL, MySQL of SQLite. |
| Database Sync | assign_sync_host | Wijs de host toe die een Database Sync provisioneert, of maak deze leeg. |
| Database Sync | classify_database_model | Start een betaalde analyse die databasesleutels, SQL-types, indexen en relatie-eigenaarschap voorstelt voor een gekoppeld schema. |
| Database Sync | delete_database_sync | Verwijder een databaseregistratie en de deltas in de wachtrij, waarmee de feed stopt. |
| Database Sync | get_database_setup_instructions | Geeft niet-geheime installatie-instructies, in de browser bevestigde koppeling en uitvoerinstructies voor een ee-database sync-client. |
| Database Sync | fetch_database_deltas | Lees het volgende geordende venster met SQL-delta's en canonieke payloads voor een database sync. |
| Database Sync | ack_database_deltas | Bevestig elke delta via up_to_id na succesvolle toepassing, waarmee de lease wordt vrijgegeven. |
| Database Sync | sync_records_to_database | Valideer opgeslagen of aangeleverde verrijkingsoutput en injecteer die in de entiteitenlaag en gekoppelde syncs. |
| Semantische ID's | list_semantic_concepts | Blader door de concepten van je organisatie met aliassen, gebruiksaantallen en type-/modelfacetten. |
| Semantische ID's | get_semantic_concept | Lees de aliassen, identiteitsbronsleutels, gekoppelde records en dichtstbijzijnde buren van één concept binnen zijn eigen type/model-slice. |
| Semantische ID's | probe_semantic_concept | Bekijk een voorbeeld van identiteitsresolutie zonder een concept toe te voegen of het gebruik ervan te verhogen. |
| Semantische ID's | add_semantic_concept | Voeg een identiteitsconcept toe met nul gebruik, of voeg tekst toe als alias met alias_of. |
| Semantische ID's | update_concept_alias | Verwijder of promoveer een conceptalias met alias-ID's uit get_semantic_concept. |
| Semantische ID's | import_semantic_concepts | Los 1..1000 teksten op tegen één concepttype. |
| Semantische ID's | merge_semantic_concepts | Voeg een verliezend concept samen in een winnend concept. |
| Semantische ID's | delete_semantic_concepts | Verwijder concepten geselecteerd op ids, concept_types of unused_only. |
| Semantische ID's | migrate_semantic_embeddings | Inspecteer of migreer de conceptembeddingruimte van de organisatie. |
| Productondersteuning | ask_support | Stel Rupert, de productondersteuningsassistent van Entity Enricher, een vraag over de applicatie zelf: hoe een functie, een tool of een instelling werkt, wat een error_code, een limiet of een status betekent… |
| Productondersteuning | get_support_conversation | Lees een van je supportthreads met alle berichten: je vragen (rol user), de antwoorden van Rupert (assistant) en de reacties van het supportteam (admin, met author_name). |
| Productondersteuning | list_support_conversations | Je supportthreads, nieuwste activiteit eerst, met message_count en unread_for_user (een reactie van het supportteam die je nog niet hebt gelezen). |
Serverinstructies leggen de beschikbare workflows uit; toolbeschrijvingen leggen afzonderlijke aanroepen uit. Voor modelleringsbeslissingen of herstel kan je client de gidsindex lezen op enricher://docs en een gids kiezen via MCP-resources. Het lezen van een gids voert geen model uit. De links hieronder openen dezelfde Engelstalige gidsen in de openbare repository.
Standaard draait elke job die je start op je eigen model: antwoord op elke modelaanroep met `answer_llm_request` en laat het platform elk antwoord valideren tegen het schema. Met `use_platform_models=true` draait de job in plaats daarvan op het platform, op het model van de organisatie dat volgens de benchmark het beste is voor de taak.
Ontwerp een herbruikbaar schema op basis van beoordeelde voorbeelden, inclusief identiteit, relaties en meertalige velden.
Lees, schrijf en bewerk Entity Enricher-schemadocumenten zonder geserialiseerde JSON Schema, voorbeelddata en property-toolpaden door elkaar te halen.
Kies extractie, kennisverrijking of een combinatie in twee passes, en behoud de herkomst van bijlagen over aanroepen heen.
Verrijk een entiteit, interpreteer het werkelijke resultaat en herstel gedeeltelijke modelfouten zonder geslaagd werk over te doen.
Verrijk een entiteitenlijst asynchroon en onderscheid overgeslagen, mislukte, gefuseerde en in de database toegelaten resultaten.
Vergelijk modellen op verrijking, samplegeneratie of schemageneratie, met de juiste referentie en score-interpretatie.
Zet verrijkingsschema's om in relationele tabellen in je eigen database en controleer toelating, migratie en replicalevering afzonderlijk.
Herken terugkerende entiteiten in verschillende schrijfwijzen, beoordeel onzekere matches en begrijp hoe wijzigingen in de woordenlijst replica's beïnvloeden.
Stel Rupert, de productondersteuningsassistent, al je vragen over Entity Enricher zelf, ga verder in de thread die je hebt geopend en lees de reacties van het supportteam.
Resources stellen schema- en recordgegevens plus workflowgidsen beschikbaar als Markdown. Clients bepalen zelf hoe ze die vinden en laden; resource-inhoud kan nog steeds modelcontext verbruiken.
| URI-sjabloon | Beschrijving |
|---|---|
| enricher://docs | Index van de workflowgidsen, elk beschikbaar op de vermelde resource-URI. |
| enricher://schemas/{schema_id} | Een opgeslagen werkkopie van een schema als Markdown; gebruik get_schema met version="published" voor het actieve gekoppelde contract. |
| enricher://records/{record_id} | Een eerder verrijkingsrecord weergegeven als Markdown — metadata + gestructureerde output + validatiefouten. |
| enricher://attachments/{attachment_id} | De bytes van een geüploade bijlage, geleverd met hun echte mediatype — zo geeft een job die zijn LLM-aanroepen delegeert je client een PDF-, afbeeldings- of audiobestand dat de client niet zelf heeft geüpload. |
Wanneer een vraag over Entity Enricher zelf gaat — hoe een functie of een tool werkt, wat een foutcode, een limiet of een waarschuwing betekent, waarom een resultaat eruitziet zoals het eruitziet — en de handleidingen geen antwoord geven, schrijven de serverinstructies de agent voor om Rupert, de productsupportassistent, te vragen met ask_support in plaats van te gokken. De aanroep geeft het volledige antwoord terug en de id van de thread die is geopend; door dieconversation_id mee te geven aan de volgende vraag blijft de context van de uitwisseling behouden.
Elke vraag gaat ten koste van het dagelijkse supportquotum van de organisatie, gerapporteerd alsquestions_remaining. Het supportteam kan in de thread antwoorden: de volgende ask_support daarop geeft die reacties terug alsnew_admin_messages, enget_support_conversation leest een hele thread. Dezelfde threads verschijnen in de supportchat van de webapp en, voor eigenaren, op het tabblad Discussies van de pagina Gebruikers, met een badge dat ze door een AI-agent zijn geopend.
Als je enrich_entity vraagt een classificatiemodel te gebruiken en de entiteit niet bij het schematype past, geeft de tool eenniet-foutieve respons terug met gestructureerde details. De client leest die, toont jou de onderbouwing en probeert het (na jouw bevestiging) opnieuw met force_after_classification_warning=true — waarbij de classificatie bij die nieuwe poging wordt overgeslagen.
{
"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": "..."
}De MCP-respons behoudt de classificatiedetails zodat je client de beslissing kan uitleggen voordat er een nieuwe aanroep wordt gestart.
Dezelfde interactiviteit maakt een tweede flow mogelijk: wanneer generate_sample met brondocumenten draait, kan de planner pauzeren met vragen over de structuur. De client geeft die aan je door en hervat de job met answer_job_question — ronde na ronde, tot het sample is gegenereerd.
De meeste toolfouten leveren een gestructureerd object met een error_code-veld, zodat de client onderscheid kan maken tussen quota-, classificatie-, time-out- en providerfouten. Sommige oudere responses bevatten alleen een error- of message-veld; inspecteer zowel het werkelijke resultaat als de transportstatus.
| error_code | Wanneer |
|---|---|
| invalid_request | Ongeldige UUID, wederzijds uitsluitende argumenten (schema_id + target_schema), of validatie van de request-body mislukt. |
| prompt_limit_reached | Dagelijks / wekelijks / maandelijks prompt-quotum uitgeput (HTTP 402). De body bevat period, limit, used en needed. |
| insufficient_credits | Org heeft facturering ingeschakeld maar het creditsaldo is te laag om de taak te starten (HTTP 402). De body bevat het saldo en een aankoop-URL. |
| model_limit_exceeded | Meer modellen aangevraagd dan het plan toestaat (HTTP 402). Geeft limiet + aangevraagd terug. |
| language_limit_exceeded | Meer talen aangevraagd dan het plan toestaat (HTTP 402). |
| concurrent_job_limit_reached | Te veel actieve verrijkingstaken voor deze organisatie. Wacht of upgrade je abonnement. |
| classification_warning | ⚡ Geen fout: de pre-flight-classificator heeft de entiteit afgewezen. Het antwoord bevat de classificatiecontext, zodat de client de gebruiker om bevestiging kan vragen en het opnieuw kan proberen met force_after_classification_warning=true. |
| benchmarks_not_in_plan | Het plan van de organisatie bevat geen Model Benchmarks (HTTP 403). Benchmarktools die wijzigingen aanbrengen, controleren ook de eigenaarsrol. |
| support_question_limit_reached | Het dagelijkse quotum supportvragen van de organisatie is verbruikt (HTTP 402). De body bevat limit en used; elk ask_support-resultaat rapporteert questions_remaining. |
| support_requires_user | ask_support is aangeroepen met een organisatietoegangssleutel (HTTP 403). Een supportthread hoort bij een persoon: meld je aan met OAuth of een persoonlijke API-sleutel. |
| support_unavailable | De supportassistent kon niet antwoorden (relayfout). De vraag telt toch mee en de thread bestaat: lees die later met get_support_conversation in plaats van direct opnieuw te vragen. |
| web_search_undecided | Er is een start-tool aangeroepen zonder enable_web_search voor een taak die op jouw model draait. Vraag de gebruiker of jouw model zoeken op het web mag gebruiken en roep de tool daarna opnieuw aan met enable_web_search=true of false. |
| delegation_requires_auto | Een taak die op jouw model draait, kreeg na de start een expliciet platformmodel toegewezen, bijvoorbeeld een standaardmodel van de organisatie (HTTP 400). Start de taak met use_platform_models=true of verwijder dat standaardmodel. |
| request_not_pending | answer_llm_request verwees naar een verzoek dat al beantwoord of verlopen is, of dat bij een job hoort die verder is gegaan. Bekijk get_job_status(job_id).llm_requests voor wat er nu openstaat. |
| llm_request_pending | answer_job_question is aangeroepen op een job die gepauzeerd is op gedelegeerde LLM-verzoeken, niet op een vraag. Antwoord daarop met answer_llm_request. |
| llm_request_timeout | Een job die zijn LLM-aanroepen delegeert, kreeg binnen 15 minuten geen antwoord op een openstaand verzoek; de job is mislukt. Gedelegeerde jobs hebben geen standaardantwoord. |
| ambiguity_check_disabled | analyze_schema is aangeroepen op een schema waarvan de ambiguïteitscontrole is uitgeschakeld (HTTP 400). Schakel deze eerst weer in via update_schema met ambiguity_check_enabled=true. |
| enrichment_timeout | Job overschreed timeout_seconds. Overweeg minder modellen of splits de entity. |
| schema_generation_timeout | Schemageneratie heeft timeout_seconds overschreden. |
| schema_generation_failed | Upstream-LLM-fout tijdens schema-generatie (HTTP 502). |
| model_output_invalid | Het model gaf uitvoer terug die niet overeenkomt met het schema (HTTP 502). De body bevat de naam van het model, het pad van de problematische eigenschap en retryable: true — roep de tool opnieuw aan of kies een sterker model. |
| cancelled | Job werd tijdens de run geannuleerd (HTTP 499). |
| not_found | Schema- of record-ID bestaat niet in je organisatie. |
| http_error | Verzamelpost voor HTTP-fouten zonder gestructureerde detailinhoud. |
get_stats dekt samenvattingen aan de chatkant; de volledige dashboards blijven in de app.