MCP-Server (Claude Desktop / Code / Cursor)

Nutzen Sie Entity Enricher über einen MCP-kompatiblen Client, um Modellwissen und Dokumente in strukturierte Daten zu verwandeln. Entwerfen Sie Schemata, reichern Sie Entitäten in mehreren Sprachen an, fusionieren Sie Modelle, pflegen Sie semantische Identitäten, prüfen Sie die Qualität per Benchmark und synchronisieren Sie relationale Tabellen mit Ihrer eigenen Datenbank.

Schemavalidierung und Übereinstimmung zwischen Modellen garantieren weder sachliche Richtigkeit noch Aktualität. Prüfen Sie Quellen, Fehler und unvollständige Datenbankergebnisse. MCP bietet konversationellen Zugriff; n8n und Make bieten Workflow-Automatisierung über denselben Dienst.

Schnellstart

Option 1 — OAuth (empfohlen)

Für claude.ai, Claude Code, Cursor und jeden MCP-Client, der den standardmäßigen OAuth-Flow unterstützt. Kein API-Schlüssel zum Erstellen oder Einfügen — der Client erkennt den Autorisierungsserver automatisch.

  1. Fügen Sie Entity Enricher als Connector hinzu (in claude.ai: Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen, oder wählen Sie ihn aus dem Verzeichnis) mit der URL https://entityenricher.ai/api/mcp/.
  2. In Ihrem Browser öffnet sich der Zustimmungsbildschirm von Entity Enricher — melden Sie sich bei Bedarf an und klicken Sie auf Autorisieren. Die Verbindung handelt in Ihrem Namen mit Ihrer eigenen Rolle.
  3. Verwalten oder widerrufen Sie die Verbindung jederzeit unter API-Schlüssel → Verbundene Apps — ein Widerruf unterbricht den Zugriff sofort.
  1. 1Die Organisation, auf die die Berechtigung beschränkt ist
  2. 2Die Verbindung handelt mit Ihrer eigenen Rolle, niemals mit einer weitergehenden
  3. 3Jederzeit unter „Verbundene Apps“ widerrufbar
Der einzige Entity-Enricher-Bildschirm, den der OAuth-Weg Ihnen zeigt: Er nennt die Organisation, auf die die Berechtigung beschränkt ist, und die Rolle, mit der sie handeln wird — Ihre eigene.

Option 2 — API-Schlüssel (statische JSON-Konfiguration)

Für Clients, die über eine JSON-Datei statt über eine interaktive Anmeldung konfiguriert werden (Claude Desktop, Continue, Zed).

  1. 1. Erstellen Sie einen API-Schlüssel
    In der Entity-Enricher-Weboberfläche: Einstellungen → API-Schlüssel → Neuer Organisationszugriffsschlüssel. Wählen Sie eine Rolle (Operator für überwiegend lesenden Zugriff, Editor zum Erstellen/Bearbeiten von Schemas, Owner für volle Kontrolle). Kopieren Sie den Wert ent_… – er wird nur einmal angezeigt.
  2. 2. Registrieren Sie sich in Ihrem MCP-Client

    Für Claude Desktop bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

    {
      "mcpServers": {
        "entityenricher": {
          "url": "https://entityenricher.ai/api/mcp/",
          "headers": { "X-API-Key": "ent_your_key_here" }
        }
      }
    }

    Verwenden Sie den Endpunkt und den Header oben in der Remote-MCP-Konfiguration Ihres Clients. Konfigurationssyntax und Unterstützung für den HTTP-Transport hängen vom Client ab.

Ausprobieren

In einem neuen Chat: „Meine Entity Enricher Schemas auflisten und anschließend Sanofi mit Claude Sonnet gegen das Schema für Pharmaunternehmen anreichern.“Der Client kann die Tools erkennen und damit ein Schema auswählen und die Anreicherung ausführen. Bestätigungsabfragen, Fortschrittsanzeige und Ressourcenzugriff hängen vom Client ab.

Tools

58 Tools decken Schema-Erstellung, Anreicherung, Benchmarks, Database Sync und semantische Identitäten ab. Sie nutzen Backend-Dienste für Validierung, Abrechnung und Verarbeitung. Jedes Tool stellt seine eigenen unterstützten Parameter bereit. Länger laufende Vorgänge (Batch-Anreicherung, Beispielgenerierung, Benchmark-Läufe) sind asynchron: Das Start-Tool liefert eine job_id zurück, der Client fragt get_job_statusab und liest die resultierenden Datensätze oder Benchmark-Ergebnisse. Prüfen Sie Fehler und Teilergebnisse, bevor Sie Erfolg melden.

KategorieToolBeschreibung
Entdeckunglist_modelsVerfügbare Modellschlüssel, nominale Fähigkeiten, Sprachen, Strategien, automatisch gewählte Standardwerte und profile_limits der Organisation auflisten.
Schemasgenerate_sampleGeneriert aus einer Freitextanfrage bearbeitbares Beispiel-JSON für die Schema-Erstellung.
Schemaslist_schemasGespeicherte Schemas Ihrer Organisation auflisten, angeheftete zuerst.
Schemasget_schemaEin gespeichertes Schema mit seinen Eigenschaften, Annotationen und input_contract lesen.
Schemascreate_schema_from_sampleGeneriert aus geprüften Beispielen ein Schema, speichert es automatisch und liefert schema_id, Schemainhalt und Datensatzverknüpfungen.
Schemassave_schemaSpeichert ein direkt erstelltes Schema und gibt dessen ID und Link zurück.
Schemasupdate_schemaBearbeitet die Metadaten eines gespeicherten Schemas oder ersetzt dessen vollständigen schema_content ohne LLM-Aufruf.
Schemasget_schema_partNur das für eine Bearbeitung benötigte Schemafragment lesen.
Schemasget_enum_candidatesBeobachtete Werte außerhalb des aktuellen Vokabulars jedes offenen Enums auflisten, mit Häufigkeiten aus aktuellen Anreicherungs-Datensätzen.
Schemasupdate_schema_propertyBearbeitet oder entfernt eine einzelne Eigenschaft per Pfad, ohne das vollständige Schema zu ersetzen.
Schemasadd_schema_propertyFügt eine Eigenschaft unter dem Root (parent_path='), einem Objektpfad oder '$defs.X' hinzu.
Schemasmove_schema_propertyEine Eigenschaft in die Wurzel, einen Objektpfad oder '$defs.X' verschieben, wobei ihre Flags und ihre Expertise erhalten bleiben.
Schemasresolve_unify_proposalEinen ausstehenden Vereinheitlichungsvorschlag für Entitätstypen aus get_schema auflösen.
Schemasnest_schema_regionVerschachtelt einen flachen Entitätsbereich aus der x-entityMap von get_schema in ein Unterobjekt des Objekts, das seine Felder enthält: die flachen Mitglieder des Bereichs (z. B. product_id, product_name in einer Bestellung…
Schemaspublish_schemaDie Arbeitskopie eines datenbankverknüpften Schemas als den Vertrag veröffentlichen, den Anreicherung und Replikate verwenden.
Schemasdelete_schemaSoft-Löschen Sie ein gespeichertes Schema anhand der UUID.
Schemasanalyze_sampleAnalysieren Sie vor der Schemagenerierung die Mehrdeutigkeit der Beispiel-Eigenschaften und den Identitätsgeltungsbereich der Beziehungen.
Schemasanalyze_schemaAnalysiert die Mehrdeutigkeit der Eigenschaften und den Identitätsgeltungsbereich der Beziehungen eines gespeicherten Schemas und schreibt Anmerkungen in das Schema.
Anreicherung & Fusionstart_batch_enrichmentStartet die kostenpflichtige asynchrone Anreicherung einer Entitätsliste anhand von genau einem der Werte schema_id oder target_schema.
Anreicherung & Fusionfetch_entitiesRuft Entitäten über einen serverseitigen GET von einer externen REST-API ab.
Anreicherung & Fusionenrich_entityReichert eine Entität gegen genau eines von schema_id oder target_schema an und liefert strukturierte Ausgabe, record_id, Kosten sowie ein etwaiges Datenbankergebnis.
Anreicherung & Fusionretry_expertisesNur die fehlgeschlagenen Fachdomänen eines vorhandenen Datensatzes erneut versuchen, anschließend dessen Ausgabe aktualisieren und Fusion/Synchronisierung des Laufs versuchen.
Anreicherung & Fusionmerge_recordsFusioniert zwei oder mehr Datensätze derselben Entität zu einem neuen Arbitrierungsdatensatz.
Job-Steuerungget_job_statusStatus, Fortschritt und kompakte Abschlusszusammenfassung eines Jobs mit den IDs der gespeicherten Datensätze lesen.
Job-Steuerungcancel_jobDen Abbruch eines ausstehenden, laufenden oder pausierten LLM-Jobs anfordern.
Job-Steuerunganswer_job_questionEinen pausierten Job mit Antworten auf die beim Pausieren zurückgegebenen Fragen fortsetzen.
Datensätze & Statistikenlist_recordsKompakte, paginierte Datensätze Ihrer Organisation auflisten, die neuesten zuerst.
Datensätze & Statistikenget_recordstructured_output, entity_input_data, Validierungsfehler, Expertise-Urteile und Metriken eines gespeicherten Datensatzes lesen.
Datensätze & Statistikenget_statsOrganisationsweite Datensatzsummen, Erfolgsquote, Tokens und Kostenübersicht lesen.
Benchmarkslist_benchmark_scenariosKompakte Zusammenfassungen der Benchmark-Szenarien und die Gesamtzahl auflisten.
Benchmarksget_benchmark_scenarioEin Benchmark-Szenario mit Qualitäts-, Kosten- und Geschwindigkeitsergebnissen je Modell lesen.
Benchmarksget_benchmark_scenario_resultsFiltert, ordnet und begrenzt die modellweisen Benchmark-Ergebnisse eines Szenarios.
Benchmarkscreate_benchmark_scenarioErstellt einen wiederverwendbaren Benchmark mit einem obligatorischen Bewertungs-Judge.
Benchmarksupdate_benchmark_scenarioBearbeitet die Testdefinition oder die Bewertungskonfiguration eines Benchmarks.
Benchmarksset_benchmark_referenceSpeichert die Goldreferenz für einen Benchmark zur Anreicherung oder Schemagenerierung.
Benchmarksdelete_benchmark_scenarioLöscht ein Benchmark-Szenario und seine gespeicherten Ergebnisse.
Benchmarksrun_benchmarkStartet die kostenpflichtige asynchrone Ausführung und Bewertung eines Benchmarks.
Anhängeupload_attachmentLädt Datei-Bytes im Base64-Format als wiederverwendbares Quellmaterial hoch; gibt id und requires_capability zurück.
Anhängedelete_attachmentEinen Anhang in Ihrer Organisation dauerhaft löschen, einschließlich der gespeicherten Datei.
Database Synclist_database_syncsDatenbankregistrierungen, verknüpfte Schemas, Optionen und Sync-Hosts eines gespeicherten Schemas auflisten.
Database Synclist_entity_statesDurchsucht die aktuellen zusammengeführten Entitätszeilen eines Schemas, nicht die Datensätze einzelner Läufe.
Database Synccreate_database_syncEin gespeichertes Schema für die relationale Synchronisierung mit PostgreSQL, MySQL oder SQLite registrieren.
Database Syncassign_sync_hostWeist den Host zu, der einen Database Sync bereitstellt, oder hebt die Zuweisung auf.
Database Syncclassify_database_modelStartet eine kostenpflichtige Analyse, die Datenbankschlüssel, SQL-Typen, Indizes und die Zuständigkeit für Beziehungen für ein verknüpftes Schema vorschlägt.
Database Syncdelete_database_syncLöscht eine Datenbankregistrierung samt ihrer eingereihten Deltas und stoppt damit deren Feed.
Database Synccreate_database_credentialEinmalige Anmeldedaten für den Sync-Client sowie Vorschläge für Installations-, Kopplungs- und Ausführungsbefehle ausstellen.
Database Syncfetch_database_deltasDas nächste geordnete Fenster von SQL-Deltas und kanonischen Payloads für einen Database Sync lesen.
Database Syncack_database_deltasBestätigen Sie nach erfolgreicher Anwendung jedes Delta über up_to_id und geben Sie damit dessen Lease frei.
Database Syncsync_records_to_databaseValidiert gespeicherte oder übergebene Anreicherungsergebnisse und fügt sie in die Entitätsebene und die verknüpften Synchronisierungen ein.
Semantic IDslist_semantic_conceptsDurchsucht Organisationskonzepte mit Aliassen, Verwendungszahlen und Typ-/Modell-Facetten.
Semantic IDsget_semantic_conceptAliase, Identitäts-Quellschlüssel, verknüpfte Datensätze und nächste Nachbarn eines Konzepts innerhalb seines eigenen Typ-/Modell-Segments lesen.
Semantic IDsprobe_semantic_conceptDie Identitätsauflösung in der Vorschau ansehen, ohne ein Konzept hinzuzufügen oder dessen Nutzung zu erhöhen.
Semantic IDsadd_semantic_conceptFügt ein Identitätskonzept mit null Verwendungen hinzu oder ergänzt Text über alias_of als Alias.
Semantic IDsupdate_concept_aliasEinen Konzept-Alias anhand der Alias-IDs aus get_semantic_concept entfernen oder hochstufen.
Semantic IDsimport_semantic_concepts1..1000 Texte gegen einen Konzepttyp auflösen.
Semantic IDsmerge_semantic_conceptsEin Verlierer-Konzept in ein Gewinner-Konzept zusammenführen.
Semantic IDsdelete_semantic_conceptsLöscht Konzepte, ausgewählt über ids, concept_types oder unused_only.
Semantic IDsmigrate_semantic_embeddingsDen Konzept-Einbettungsraum der Organisation prüfen oder migrieren.

Workflow-Leitfäden, bei Bedarf geladen

Die Serveranweisungen erläutern die verfügbaren Workflows; die Tool-Beschreibungen erläutern einzelne Aufrufe. Für Modellierungsentscheidungen oder die Fehlerbehebung kann Ihr Client das Leitfadenverzeichnis unter enricher://docs lesen und einen Leitfaden über MCP-Ressourcen auswählen. Das Lesen eines Leitfadens führt kein Modell aus. Die folgenden Links öffnen dieselben englischen Leitfäden im öffentlichen Repository.

Ressourcen

Ressourcen stellen Schema- und Datensatzdaten sowie Workflow-Leitfäden als Markdown bereit. Clients entscheiden, wie sie diese finden und laden; Ressourceninhalte können dennoch Modellkontext verbrauchen.

URI-VorlageBeschreibung
enricher://docsIndex der Workflow-Leitfäden, jeweils unter der angegebenen Ressourcen-URI verfügbar.
enricher://schemas/{schema_id}Eine gespeicherte Schema-Arbeitskopie als Markdown; verwenden Sie get_schema mit version="published" für den aktiven verknüpften Vertrag.
enricher://records/{record_id}Ein vergangener Anreicherungs-Datensatz, dargestellt als Markdown – Metadaten + strukturierte Ausgabe + Validierungsfehler.

Interaktive Klassifizierungsbehandlung

Wenn Sie enrich_entity anweisen, ein Klassifizierungsmodell zu verwenden, und die Entity nicht zum Schema-Typ passt, gibt das Tool eine fehlerfreie Antwort mit strukturierten Details zurück. Claude liest sie, legt Ihnen die Begründung dar und versucht es (nach Ihrer Bestätigung) erneut mit force_after_classification_warning=true – wodurch der Klassifikator beim erneuten Versuch weggelassen wird.

{
  "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": "..."
}

Die MCP-Antwort behält die Details der Klassifizierung bei, sodass Ihr Client die Entscheidung erläutern kann, bevor ein neuer Aufruf gestartet wird.

Dieselbe Interaktivität treibt einen zweiten Ablauf an: Wenn generate_sample mit Quelldokumenten läuft, kann sein Planer mit strukturellen Rückfragen pausieren. Claude leitet sie an Sie weiter und setzt den Job mit answer_job_question fort — Runde für Runde, bis das Beispiel generiert ist.

Fehlercodes

Die meisten Tool-Fehler geben ein strukturiertes Objekt mit einem Feld error_code zurück, damit der Client zwischen Kontingent-, Klassifizierungs-, Timeout- und Anbieterfehlern unterscheiden kann. Einige ältere Antworten enthalten nur ein error- oder message-Feld; prüfen Sie neben dem Transportstatus auch das tatsächliche Ergebnis.

error_codeWann
invalid_requestUngültige UUID, sich gegenseitig ausschließende Argumente (schema_id + target_schema) oder Validierung des Anfragetexts fehlgeschlagen.
prompt_limit_reachedTägliches/wöchentliches/monatliches Prompt-Kontingent erschöpft (HTTP 402). Der Body enthält period, limit, used, needed.
insufficient_creditsFür die Org ist die Abrechnung aktiviert, aber das Credit-Guthaben ist zu gering, um den Job zu starten (HTTP 402). Der Body enthält das Guthaben und eine Kauf-URL.
model_limit_exceededMehr Modelle angefordert, als der Tarif erlaubt (HTTP 402). Gibt Limit + Anforderung zurück.
language_limit_exceededMehr Sprachen angefordert, als der Tarif erlaubt (HTTP 402).
concurrent_job_limit_reachedZu viele aktive Anreicherungs-Aufträge für diese Organisation. Warten Sie oder führen Sie ein Upgrade des Tarifs durch.
classification_warning⚡ Kein Fehler: Der Pre-Flight-Klassifikator hat die Entität abgelehnt. Die Antwort enthält den Klassifizierungskontext, damit Claude den Nutzer um Bestätigung bitten und mit force_after_classification_warning=true erneut versuchen kann.
benchmarks_not_in_planDer Plan der Organisation enthält keine Modell-Benchmarks (HTTP 403). Verändernde Benchmark-Tools prüfen zusätzlich die Eigentümerrolle.
ambiguity_check_disabledanalyze_schema wurde für ein Schema aufgerufen, dessen Mehrdeutigkeitsprüfung deaktiviert ist (HTTP 400). Aktivieren Sie sie zuvor über update_schema mit ambiguity_check_enabled=true.
enrichment_timeoutJob hat timeout_seconds überschritten. Empfehlung: weniger Modelle oder die Entität aufteilen.
schema_generation_timeoutDie Schemagenerierung hat timeout_seconds überschritten.
schema_generation_failedUpstream-LLM-Fehler bei der Schema-Generierung (HTTP 502).
model_output_invalidDas Modell hat eine Ausgabe zurückgegeben, die nicht dem Schema entspricht (HTTP 502). Der Body nennt das Modell, den betreffenden Eigenschaftspfad sowie retryable: true – rufen Sie das Tool erneut auf oder wählen Sie ein leistungsstärkeres Modell.
cancelledJob wurde während der Ausführung abgebrochen (HTTP 499).
not_foundDie Schema- oder Datensatz-ID existiert nicht in Ihrer Organisation.
http_errorAuffangregel für HTTP-Fehler ohne strukturierten Detailtext.

Bewusste Auslassungen

Siehe auch