Codex, Cursor, VS Code с GitHub Copilot, Claude Code и Claude подключаются к одному и тому же MCP-серверу Entity Enricher. Их агенты могут проектировать схемы, обогащать сущности на нескольких языках, объединять модели, курировать семантические идентификаторы, замерять качество бенчмарками, синхронизировать реляционные таблицы с базой данных — на моделях платформы или на собственной модели клиента, если задача делегирует свои LLM-вызовы, — и обращаться к ассистенту поддержки продукта, когда вопрос касается самого Entity Enricher.
Валидация схемы и согласованность между моделями не гарантируют фактическую точность или актуальность данных. Проверяйте источники, ошибки и частичные результаты в базе данных. MCP обеспечивает доступ в диалоговом режиме; n8n и Make автоматизируют рабочие процессы поверх того же сервиса.
По умолчанию каждый инструмент запуска выполняет своё задание на вашей собственной модели (use_platform_models=true или указание модели платформы переводит его на платные модели платформы). Задание не делает ни одного вызова модели платформы и не расходует кредиты: модель вашего MCP-клиента — та, в которой уже находятся ваш диалог, ваши документы и ваши подключённые инструменты — отвечает на каждый вызов модели в задании, а платформа делает то, что умеет лучше всего: формирует промпты, применяет схему вывода, проверяет и нормализует каждый ответ, сохраняет записи и синхронизирует базы данных.
enable_web_search там, где инструмент его принимает: если он опущен, возвращается web_search_undecided, чтобы вы сначала спросили пользователя, ведь поиск будет выполняться от вашего имени. Задание приостанавливается, как только готов его первый вызов модели.llm_requests в статусе задачи: каждая запись — это один вызов модели в формате MCP sampling/createMessage (системный промпт, сообщения, tools и toolChoice) с полем purpose, указывающим шаг, и крайним сроком. Бинарные вложения передаются как ссылки на ресурсыenricher://attachments/{id} и никогда не встраиваются; извлечённый текст уже содержится в сообщениях. Клиент, загрузивший файл, читает собственную копию, поэтому вложение никогда не требует модели платформы.answer_llm_request. Платформа проверяет его по схеме точно так же, как ответ провайдера; отклонённый ответ возвращается тем же диалогом с ошибкой в неудачном результате инструмента — исправьте его и ответьте снова.Подробности протокола и особые случаи — отказ от режима, решение о веб-поиске, параллельные запросы, запросы на исправление при обогащении, вложения, таймауты — описаны в руководстве Делегированные вызовы LLM ниже.
OAuth позволяет клиенту подключиться без API-ключа. На экране согласия Entity Enricher указаны клиент, организация и роль, предоставляемая подключению. Управлять доступом или отзывать его можно в разделе API-ключи → Подключённые приложения.
В этих примерах используется вход через браузер (OAuth) и один и тот же эндпоинт Streamable HTTP: https://entityenricher.ai/api/mcp/, включая завершающий слеш. У каждого клиента свой формат конфигурации.
Codex использует общие настройки MCP для приложения, CLI и расширения IDE через ~/.codex/config.toml. Первая команда регистрирует Entity Enricher; команда входа открывает авторизацию в браузере, когда требуется аутентификация.
codex mcp add entity-enricher --url https://entityenricher.ai/api/mcp/
codex mcp login entity-enricherCursor читает серверы проекта из .cursor/mcp.json или личные серверы из ~/.cursor/mcp.json. Запись удалённого сервера указывается в mcpServers; вход через OAuth Cursor обрабатывает сам.
{
"mcpServers": {
"entity-enricher": {
"url": "https://entityenricher.ai/api/mcp/"
}
}
}VS Code использует .vscode/mcp.json с объектом servers и явно указанным транспортом http. После запуска сервера и авторизации его инструменты становятся доступны агенту GitHub Copilot.
{
"servers": {
"entity-enricher": {
"type": "http",
"url": "https://entityenricher.ai/api/mcp/"
}
}
}Эта команда регистрирует удалённый HTTP-сервер в Claude Code. Команда /mcp внутри Claude Code открывает элементы управления подключением и аутентификацией.
claude mcp add --transport http entity-enricher https://entityenricher.ai/api/mcp/На claude.ai и в Claude Desktop в настройках коннекторов доступно действие «Add custom connector». Коннектор принимает указанный выше URL сервера и открывает экран авторизации Entity Enricher. Это размещённое подключение настраивается через коннекторы; файл claude_desktop_config.json предназначен для локальных серверов.
Ключи доступа организации создаются в разделе Настройки → API-ключи с выбранной ролью. Клиенты могут передавать ключ в заголовке X-API-Key вместо входа через OAuth. Например, эта конфигурация Codex читает ключ из переменной окружения:
[mcp_servers.entity-enricher]
url = "https://entityenricher.ai/api/mcp/"
env_http_headers = { "X-API-Key" = "ENTITY_ENRICHER_API_KEY" }Переменная ENTITY_ENRICHER_API_KEY должна содержать ключ в окружении процесса, запускающего Codex. Cursor и VS Code принимают этот HTTP-заголовок в своём объекте конфигурации headers. Указанная выше документация клиентов описывает поддерживаемые ими настройки.
Один и тот же запрос работает во всех клиентах: «Покажи мои схемы Entity Enricher, затем обогати Sanofi по моей схеме фармацевтической компании и покажи сохранённый результат.»Клиент обнаруживает инструменты и использует их, чтобы выбрать схему и выполнить обогащение. Запросы подтверждения, отображение прогресса и доступ к ресурсам зависят от клиента.
62 инструментов охватывают создание схем, обогащение, бенчмарки, Database Sync, семантические идентификаторы и поддержку продукта. Они переиспользуют backend-сервисы для валидации, биллинга и обработки. Каждый инструмент предоставляет собственный набор поддерживаемых параметров. Длительные операции (пакетное обогащение, генерация примеров, запуски бенчмарков) выполняются асинхронно: инструмент запуска возвращает 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. |
| Схемы | publish_schema | Опубликовать рабочую копию схемы, связанной с базой данных, как контракт, используемый обогащением и репликами. |
| Схемы | delete_schema | Мягко удалите сохранённую схему по UUID. |
| Схемы | analyze_sample | Анализ неоднозначности свойств образца и границ идентичности связей перед генерацией схемы. |
| Схемы | analyze_schema | Анализ неоднозначности свойств сохранённой схемы и границ идентичности связей с записью аннотаций в схему. |
| Обогащение и слияние | start_batch_enrichment | Запускает платное асинхронное обогащение списка сущностей ровно по одному из параметров: schema_id или target_schema. |
| Обогащение и слияние | enrich_entity | Обогащение одной сущности ровно по одному из параметров schema_id или target_schema с возвратом структурированного результата, record_id, затрат и результата записи в базу данных. |
| Обогащение и слияние | retry_expertises | Повторить только неудавшиеся области экспертизы существующей записи, затем обновить её результат и выполнить слияние/синхронизацию запуска. |
| Обогащение и слияние | merge_records | Слияние двух или более записей одной сущности в новую запись арбитража. |
| Управление задачами | get_job_status | Получить статус, прогресс и краткую итоговую сводку задачи с ID сохранённых записей. |
| Управление задачами | cancel_job | Запросить отмену ожидающей, выполняющейся или приостановленной LLM-задачи. |
| Управление задачами | answer_job_question | Возобновить приостановленную задачу, ответив на вопросы, возвращённые при паузе. |
| Управление задачами | answer_llm_request | Отправить результат одного ожидающего вызова модели делегированной задачи: задачи, которую пользователь запустил на собственной модели клиента (по умолчанию для всех инструментов запуска, если не задано use_platform_models=true или… |
| Записи и статистика | 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 | Сохраняет эталонный ответ для бенчмарка обогащения или генерации схемы. |
| Бенчмарки | revert_benchmark_reference_updates | Отменить автоматические правки, внесённые проходом оценивания в эталон сценария. |
| Бенчмарки | 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 | get_database_setup_instructions | Возвращает не содержащие секретов инструкции по установке, подтверждённому в браузере сопряжению и запуску клиента ee-database sync. |
| 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 | Просмотр или миграция пространства эмбеддингов концептов организации. |
| Поддержка продукта | ask_support | Задайте вопрос Rupert, ассистенту поддержки продукта Entity Enricher, о самом приложении: как работает функция, инструмент или настройка, что означает error_code, лимит, статус… |
| Поддержка продукта | get_support_conversation | Прочитайте одно из ваших обращений в поддержку со всеми сообщениями: ваши вопросы (role user), ответы Rupert (assistant) и сообщения команды поддержки (admin, с author_name). |
| Поддержка продукта | list_support_conversations | Ваши обращения в поддержку, сначала с самой недавней активностью, с полями message_count и unread_for_user (непрочитанный вами ответ команды поддержки). |
Инструкции сервера описывают доступные рабочие процессы, а описания инструментов — отдельные вызовы. Для решений по моделированию или восстановления ваш клиент может открыть указатель руководств по адресу enricher://docs и выбрать руководство через ресурсы MCP. Чтение руководства не запускает модель. Ссылки ниже открывают те же руководства на английском языке в публичном репозитории.
По умолчанию каждое запускаемое вами задание выполняется на вашей собственной модели: отвечайте на каждый её вызов модели через `answer_llm_request`, а платформа проверит каждый ответ на соответствие схеме. `use_platform_models=true` вместо этого запускает задание на платформе — на лучшей по бенчмарку модели организации для этой задачи.
Спроектируйте переиспользуемую схему на основе проверенных примеров, включая идентичность, связи и многоязычные поля.
Читайте, создавайте и редактируйте документы схем Entity Enricher, не путая сериализованную JSON Schema, примеры данных и пути инструментов свойств.
Выберите извлечение, обогащение знаниями или комбинацию из двух проходов и сохраняйте происхождение вложений между вызовами.
Обогащайте сущность, интерпретируйте её фактический результат и восстанавливайте частичные сбои моделей, не повторяя успешно выполненную работу.
Асинхронно обогащайте список сущностей и различайте пропущенные, неудачные, слитые и принятые в базу данных результаты.
Сравнивайте модели по обогащению, генерации образцов или генерации схем, используя корректный эталон и интерпретацию оценок.
Превращайте схемы обогащения в реляционные таблицы в вашей собственной базе данных и отдельно проверяйте приём данных, миграцию и доставку в реплику.
Распознавайте повторяющиеся сущности в различных формах записи, проверяйте неоднозначные совпадения и понимайте, как изменения словаря влияют на реплики.
Задайте Rupert, ассистенту поддержки продукта, любой вопрос о самом Entity Enricher, продолжите начатое обращение и читайте ответы команды поддержки.
Ресурсы предоставляют данные схем и записей, а также руководства по рабочим процессам в формате Markdown. Клиенты сами решают, как их находить и загружать; содержимое ресурсов всё равно расходует контекст модели.
| Шаблон URI | Описание |
|---|---|
| enricher://docs | Указатель руководств по рабочим процессам; каждое доступно по указанному URI ресурса. |
| enricher://schemas/{schema_id} | Рабочая копия сохранённой схемы в формате Markdown; для активного связанного контракта используйте get_schema с version="published". |
| enricher://records/{record_id} | Прошлая запись обогащения, отображённая в формате Markdown — метаданные + структурированный вывод + ошибки валидации. |
| enricher://attachments/{attachment_id} | Байты загруженного вложения, отдаваемые с их реальным медиатипом, — так задача, делегирующая свои вызовы LLM, передаёт вашему клиенту PDF, изображение или аудиофайл, который он сам не загружал. |
Когда вопрос касается самого Entity Enricher — как работает функция или инструмент, что означает код ошибки, лимит или предупреждение, почему результат выглядит именно так — и в руководствах ответа нет, инструкции сервера предписывают агенту спросить Rupert, ассистента поддержки продукта, через ask_support, а не угадывать. Вызов возвращает полный ответ и id открытого обсуждения; передача этогоconversation_id в следующий вопрос сохраняет контекст переписки.
Каждый вопрос расходует дневную квоту поддержки организации, которая возвращается вquestions_remaining. Команда поддержки может ответить в обсуждении: следующий вызов ask_support в нём вернёт эти ответы вnew_admin_messages, аget_support_conversation читает обсуждение целиком. Те же обсуждения отображаются в чате поддержки веб-приложения и, для владельцев, на странице «Пользователи» во вкладке «Обсуждения» — с отметкой о том, что они открыты AI-агентом.
Когда вы просите enrich_entity использовать модель классификации, а сущность не соответствует типу схемы, инструмент возвращает ответ, не являющийся ошибкой, со структурированными подробностями. Клиент читает его, показывает вам обоснование и (после вашего подтверждения) повторяет запрос с 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 запускается с исходными документами, его планировщик может приостановиться и задать уточняющие вопросы о структуре. Клиент передаёт их вам и возобновляет задачу через 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 | ⚡ Не ошибка: предварительный классификатор отклонил сущность. Ответ содержит контекст классификации, чтобы клиент мог запросить подтверждение у пользователя и повторить запрос с force_after_classification_warning=true. |
| benchmarks_not_in_plan | Тарифный план организации не включает бенчмарки моделей (HTTP 403). Инструменты бенчмарков, изменяющие данные, дополнительно проверяют роль владельца. |
| support_question_limit_reached | Дневная квота организации на вопросы в поддержку исчерпана (HTTP 402). В теле ответа есть limit и used; каждый результат ask_support сообщает questions_remaining. |
| support_requires_user | ask_support был вызван с ключом доступа организации (HTTP 403). Обсуждение с поддержкой принадлежит конкретному человеку: войдите через OAuth или используйте личный API-ключ. |
| support_unavailable | Ассистент поддержки не смог ответить (сбой передачи). Вопрос всё равно учитывается, и обсуждение создано: прочитайте его позже через get_support_conversation, а не задавайте вопрос заново сразу же. |
| web_search_undecided | Инструмент запуска был вызван без enable_web_search для задания, выполняемого на вашей модели. Спросите пользователя, может ли ваша модель использовать веб-поиск, затем вызовите инструмент снова с enable_web_search=true или false. |
| delegation_requires_auto | Задание, выполняемое на вашей модели, столкнулось с явно указанной моделью платформы, добавленной после запуска, например с моделью по умолчанию организации (HTTP 400). Запустите задание с use_platform_models=true или удалите эту модель по умолчанию. |
| request_not_pending | answer_llm_request указывает на запрос, на который уже ответили, который истёк или относится к заданию, продвинувшемуся дальше. Актуальные ожидающие запросы смотрите в get_job_status(job_id).llm_requests. |
| llm_request_pending | answer_job_question вызван для задания, приостановленного на делегированных запросах LLM, а не на вопросе. Отвечайте на них через answer_llm_request. |
| llm_request_timeout | Задание, делегирующее вызовы LLM, не получило ответ на ожидающий запрос в течение 15 минут; задание завершилось с ошибкой. Для делегированных заданий ответа по умолчанию нет. |
| 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 предоставляет сводки на стороне чата; полные дашборды остаются в приложении.