Use Entity Enricher desde un cliente compatible con MCP para convertir el conocimiento de los modelos y sus documentos en datos estructurados. Diseñe esquemas, enriquezca entidades en varios idiomas, fusione modelos, cure identidades semánticas, evalúe la calidad con benchmarks y sincronice tablas relacionales con su propia base de datos.
La validación de esquema y la coincidencia entre modelos no garantizan la exactitud ni la actualidad de los datos. Inspeccione las fuentes, los fallos y los resultados parciales en la base de datos. El MCP ofrece acceso conversacional; n8n y Make ofrecen automatización de flujos de trabajo sobre el mismo servicio.
Para claude.ai, Claude Code, Cursor y cualquier cliente MCP compatible con el flujo OAuth estándar. Sin API key que crear ni pegar: el cliente descubre el servidor de autorización automáticamente.
https://entityenricher.ai/api/mcp/.Para clientes configurados mediante un archivo JSON en lugar de un inicio de sesión interactivo (Claude Desktop, Continue, Zed).
ent_…: solo se muestra una vez.Para Claude Desktop, edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"entityenricher": {
"url": "https://entityenricher.ai/api/mcp/",
"headers": { "X-API-Key": "ent_your_key_here" }
}
}
}Use el endpoint y la cabecera anteriores en la configuración de MCP remoto de su cliente. La sintaxis de configuración y la compatibilidad con el transporte HTTP dependen del cliente.
En un chat nuevo: «Enumera mis esquemas de Entity Enricher y, a continuación, enriquece Sanofi con el esquema de empresa farmacéutica usando Claude Sonnet.»El cliente puede descubrir las herramientas y usarlas para seleccionar un esquema y ejecutar el enriquecimiento. Los mensajes de confirmación, la visualización del progreso y el acceso a los recursos dependen del cliente.
58 herramientas abarcan la creación de esquemas, el enriquecimiento, los benchmarks, la sincronización de base de datos y las identidades semánticas. Reutilizan los servicios del backend para la validación, la facturación y el procesamiento. Cada herramienta expone sus propios parámetros admitidos. Las tareas de larga duración (enriquecimiento por lotes, generación de muestras, ejecuciones de benchmark) son asíncronas: la herramienta de inicio devuelve un job_id, el cliente consulta get_job_statusy lee los registros resultantes o los resultados del benchmark. Revise los fallos y los resultados parciales antes de informar de un éxito.
| Categoría | Herramienta | Descripción |
|---|---|---|
| Descubrimiento | list_models | Enumere las claves de modelo disponibles, las capacidades nominales, los idiomas, las estrategias, los valores predeterminados autoseleccionados y los profile_limits de la organización. |
| Esquemas | generate_sample | Genere una muestra JSON editable a partir de una solicitud en texto libre para la creación de esquemas. |
| Esquemas | list_schemas | Enumere los esquemas guardados de su organización, con los fijados primero. |
| Esquemas | get_schema | Consulte un esquema guardado con sus propiedades, anotaciones e input_contract. |
| Esquemas | create_schema_from_sample | Genere y guarde automáticamente un esquema a partir de muestras revisadas, devolviendo schema_id, el contenido del esquema y los enlaces a los registros. |
| Esquemas | save_schema | Guarda un esquema redactado directamente y devuelve su ID y su enlace. |
| Esquemas | update_schema | Edite los metadatos de un esquema guardado o reemplace su schema_content completo sin realizar una llamada al LLM. |
| Esquemas | get_schema_part | Consulte solo el fragmento del esquema necesario para una edición. |
| Esquemas | get_enum_candidates | Enumere los valores observados fuera del vocabulario actual de cada enum abierto, con recuentos de los registros de enriquecimiento recientes. |
| Esquemas | update_schema_property | Edite o elimine una propiedad por su ruta sin reemplazar el esquema completo. |
| Esquemas | add_schema_property | Añada una propiedad bajo la raíz (parent_path='), una ruta de objeto o '$defs.X'. |
| Esquemas | move_schema_property | Mueva una propiedad a la raíz, a una ruta de objeto o a '$defs.X', conservando sus indicadores y su experiencia. |
| Esquemas | resolve_unify_proposal | Resuelva una propuesta pendiente de unificación de tipos de entidad procedente de get_schema. |
| Esquemas | nest_schema_region | Anida una región de entidad plana del x-entityMap de get_schema en un subobjeto del objeto que contiene sus campos: los miembros planos de la región (p. ej., product_id, product_name en un pedido… |
| Esquemas | publish_schema | Publique la copia de trabajo de un esquema vinculado a una base de datos como el contrato que utilizan el enriquecimiento y las réplicas. |
| Esquemas | delete_schema | Elimine de forma lógica un esquema guardado por UUID. |
| Esquemas | analyze_sample | Analice la ambigüedad de las propiedades de la muestra y el alcance de identidad de las relaciones antes de generar el esquema. |
| Esquemas | analyze_schema | Analice la ambigüedad de las propiedades y el alcance de identidad de las relaciones de un esquema guardado, escribiendo las anotaciones en el esquema. |
| Enriquecimiento y fusión | start_batch_enrichment | Inicia el enriquecimiento asíncrono facturado de una lista de entidades con exactamente uno de schema_id o target_schema. |
| Enriquecimiento y fusión | fetch_entities | Obtenga entidades de una API REST externa mediante un GET del lado del servidor. |
| Enriquecimiento y fusión | enrich_entity | Enriquezca una entidad con exactamente uno de los dos parámetros, schema_id o target_schema, y obtenga una salida estructurada, record_id, los costes y el resultado en la base de datos, si lo hay. |
| Enriquecimiento y fusión | retry_expertises | Reintente únicamente los dominios de experiencia fallidos de un registro existente y, a continuación, actualice su salida e intente la fusión/sincronización de la ejecución. |
| Enriquecimiento y fusión | merge_records | Fusione dos o más registros de la misma entidad en un nuevo registro de arbitraje. |
| Control de trabajos | get_job_status | Consulte el estado, el progreso y el resumen final compacto de un trabajo, con los ID de los registros persistidos. |
| Control de trabajos | cancel_job | Solicite la cancelación de un trabajo LLM pendiente, en ejecución o en pausa. |
| Control de trabajos | answer_job_question | Reanude un trabajo en pausa con las respuestas a las preguntas devueltas durante la pausa. |
| Registros y estadísticas | list_records | Enumere los registros de su organización de forma compacta y paginada, empezando por los más recientes. |
| Registros y estadísticas | get_record | Consulte el structured_output, el entity_input_data, los errores de validación, los veredictos de experiencia y las métricas de un registro persistido. |
| Registros y estadísticas | get_stats | Consulte los totales de registros, la tasa de éxito, los tokens y el resumen de costes de toda la organización. |
| Benchmarks | list_benchmark_scenarios | Enumere resúmenes compactos de escenarios de benchmark y el total. |
| Benchmarks | get_benchmark_scenario | Consulte un escenario de benchmark con los resultados de calidad, coste y velocidad por modelo. |
| Benchmarks | get_benchmark_scenario_results | Filtre, ordene y limite los resultados de benchmark por modelo de un escenario. |
| Benchmarks | create_benchmark_scenario | Cree un benchmark reutilizable con un juez de puntuación obligatorio. |
| Benchmarks | update_benchmark_scenario | Edite la definición de prueba o la configuración de puntuación de un benchmark. |
| Benchmarks | set_benchmark_reference | Guarda la referencia de oro para un benchmark de enriquecimiento o de generación de esquemas. |
| Benchmarks | delete_benchmark_scenario | Elimine un escenario de benchmark y sus resultados almacenados. |
| Benchmarks | run_benchmark | Inicia la ejecución y la puntuación asíncronas facturadas de un benchmark. |
| Adjuntos | upload_attachment | Cargue bytes de archivo en base64 como material de origen reutilizable; devuelve id y requires_capability. |
| Adjuntos | delete_attachment | Elimine de forma permanente un adjunto de su organización, incluido su archivo almacenado. |
| Database Sync | list_database_syncs | Enumere las inscripciones en bases de datos, los esquemas vinculados, las opciones y los hosts de sincronización de un esquema guardado. |
| Database Sync | list_entity_states | Explore las filas de entidades fusionadas actuales de un esquema, no los registros de cada ejecución. |
| Database Sync | create_database_sync | Registre un esquema guardado para la sincronización relacional con PostgreSQL, MySQL o SQLite. |
| Database Sync | assign_sync_host | Asigne o borre el host que aprovisiona una sincronización de base de datos. |
| Database Sync | classify_database_model | Inicia un análisis facturado que propone claves de base de datos, tipos SQL, índices y propiedad de las relaciones en un esquema vinculado. |
| Database Sync | delete_database_sync | Elimine el registro de una base de datos y sus deltas en cola, deteniendo su flujo. |
| Database Sync | create_database_credential | Emita una credencial de un solo uso para el cliente de sincronización, junto con sugerencias de comandos de instalación, emparejamiento y ejecución. |
| Database Sync | fetch_database_deltas | Lea la siguiente ventana ordenada de deltas SQL y cargas canónicas de una sincronización de base de datos. |
| Database Sync | ack_database_deltas | Confirme cada delta mediante up_to_id tras aplicarlo correctamente, liberando así su reserva. |
| Database Sync | sync_records_to_database | Valide e inyecte resultados de enriquecimiento almacenados o proporcionados en la capa de entidades y en las sincronizaciones vinculadas. |
| IDs semánticos | list_semantic_concepts | Explore los conceptos de la organización con sus alias, recuentos de uso y facetas de tipo/modelo. |
| IDs semánticos | get_semantic_concept | Consulte los alias, las claves de origen de identidad, los registros vinculados y los vecinos más cercanos de un concepto dentro de su propio segmento de tipo/modelo. |
| IDs semánticos | probe_semantic_concept | Previsualice la resolución de identidad sin añadir un concepto ni aumentar su uso. |
| IDs semánticos | add_semantic_concept | Añada un concepto de identidad con uso cero, o añada texto como alias mediante alias_of. |
| IDs semánticos | update_concept_alias | Elimine o promueva un alias de concepto usando los ID de alias de get_semantic_concept. |
| IDs semánticos | import_semantic_concepts | Resuelva de 1 a 1000 textos frente a un único tipo de concepto. |
| IDs semánticos | merge_semantic_concepts | Fusione un concepto perdedor en uno ganador. |
| IDs semánticos | delete_semantic_concepts | Elimine los conceptos seleccionados por ids, concept_types o unused_only. |
| IDs semánticos | migrate_semantic_embeddings | Inspeccione o migre el espacio de embeddings de conceptos de la organización. |
Las instrucciones del servidor explican los flujos de trabajo disponibles; las descripciones de las herramientas explican cada llamada. Para decisiones de modelado o de recuperación, su cliente puede leer el índice de guías en enricher://docs y seleccionar una guía mediante los recursos MCP. Leer una guía no ejecuta ningún modelo. Los enlaces siguientes abren esas mismas guías en inglés en el repositorio público.
Diseñe un esquema reutilizable a partir de ejemplos revisados, incluidos la identidad, las relaciones y los campos multilingües.
Consulte, cree y edite documentos de esquema de Entity Enricher sin confundir el JSON Schema serializado, los datos de ejemplo y las rutas de las herramientas de propiedades.
Elija entre extracción, enriquecimiento de conocimiento o una combinación en dos pasadas, y conserve la procedencia de los adjuntos entre llamadas.
Enriquezca una entidad, interprete su resultado real y recupere los fallos parciales de los modelos sin repetir el trabajo ya completado.
Enriquezca una lista de entidades de forma asíncrona y distinga los resultados omitidos, fallidos, fusionados y admitidos en la base de datos.
Compare modelos en enriquecimiento, generación de muestras o generación de esquemas, usando la referencia y la interpretación de puntuación correctas.
Convierta los esquemas de enriquecimiento en tablas relacionales de su propia base de datos y verifique por separado la admisión, la migración y la entrega a las réplicas.
Reconozca entidades recurrentes en sus distintas formas superficiales, revise las coincidencias inciertas y comprenda cómo afectan los cambios de vocabulario a las réplicas.
Los recursos exponen datos de esquemas y registros, además de guías de flujo de trabajo, en Markdown. Los clientes deciden cómo descubrirlos y cargarlos; aun así, el contenido de los recursos puede consumir contexto del modelo.
| Plantilla de URI | Descripción |
|---|---|
| enricher://docs | Índice de las guías de flujo de trabajo, cada una disponible en su URI de recurso indicado. |
| enricher://schemas/{schema_id} | Copia de trabajo de un esquema guardado en Markdown; use get_schema con version="published" para obtener el contrato vinculado activo. |
| enricher://records/{record_id} | Un registro de enriquecimiento anterior representado como Markdown: metadatos + salida estructurada + errores de validación. |
Cuando le pide a enrich_entity que use un classification model y la entity no coincide con el tipo del schema, la herramienta devuelve una respuesta sin error con detalles estructurados. Claude la lee, le muestra el razonamiento y (tras su confirmación) reintenta con force_after_classification_warning=true, lo que descarta el clasificador en el reintento.
{
"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 respuesta del MCP conserva los detalles de la clasificación para que su cliente pueda explicar la decisión antes de iniciar una nueva llamada.
La misma interactividad impulsa un segundo flujo: cuando generate_sample se ejecuta con documentos de origen, su planificador puede pausarse con preguntas de aclaración estructurales. Claude se las transmite y reanuda el trabajo con answer_job_question, ronda tras ronda, hasta que se genera la muestra.
La mayoría de los errores de herramienta devuelven un objeto estructurado con un campo error_code para que el cliente pueda distinguir entre fallos de cuota, clasificación, tiempo de espera y proveedor. Algunas respuestas antiguas solo incluyen un campo error o message; inspeccione tanto el resultado en sí como el estado del transporte.
| error_code | Cuándo |
|---|---|
| invalid_request | UUID con formato incorrecto, argumentos mutuamente excluyentes (schema_id + target_schema) o la validación del cuerpo de la solicitud falló. |
| prompt_limit_reached | Cuota de prompts diaria / semanal / mensual agotada (HTTP 402). El cuerpo incluye período, límite, usado y necesario. |
| insufficient_credits | La organización tiene la facturación habilitada, pero el saldo de créditos es demasiado bajo para iniciar el trabajo (HTTP 402). El cuerpo incluye el saldo y una URL de compra. |
| model_limit_exceeded | Se solicitaron más modelos de los que permite el plan (HTTP 402). Devuelve el límite y lo solicitado. |
| language_limit_exceeded | Se solicitaron más idiomas de los que permite el plan (HTTP 402). |
| concurrent_job_limit_reached | Demasiados trabajos de enriquecimiento activos para esta organización. Espere o mejore el plan. |
| classification_warning | ⚡ No es un error: el clasificador previo rechazó la entidad. La respuesta incluye el contexto de la clasificación para que Claude pueda pedir al usuario que confirme y reintente con force_after_classification_warning=true. |
| benchmarks_not_in_plan | El plan de la organización no incluye Model Benchmarks (HTTP 403). Las herramientas de benchmark que modifican datos también comprueban el rol de propietario. |
| ambiguity_check_disabled | Se llamó a analyze_schema en un esquema cuya comprobación de ambigüedad está desactivada (HTTP 400). Vuelva a activarla primero mediante update_schema con ambiguity_check_enabled=true. |
| enrichment_timeout | El trabajo superó timeout_seconds. Se sugiere usar menos modelos o dividir la entidad. |
| schema_generation_timeout | La generación de esquemas superó timeout_seconds. |
| schema_generation_failed | Error del LLM upstream durante la generación del schema (HTTP 502). |
| model_output_invalid | El modelo devolvió una salida que no coincide con el esquema (HTTP 502). El cuerpo indica el modelo, la ruta de la propiedad conflictiva y retryable: true — vuelva a llamar a la herramienta o elija un modelo más potente. |
| cancelled | El trabajo se canceló durante su ejecución (HTTP 499). |
| not_found | El ID de esquema o registro no existe en su organización. |
| http_error | Comodín para errores HTTP sin un cuerpo de detalle estructurado. |
get_stats cubre los resúmenes del lado del chat; los paneles completos permanecen en la aplicación.