MCP-сервер для Codex и других ИИ-клиентов

Codex, Cursor, VS Code с GitHub Copilot, Claude Code и Claude подключаются к одному и тому же MCP-серверу Entity Enricher. Их агенты могут проектировать схемы, обогащать сущности на нескольких языках, объединять модели, курировать семантические идентификаторы, замерять качество бенчмарками, синхронизировать реляционные таблицы с базой данных — на моделях платформы или на собственной модели клиента, если задача делегирует свои LLM-вызовы, — и обращаться к ассистенту поддержки продукта, когда вопрос касается самого Entity Enricher.

Валидация схемы и согласованность между моделями не гарантируют фактическую точность или актуальность данных. Проверяйте источники, ошибки и частичные результаты в базе данных. MCP обеспечивает доступ в диалоговом режиме; n8n и Make автоматизируют рабочие процессы поверх того же сервиса.

Выполняйте задания на модели вашего клиента

По умолчанию каждый инструмент запуска выполняет своё задание на вашей собственной модели (use_platform_models=true или указание модели платформы переводит его на платные модели платформы). Задание не делает ни одного вызова модели платформы и не расходует кредиты: модель вашего MCP-клиента — та, в которой уже находятся ваш диалог, ваши документы и ваши подключённые инструменты — отвечает на каждый вызов модели в задании, а платформа делает то, что умеет лучше всего: формирует промпты, применяет схему вывода, проверяет и нормализует каждый ответ, сохраняет записи и синхронизирует базы данных.

  1. Запустите задание без явного указания модели (параметр опущен или auto), определивenable_web_search там, где инструмент его принимает: если он опущен, возвращается web_search_undecided, чтобы вы сначала спросили пользователя, ведь поиск будет выполняться от вашего имени. Задание приостанавливается, как только готов его первый вызов модели.
  2. Читайте llm_requests в статусе задачи: каждая запись — это один вызов модели в формате MCP sampling/createMessage (системный промпт, сообщения, tools и toolChoice) с полем purpose, указывающим шаг, и крайним сроком. Бинарные вложения передаются как ссылки на ресурсыenricher://attachments/{id} и никогда не встраиваются; извлечённый текст уже содержится в сообщениях. Клиент, загрузивший файл, читает собственную копию, поэтому вложение никогда не требует модели платформы.
  3. Выполните запрос на своей модели и верните результат черезanswer_llm_request. Платформа проверяет его по схеме точно так же, как ответ провайдера; отклонённый ответ возвращается тем же диалогом с ошибкой в неудачном результате инструмента — исправьте его и ответьте снова.
  4. Повторяйте, пока задание не завершится. Записи помечаются ключом модели mcp::client с нулевой стоимостью; запрос без ответа приводит к сбою задания через пятнадцать минут.

Подробности протокола и особые случаи — отказ от режима, решение о веб-поиске, параллельные запросы, запросы на исправление при обогащении, вложения, таймауты — описаны в руководстве Делегированные вызовы LLM ниже.

Быстрый старт

Вход через OAuth

OAuth позволяет клиенту подключиться без API-ключа. На экране согласия Entity Enricher указаны клиент, организация и роль, предоставляемая подключению. Управлять доступом или отзывать его можно в разделе API-ключи → Подключённые приложения.

В этих примерах используется вход через браузер (OAuth) и один и тот же эндпоинт Streamable HTTP: https://entityenricher.ai/api/mcp/, включая завершающий слеш. У каждого клиента свой формат конфигурации.

Codex

Codex использует общие настройки MCP для приложения, CLI и расширения IDE через ~/.codex/config.toml. Первая команда регистрирует Entity Enricher; команда входа открывает авторизацию в браузере, когда требуется аутентификация.

Codex CLI
codex mcp add entity-enricher --url https://entityenricher.ai/api/mcp/
codex mcp login entity-enricher
Документация Codex

Cursor

Cursor читает серверы проекта из .cursor/mcp.json или личные серверы из ~/.cursor/mcp.json. Запись удалённого сервера указывается в mcpServers; вход через OAuth Cursor обрабатывает сам.

.cursor/mcp.json
{
  "mcpServers": {
    "entity-enricher": {
      "url": "https://entityenricher.ai/api/mcp/"
    }
  }
}
Документация Cursor

VS Code / GitHub Copilot

VS Code использует .vscode/mcp.json с объектом servers и явно указанным транспортом http. После запуска сервера и авторизации его инструменты становятся доступны агенту GitHub Copilot.

.vscode/mcp.json
{
  "servers": {
    "entity-enricher": {
      "type": "http",
      "url": "https://entityenricher.ai/api/mcp/"
    }
  }
}
Документация VS Code / GitHub Copilot

Claude Code

Эта команда регистрирует удалённый HTTP-сервер в Claude Code. Команда /mcp внутри Claude Code открывает элементы управления подключением и аутентификацией.

Claude Code CLI
claude mcp add --transport http entity-enricher https://entityenricher.ai/api/mcp/
Документация Claude Code

Claude / Claude Desktop

На claude.ai и в Claude Desktop в настройках коннекторов доступно действие «Add custom connector». Коннектор принимает указанный выше URL сервера и открывает экран авторизации Entity Enricher. Это размещённое подключение настраивается через коннекторы; файл claude_desktop_config.json предназначен для локальных серверов.

Документация по коннектору Claude
  1. 1Организация, к которой привязано разрешение
  2. 2Подключение действует с вашей собственной ролью и никогда с более широкой
  3. 3Можно отозвать в любой момент в разделе «Подключённые приложения»
На экране согласия указаны запрашивающий клиент, организация и роль, предоставляемая подключению.

Аутентификация по API-ключу

Ключи доступа организации создаются в разделе Настройки → API-ключи с выбранной ролью. Клиенты могут передавать ключ в заголовке X-API-Key вместо входа через OAuth. Например, эта конфигурация Codex читает ключ из переменной окружения:

~/.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 должна содержать ключ в окружении процесса, запускающего 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 Synclist_database_syncsСписок регистраций баз данных, связанных схем, параметров и хостов синхронизации для сохранённой схемы.
Database Synclist_entity_statesПросмотр текущих объединённых строк сущностей схемы, а не записей отдельных запусков.
Database Synccreate_database_syncЗарегистрировать сохранённую схему для реляционной синхронизации с PostgreSQL, MySQL или SQLite.
Database Syncassign_sync_hostНазначение или снятие хоста, обслуживающего синхронизацию базы данных.
Database Syncclassify_database_modelЗапускает платный анализ, который предлагает ключи базы данных, типы SQL, индексы и владение связями для привязанной схемы.
Database Syncdelete_database_syncУдаление регистрации базы данных и её дельт в очереди с остановкой потока данных.
Database Syncget_database_setup_instructionsВозвращает не содержащие секретов инструкции по установке, подтверждённому в браузере сопряжению и запуску клиента ee-database sync.
Database Syncfetch_database_deltasПолучить следующее упорядоченное окно SQL-дельт и канонических данных для синхронизации базы данных.
Database Syncack_database_deltasПодтверждайте каждую дельту через up_to_id после успешного применения, освобождая её аренду.
Database Syncsync_records_to_databaseПроверяет и загружает сохранённый или переданный результат обогащения в слой сущностей и связанные синхронизации.
Семантические IDlist_semantic_conceptsПросмотр концептов организации с псевдонимами, счётчиками использования и фасетами по типу/модели.
Семантические IDget_semantic_conceptПолучить алиасы концепта, ключи источников идентичности, связанные записи и ближайших соседей в пределах его среза типа/модели.
Семантические IDprobe_semantic_conceptПредварительный просмотр разрешения идентичности без добавления концепта и увеличения его использования.
Семантические IDadd_semantic_conceptДобавьте концепт идентичности с нулевым использованием или добавьте текст как псевдоним через alias_of.
Семантические IDupdate_concept_aliasУдалить или повысить алиас концепта, используя ID алиасов из get_semantic_concept.
Семантические IDimport_semantic_conceptsСопоставить от 1 до 1000 текстов с одним типом концепта.
Семантические IDmerge_semantic_conceptsОбъединить проигравший концепт с победившим.
Семантические IDdelete_semantic_conceptsУдаление концептов, выбранных по ids, concept_types или unused_only.
Семантические IDmigrate_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. Чтение руководства не запускает модель. Ссылки ниже открывают те же руководства на английском языке в публичном репозитории.

Ресурсы

Ресурсы предоставляют данные схем и записей, а также руководства по рабочим процессам в формате 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_userask_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_pendinganswer_llm_request указывает на запрос, на который уже ответили, который истёк или относится к заданию, продвинувшемуся дальше. Актуальные ожидающие запросы смотрите в get_job_status(job_id).llm_requests.
llm_request_pendinganswer_job_question вызван для задания, приостановленного на делегированных запросах LLM, а не на вопросе. Отвечайте на них через answer_llm_request.
llm_request_timeoutЗадание, делегирующее вызовы LLM, не получило ответ на ожидающий запрос в течение 15 минут; задание завершилось с ошибкой. Для делегированных заданий ответа по умолчанию нет.
ambiguity_check_disabledanalyze_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-ошибок без структурированного тела с деталями.

Намеренные пропуски

См. также