MCP-server voor Codex en andere AI-clients

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.

Voer jobs uit op het model van je client

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.

  1. Start de taak zonder expliciet model (weggelaten of auto) en bepaalenable_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.
  2. Lees 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.
  3. Voer het verzoek uit op je eigen model en geef het resultaat terug metanswer_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.
  4. Herhaal dit tot de job klaar is. De records krijgen de modelsleutel mcp::client en kosten niets; een onbeantwoord verzoek laat de job na vijftien minuten mislukken.

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.

Snel aan de slag

Aanmelden met OAuth

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

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 CLI
codex mcp add entity-enricher --url https://entityenricher.ai/api/mcp/
codex mcp login entity-enricher
Codex-documentatie

Cursor

Cursor 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.

.cursor/mcp.json
{
  "mcpServers": {
    "entity-enricher": {
      "url": "https://entityenricher.ai/api/mcp/"
    }
  }
}
Cursor-documentatie

VS Code / GitHub Copilot

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.

.vscode/mcp.json
{
  "servers": {
    "entity-enricher": {
      "type": "http",
      "url": "https://entityenricher.ai/api/mcp/"
    }
  }
}
VS Code / GitHub Copilot-documentatie

Claude Code

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 Code CLI
claude mcp add --transport http entity-enricher https://entityenricher.ai/api/mcp/
Claude Code-documentatie

Claude / Claude Desktop

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.

Documentatie over de Claude-connector
  1. 1De organisatie waartoe de toestemming beperkt is
  2. 2De verbinding handelt met je eigen rol, nooit met een ruimere
  3. 3Op elk moment in te trekken via Verbonden apps
Het toestemmingsscherm laat zien welke client de aanvraag doet, om welke organisatie het gaat en welke rol aan de verbinding wordt toegekend.

Authenticatie met API-sleutel

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:

~/.codex/config.toml
[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.

Voorbeeldgesprek

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.

Tools

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.

CategorieToolBeschrijving
Ontdekkinglist_modelsToon beschikbare modelsleutels, nominale mogelijkheden, talen, strategieën, automatisch geselecteerde standaardwaarden en de profile_limits van de organisatie.
Schema'sgenerate_sampleGenereer bewerkbare voorbeeld-JSON uit een vrijetekstverzoek voor het opstellen van schema's.
Schema'slist_schemasToon opgeslagen schema's in je organisatie, vastgezette eerst.
Schema'sget_schemaLees een opgeslagen schema met de properties, annotaties en input_contract.
Schema'screate_schema_from_sampleGenereer een schema uit beoordeelde samples en sla het automatisch op; retourneert schema_id, schema-inhoud en recordkoppelingen.
Schema'ssave_schemaSla een rechtstreeks geschreven schema op en geef de ID en link terug.
Schema'supdate_schemaBewerk de metadata van een opgeslagen schema of vervang de volledige schema_content zonder LLM-aanroep.
Schema'sget_schema_partLees alleen het schemafragment dat nodig is voor een bewerking.
Schema'sget_enum_candidatesToon waargenomen waarden buiten de huidige woordenlijst van elke open enum, met aantallen uit recente verrijkingsrecords.
Schema'supdate_schema_propertyBewerk of verwijder één property via het pad zonder het volledige schema te vervangen.
Schema'sadd_schema_propertyVoeg een property toe onder de root (parent_path='), een objectpad of '$defs.X'.
Schema'smove_schema_propertyVerplaats één property naar de root, een objectpad of '$defs.X', met behoud van de flags en expertise ervan.
Schema'sresolve_unify_proposalHandel één openstaand unificatievoorstel voor entiteitstypen uit get_schema af.
Schema'snest_schema_regionMaterialiseer een entiteitsregio uit de x-entityMap van get_schema.
Schema'spublish_schemaPubliceer de werkkopie van een database-gekoppeld schema als het contract dat door verrijking en replica's wordt gebruikt.
Schema'sdelete_schemaSoft-delete een opgeslagen schema op UUID.
Schema'sanalyze_sampleAnalyseer de ambiguïteit van properties in samples en de identiteitsscoping van relaties vóór het genereren van het schema.
Schema'sanalyze_schemaAnalyseer de ambiguïteit van properties en de identiteitsscoping van relaties in een opgeslagen schema, en schrijf annotaties naar het schema.
Verrijking & fusiestart_batch_enrichmentStart betaalde asynchrone verrijking van een entiteitenlijst tegen precies één van schema_id of target_schema.
Verrijking & fusieenrich_entityVerrijk één entiteit tegen precies één van schema_id of target_schema, met gestructureerde output, record_id, kosten en een eventueel databaseresultaat.
Verrijking & fusieretry_expertisesProbeer alleen de mislukte expertisedomeinen van een bestaand record opnieuw, werk vervolgens de output ervan bij en probeer de fusie/synchronisatie van de run.
Verrijking & fusiemerge_recordsFuseer twee of meer records van dezelfde entiteit tot een nieuw arbitragerecord.
Taakbeheerget_job_statusLees de status, voortgang en compacte eindsamenvatting van een taak, met de opgeslagen record-ID's.
Taakbeheercancel_jobVraag annulering aan van een wachtende, lopende of gepauzeerde LLM-taak.
Taakbeheeranswer_job_questionHervat een gepauzeerde taak met antwoorden op de vragen die bij de pauze zijn teruggegeven.
Taakbeheeranswer_llm_requestLever 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 & statistiekenlist_recordsToon compacte, gepagineerde records in je organisatie, meest recente eerst.
Records & statistiekenget_recordLees de structured_output, entity_input_data, validatiefouten, expertise-oordelen en metrics van één opgeslagen record.
Records & statistiekenget_statsLees organisatiebrede recordtotalen, slagingspercentage, tokens en kostenoverzicht.
Benchmarkslist_benchmark_scenariosToon compacte samenvattingen van benchmarkscenario's en het totaal.
Benchmarksget_benchmark_scenarioLees één benchmarkscenario met kwaliteits-, kosten- en snelheidsresultaten per model.
Benchmarksget_benchmark_scenario_resultsFilter, rangschik en beperk de benchmarkresultaten per model van een scenario.
Benchmarkscreate_benchmark_scenarioMaak een herbruikbare benchmark met een verplichte scorebeoordelaar.
Benchmarksupdate_benchmark_scenarioBewerk de testdefinitie of scoreconfiguratie van een benchmark.
Benchmarksset_benchmark_referenceSla de gouden referentie op voor een verrijkings- of schemageneratiebenchmark.
Benchmarksrevert_benchmark_reference_updatesMaak automatische bewerkingen ongedaan die een scoringsronde heeft aangebracht in de referentie van een scenario.
Benchmarksdelete_benchmark_scenarioVerwijder een benchmarkscenario en de opgeslagen resultaten ervan.
Benchmarksrun_benchmarkStart betaalde asynchrone uitvoering en scoring van een benchmark.
Bijlagenupload_attachmentUpload base64-bestandsbytes als herbruikbaar bronmateriaal; geeft id en requires_capability terug.
Bijlagendelete_attachmentVerwijder een bijlage in je organisatie permanent, inclusief het opgeslagen bestand.
Database Synclist_database_syncsToon de databaseregistraties, gekoppelde schema's, opties en synchosts van een opgeslagen schema.
Database Synclist_entity_statesBlader door de huidige samengevoegde entiteitsrijen van een schema, niet door records per run.
Database Synccreate_database_syncRegistreer een opgeslagen schema voor relationele synchronisatie naar PostgreSQL, MySQL of SQLite.
Database Syncassign_sync_hostWijs de host toe die een Database Sync provisioneert, of maak deze leeg.
Database Syncclassify_database_modelStart een betaalde analyse die databasesleutels, SQL-types, indexen en relatie-eigenaarschap voorstelt voor een gekoppeld schema.
Database Syncdelete_database_syncVerwijder een databaseregistratie en de deltas in de wachtrij, waarmee de feed stopt.
Database Syncget_database_setup_instructionsGeeft niet-geheime installatie-instructies, in de browser bevestigde koppeling en uitvoerinstructies voor een ee-database sync-client.
Database Syncfetch_database_deltasLees het volgende geordende venster met SQL-delta's en canonieke payloads voor een database sync.
Database Syncack_database_deltasBevestig elke delta via up_to_id na succesvolle toepassing, waarmee de lease wordt vrijgegeven.
Database Syncsync_records_to_databaseValideer opgeslagen of aangeleverde verrijkingsoutput en injecteer die in de entiteitenlaag en gekoppelde syncs.
Semantische ID'slist_semantic_conceptsBlader door de concepten van je organisatie met aliassen, gebruiksaantallen en type-/modelfacetten.
Semantische ID'sget_semantic_conceptLees de aliassen, identiteitsbronsleutels, gekoppelde records en dichtstbijzijnde buren van één concept binnen zijn eigen type/model-slice.
Semantische ID'sprobe_semantic_conceptBekijk een voorbeeld van identiteitsresolutie zonder een concept toe te voegen of het gebruik ervan te verhogen.
Semantische ID'sadd_semantic_conceptVoeg een identiteitsconcept toe met nul gebruik, of voeg tekst toe als alias met alias_of.
Semantische ID'supdate_concept_aliasVerwijder of promoveer een conceptalias met alias-ID's uit get_semantic_concept.
Semantische ID'simport_semantic_conceptsLos 1..1000 teksten op tegen één concepttype.
Semantische ID'smerge_semantic_conceptsVoeg een verliezend concept samen in een winnend concept.
Semantische ID'sdelete_semantic_conceptsVerwijder concepten geselecteerd op ids, concept_types of unused_only.
Semantische ID'smigrate_semantic_embeddingsInspecteer of migreer de conceptembeddingruimte van de organisatie.
Productondersteuningask_supportStel 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…
Productondersteuningget_support_conversationLees 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).
Productondersteuninglist_support_conversationsJe supportthreads, nieuwste activiteit eerst, met message_count en unread_for_user (een reactie van het supportteam die je nog niet hebt gelezen).

Workflowgidsen, geladen wanneer nodig

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.

Resources

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-sjabloonBeschrijving
enricher://docsIndex 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.

Productondersteuning vanuit je client

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.

Interactieve classificatieafhandeling

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.

Foutcodes

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_codeWanneer
invalid_requestOngeldige UUID, wederzijds uitsluitende argumenten (schema_id + target_schema), of validatie van de request-body mislukt.
prompt_limit_reachedDagelijks / wekelijks / maandelijks prompt-quotum uitgeput (HTTP 402). De body bevat period, limit, used en needed.
insufficient_creditsOrg 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_exceededMeer modellen aangevraagd dan het plan toestaat (HTTP 402). Geeft limiet + aangevraagd terug.
language_limit_exceededMeer talen aangevraagd dan het plan toestaat (HTTP 402).
concurrent_job_limit_reachedTe 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_planHet plan van de organisatie bevat geen Model Benchmarks (HTTP 403). Benchmarktools die wijzigingen aanbrengen, controleren ook de eigenaarsrol.
support_question_limit_reachedHet 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_userask_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_unavailableDe 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_undecidedEr 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_autoEen 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_pendinganswer_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_pendinganswer_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_timeoutEen 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_disabledanalyze_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_timeoutJob overschreed timeout_seconds. Overweeg minder modellen of splits de entity.
schema_generation_timeoutSchemageneratie heeft timeout_seconds overschreden.
schema_generation_failedUpstream-LLM-fout tijdens schema-generatie (HTTP 502).
model_output_invalidHet 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.
cancelledJob werd tijdens de run geannuleerd (HTTP 499).
not_foundSchema- of record-ID bestaat niet in je organisatie.
http_errorVerzamelpost voor HTTP-fouten zonder gestructureerde detailinhoud.

Bewuste weglatingen

Zie ook