Используйте Entity Enricher из MCP-совместимого клиента, чтобы превращать знания моделей и документы в структурированные данные. Проектируйте схемы, обогащайте сущности на разных языках, выполняйте слияние моделей, курируйте семантические идентификаторы, оценивайте качество с помощью бенчмарков и синхронизируйте реляционные таблицы с вашей собственной базой данных.
Валидация схемы и согласованность между моделями не гарантируют фактическую точность или актуальность данных. Проверяйте источники, ошибки и частичные результаты в базе данных. MCP обеспечивает доступ в диалоговом режиме; n8n и Make автоматизируют рабочие процессы поверх того же сервиса.
Для claude.ai, Claude Code, Cursor и любого MCP-клиента, поддерживающего стандартный процесс OAuth. Не нужно создавать или вставлять API-ключ — клиент обнаруживает сервер авторизации автоматически.
https://entityenricher.ai/api/mcp/.Для клиентов, настраиваемых через JSON-файл, а не через интерактивный вход (Claude Desktop, Continue, Zed).
ent_… — оно показывается только один раз.Для Claude Desktop отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"entityenricher": {
"url": "https://entityenricher.ai/api/mcp/",
"headers": { "X-API-Key": "ent_your_key_here" }
}
}
}Укажите приведённые выше эндпоинт и заголовок в настройках удалённого MCP вашего клиента. Синтаксис настройки и поддержка транспорта HTTP зависят от клиента.
В новом чате: «Покажи мои схемы Entity Enricher, затем обогати Sanofi по схеме фармацевтической компании с помощью Claude Sonnet.»Клиент может обнаружить инструменты и использовать их, чтобы выбрать схему и запустить обогащение. Запросы подтверждения, отображение прогресса и доступ к ресурсам зависят от клиента.
58 инструментов охватывают создание схем, обогащение, бенчмарки, синхронизацию базы данных и семантические идентификаторы. Они используют серверные сервисы для валидации, тарификации и обработки. Каждый инструмент предоставляет собственный набор поддерживаемых параметров. Длительные операции (пакетное обогащение, генерация образцов, запуск бенчмарков) выполняются асинхронно: инструмент запуска возвращает job_id, клиент опрашивает get_job_statusи считывает полученные записи или результаты бенчмарков. Изучайте ошибки и частичные результаты, прежде чем сообщать об успехе.
| Категория | Инструмент | Описание |
|---|---|---|
| Обнаружение | list_models | Список доступных ключей моделей, номинальных возможностей, языков, стратегий, автоматически выбранных значений по умолчанию и profile_limits организации. |
| Схемы | generate_sample | Генерация редактируемого образца JSON из произвольного текстового запроса для создания схемы. |
| Схемы | list_schemas | Список сохранённых схем вашей организации, закреплённые — первыми. |
| Схемы | get_schema | Получить сохранённую схему с её свойствами, аннотациями и input_contract. |
| Схемы | create_schema_from_sample | Генерация и автоматическое сохранение схемы на основе проверенных образцов с возвратом schema_id, содержимого схемы и ссылок на записи. |
| Схемы | save_schema | Сохраняет схему, созданную вручную, и возвращает её ID и ссылку. |
| Схемы | update_schema | Изменение метаданных сохранённой схемы или полная замена её schema_content без вызова LLM. |
| Схемы | get_schema_part | Получить только фрагмент схемы, необходимый для редактирования. |
| Схемы | get_enum_candidates | Список наблюдаемых значений, отсутствующих в текущем словаре каждого открытого перечисления, с количеством вхождений из недавних записей обогащения. |
| Схемы | update_schema_property | Изменение или удаление одного свойства по пути без замены всей схемы. |
| Схемы | add_schema_property | Добавьте свойство в корне (parent_path='), по пути объекта или в '$defs.X'. |
| Схемы | move_schema_property | Переместить свойство в корень, путь объекта или '$defs.X', сохранив его флаги и экспертизу. |
| Схемы | resolve_unify_proposal | Разрешить одно ожидающее предложение об унификации типов сущностей из get_schema. |
| Схемы | nest_schema_region | Вложите плоскую область сущности из x-entityMap в get_schema в подобъект того объекта, который содержит её поля: плоские члены области (например, product_id, product_name у заказа… |
| Схемы | publish_schema | Опубликовать рабочую копию схемы, связанной с базой данных, как контракт, используемый обогащением и репликами. |
| Схемы | delete_schema | Мягко удалите сохранённую схему по UUID. |
| Схемы | analyze_sample | Анализ неоднозначности свойств образца и границ идентичности связей перед генерацией схемы. |
| Схемы | analyze_schema | Анализ неоднозначности свойств сохранённой схемы и границ идентичности связей с записью аннотаций в схему. |
| Обогащение и слияние | start_batch_enrichment | Запускает платное асинхронное обогащение списка сущностей ровно по одному из параметров: schema_id или target_schema. |
| Обогащение и слияние | fetch_entities | Получение сущностей из внешнего REST API с помощью серверного GET-запроса. |
| Обогащение и слияние | enrich_entity | Обогащение одной сущности ровно по одному из параметров schema_id или target_schema с возвратом структурированного результата, record_id, затрат и результата записи в базу данных. |
| Обогащение и слияние | retry_expertises | Повторить только неудавшиеся области экспертизы существующей записи, затем обновить её результат и выполнить слияние/синхронизацию запуска. |
| Обогащение и слияние | merge_records | Слияние двух или более записей одной сущности в новую запись арбитража. |
| Управление задачами | get_job_status | Получить статус, прогресс и краткую итоговую сводку задачи с ID сохранённых записей. |
| Управление задачами | cancel_job | Запросить отмену ожидающей, выполняющейся или приостановленной LLM-задачи. |
| Управление задачами | answer_job_question | Возобновить приостановленную задачу, ответив на вопросы, возвращённые при паузе. |
| Записи и статистика | list_records | Список кратких записей вашей организации с постраничной разбивкой, начиная с самых новых. |
| Записи и статистика | get_record | Получить structured_output, entity_input_data, ошибки валидации, вердикты экспертизы и метрики одной сохранённой записи. |
| Записи и статистика | get_stats | Получить сводку по всей организации: количество записей, долю успешных, токены и стоимость. |
| Бенчмарки | list_benchmark_scenarios | Список кратких сводок по сценариям бенчмарка и их общее количество. |
| Бенчмарки | get_benchmark_scenario | Получить один сценарий бенчмарка с результатами по качеству, стоимости и скорости для каждой модели. |
| Бенчмарки | get_benchmark_scenario_results | Фильтрация, ранжирование и ограничение результатов бенчмарка сценария по моделям. |
| Бенчмарки | create_benchmark_scenario | Создание переиспользуемого бенчмарка с обязательным судьёй для оценки. |
| Бенчмарки | update_benchmark_scenario | Изменение тестового определения бенчмарка или настроек оценки. |
| Бенчмарки | set_benchmark_reference | Сохраняет эталонный ответ для бенчмарка обогащения или генерации схемы. |
| Бенчмарки | delete_benchmark_scenario | Удаление сценария бенчмарка и сохранённых результатов. |
| Бенчмарки | run_benchmark | Запускает платное асинхронное выполнение и оценку бенчмарка. |
| Вложения | upload_attachment | Загружает байты файла в base64 как переиспользуемый исходный материал; возвращает id и requires_capability. |
| Вложения | delete_attachment | Безвозвратно удалить вложение в вашей организации вместе с сохранённым файлом. |
| Database Sync | list_database_syncs | Список регистраций баз данных, связанных схем, параметров и хостов синхронизации для сохранённой схемы. |
| Database Sync | list_entity_states | Просмотр текущих объединённых строк сущностей схемы, а не записей отдельных запусков. |
| Database Sync | create_database_sync | Зарегистрировать сохранённую схему для реляционной синхронизации с PostgreSQL, MySQL или SQLite. |
| Database Sync | assign_sync_host | Назначение или снятие хоста, обслуживающего синхронизацию базы данных. |
| Database Sync | classify_database_model | Запускает платный анализ, который предлагает ключи базы данных, типы SQL, индексы и владение связями для привязанной схемы. |
| Database Sync | delete_database_sync | Удаление регистрации базы данных и её дельт в очереди с остановкой потока данных. |
| Database Sync | create_database_credential | Выдать одноразовые учётные данные клиента синхронизации и подсказки команд установки, сопряжения и запуска. |
| Database Sync | fetch_database_deltas | Получить следующее упорядоченное окно SQL-дельт и канонических данных для синхронизации базы данных. |
| Database Sync | ack_database_deltas | Подтверждайте каждую дельту через up_to_id после успешного применения, освобождая её аренду. |
| Database Sync | sync_records_to_database | Проверяет и загружает сохранённый или переданный результат обогащения в слой сущностей и связанные синхронизации. |
| Семантические ID | list_semantic_concepts | Просмотр концептов организации с псевдонимами, счётчиками использования и фасетами по типу/модели. |
| Семантические ID | get_semantic_concept | Получить алиасы концепта, ключи источников идентичности, связанные записи и ближайших соседей в пределах его среза типа/модели. |
| Семантические ID | probe_semantic_concept | Предварительный просмотр разрешения идентичности без добавления концепта и увеличения его использования. |
| Семантические ID | add_semantic_concept | Добавьте концепт идентичности с нулевым использованием или добавьте текст как псевдоним через alias_of. |
| Семантические ID | update_concept_alias | Удалить или повысить алиас концепта, используя ID алиасов из get_semantic_concept. |
| Семантические ID | import_semantic_concepts | Сопоставить от 1 до 1000 текстов с одним типом концепта. |
| Семантические ID | merge_semantic_concepts | Объединить проигравший концепт с победившим. |
| Семантические ID | delete_semantic_concepts | Удаление концептов, выбранных по ids, concept_types или unused_only. |
| Семантические ID | migrate_semantic_embeddings | Просмотр или миграция пространства эмбеддингов концептов организации. |
Инструкции сервера описывают доступные рабочие процессы, а описания инструментов — отдельные вызовы. Для решений по моделированию или восстановления ваш клиент может открыть указатель руководств по адресу enricher://docs и выбрать руководство через ресурсы MCP. Чтение руководства не запускает модель. Ссылки ниже открывают те же руководства на английском языке в публичном репозитории.
Спроектируйте переиспользуемую схему на основе проверенных примеров, включая идентичность, связи и многоязычные поля.
Читайте, создавайте и редактируйте документы схем Entity Enricher, не путая сериализованную JSON Schema, примеры данных и пути инструментов свойств.
Выберите извлечение, обогащение знаниями или комбинацию из двух проходов и сохраняйте происхождение вложений между вызовами.
Обогащайте сущность, интерпретируйте её фактический результат и восстанавливайте частичные сбои моделей, не повторяя успешно выполненную работу.
Асинхронно обогащайте список сущностей и различайте пропущенные, неудачные, слитые и принятые в базу данных результаты.
Сравнивайте модели по обогащению, генерации образцов или генерации схем, используя корректный эталон и интерпретацию оценок.
Превращайте схемы обогащения в реляционные таблицы в вашей собственной базе данных и отдельно проверяйте приём данных, миграцию и доставку в реплику.
Распознавайте повторяющиеся сущности в различных формах записи, проверяйте неоднозначные совпадения и понимайте, как изменения словаря влияют на реплики.
Ресурсы предоставляют данные схем и записей, а также руководства по рабочим процессам в формате Markdown. Клиенты сами решают, как их находить и загружать; содержимое ресурсов всё равно расходует контекст модели.
| Шаблон URI | Описание |
|---|---|
| enricher://docs | Указатель руководств по рабочим процессам; каждое доступно по указанному URI ресурса. |
| enricher://schemas/{schema_id} | Рабочая копия сохранённой схемы в формате Markdown; для активного связанного контракта используйте get_schema с version="published". |
| enricher://records/{record_id} | Прошлая запись обогащения, отображённая в формате Markdown — метаданные + структурированный вывод + ошибки валидации. |
Когда вы просите enrich_entity использовать модель классификации, а сущность не соответствует типу схемы, инструмент возвращает не-ошибочный ответ со структурированными деталями. Claude читает его, показывает вам обоснование и (после вашего подтверждения) повторяет попытку с force_after_classification_warning=true — что отключает классификатор при повторе.
{
"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": "..."
}Ответ MCP сохраняет детали классификации, чтобы ваш клиент мог объяснить решение до начала нового вызова.
Та же интерактивность обеспечивает второй сценарий: когда generate_sample запускается с исходными документами, его планировщик может приостановиться с уточняющими структурными вопросами. Claude передаёт их вам и возобновляет задачу с помощью answer_job_question — раунд за раундом, пока не будет сгенерирован образец.
Большинство ошибок инструментов возвращают структурированный объект с полем error_code, чтобы клиент мог различать сбои квоты, классификации, тайм-аута и провайдера. Некоторые старые ответы содержат только поле error или message; проверяйте как сам результат, так и статус транспорта.
| error_code | Когда |
|---|---|
| invalid_request | Некорректный UUID, взаимоисключающие аргументы (schema_id + target_schema) или ошибка валидации тела запроса. |
| prompt_limit_reached | Дневная / недельная / месячная квота на промпты исчерпана (HTTP 402). В теле ответа указаны период, лимит, использовано и требуется. |
| insufficient_credits | У организации включена оплата, но баланс кредитов слишком низкий для запуска задания (HTTP 402). Тело ответа содержит баланс и URL для покупки. |
| model_limit_exceeded | Запрошено больше моделей, чем позволяет план (HTTP 402). Возвращает лимит и запрошенное количество. |
| language_limit_exceeded | Запрошено больше языков, чем позволяет план (HTTP 402). |
| concurrent_job_limit_reached | Слишком много активных задач обогащения для этой организации. Подождите или обновите тарифный план. |
| classification_warning | ⚡ Не ошибка: предварительный классификатор отклонил сущность. Ответ содержит контекст классификации, чтобы Claude мог попросить пользователя подтвердить и повторить попытку с force_after_classification_warning=true. |
| benchmarks_not_in_plan | Тарифный план организации не включает бенчмарки моделей (HTTP 403). Инструменты бенчмарков, изменяющие данные, дополнительно проверяют роль владельца. |
| ambiguity_check_disabled | analyze_schema вызван для схемы с отключённой проверкой неоднозначности (HTTP 400). Сначала включите её через update_schema с ambiguity_check_enabled=true. |
| enrichment_timeout | Задание превысило timeout_seconds. Рекомендуется использовать меньше моделей или разделить сущность. |
| schema_generation_timeout | Генерация схемы превысила timeout_seconds. |
| schema_generation_failed | Ошибка вышестоящего LLM при генерации схемы (HTTP 502). |
| model_output_invalid | Модель вернула результат, не соответствующий схеме (HTTP 502). В теле ответа указаны модель, путь к проблемному свойству и retryable: true — вызовите инструмент повторно или выберите более мощную модель. |
| cancelled | Задание было отменено во время выполнения (HTTP 499). |
| not_found | Схема или идентификатор записи не существует в вашей организации. |
| http_error | Универсальный обработчик HTTP-ошибок без структурированного тела с деталями. |
get_stats предоставляет сводки на стороне чата; полные дашборды остаются в приложении.