Dev Crabs

Разработка MCP-серверов для ваших систем

AI-помощнику нужен статус заказа или остаток на складе? Разработаем MCP-сервер над существующим API: он предоставит согласованные инструменты и проверит права перед обращением к системе. Начнём с одного клиента и сценария чтения.

  • Один API и выбранный AI-клиент
  • Чтение и запись — отдельно
  • Права проверяются на сервере

Учебный сценарий

Одна операция — разные права

В каталоге запчастей наблюдатель может проверить остаток, а закупщик — ещё и подготовить черновик заявки. Смените роль и выполните обе операции: журнал покажет разрешение или отказ.

ДемонстрацияКаталог запчастей · учебный стенд

Вымышленная деталь · DEMO-42

Проверьте границу доступа

Наблюдатель: только чтение. Закупщик: чтение и черновик. Попробуйте создать черновик от каждой роли.

Роль сотрудника

Журнал последних действий

Выберите операцию — её результат появится здесь.
Демонстрация на вымышленных данных. Ответы заранее заданы в браузере. MCP-сервер, CRM и модель не подключены; реальные заявки не создаются. Проверка роли здесь иллюстративная: в рабочей системе её выполняет сервер. Обновление страницы сбрасывает журнал.
  • Смежный опыт

    Academia Suites

    Команда проектировала и разрабатывала портал инвестора, объединяющий данные об объектах, доходности, мероприятиях и документах. Работа включала интеграцию данных по объектам. Это опыт интерфейсов и интеграций, а не публичный кейс MCP.

  • Результат первого этапа

    Контракт одного инструмента

    Зафиксируем источник данных, входные поля, ответ, разрешённые роли и поведение при отказе. Учебный пример выше не доказывает прохождение испытаний реального сервера.

Когда это нужно

Когда нужен свой MCP-сервер

MCP — протокол взаимодействия AI-приложения с внешними инструментами и данными. Сервер связывает согласованные операции с API вашей системы. Он не заменяет саму систему, модель или правила доступа.

  1. Узнать статус заказа

    Сотрудник обращается к помощнику, а тот получает статус по номеру заказа. Ответ ограничиваем полями и заказами, доступными этому сотруднику.

  2. Получить справочную информацию

    Найти артикул, остаток или карточку оборудования в существующем сервисе. Определяем источник, допустимую давность данных и ответ при недоступности API.

  3. Подготовить действие к проверке

    Сформировать черновик заявки по заданной схеме. Создание черновика и окончательная отправка — разные операции с отдельными правами и подтверждением.

Когда можно обойтись без разработки

  • Готовый сервер уже покрывает нужные операции, права и требования к данным — сначала проверим его.
  • Нужен регулярный обмен между двумя системами без AI-клиента — подойдёт обычная API-интеграция.
  • У системы нет доступного интерфейса: сначала исследуем способ интеграции. MCP сам по себе доступ к данным не создаёт.

Границы результата

Инструкция, обмен и инструмент — разные задачи

Выбор начинается с действия сотрудника. MCP нужен там, где совместимый AI-клиент должен вызвать конкретную операцию вашей системы.

  • API-интеграция

    Передаёт данные между системами по событию или расписанию. Полезна для заказов, статусов и документов без участия AI-помощника.

  • Agent Skills

    Описывают процедуру: что учесть, в каком порядке работать и как проверить результат. Инструкция сама не выдаёт права и не заменяет подключение к системе.

  • MCP-сервер

    Предоставляет инструменты выбранному клиенту. Решение о доступе и допустимых параметрах остаётся в серверной логике и корпоративной системе.

Можно сочетать эти подходы. Мы не предлагаем общий доступ AI к базе данных или произвольный SQL вместо ограниченных операций.

Как работаем

Пилот с проверяемым результатом

Фиксируем один клиент и его версию, одну систему, роли и набор операций. Новые клиенты и запись в систему расширяют объём работ отдельно.

  1. 01 · Обследование

    Проверяем API и доступы

    Изучаем документацию, ограничения, способ авторизации и тестовую среду. Выбираем сценарий чтения и поля, которые допустимо передавать модели.

  2. 02 · Контракт

    Описываем инструмент

    Согласуем входную схему, формат ответа, права, таймауты и ошибки. Определяем, какие действия требуют подтверждения сотрудника.

  3. 03 · Реализация

    Собираем и подключаем

    Реализуем сервер, проверку полномочий и журнал. Подключаем выбранный клиент в согласованной среде, документируем настройки и ограничения.

  4. 04 · Приёмка

    Проверяем отказы и повторы

    Проверяем схему, разрешённое чтение, отказ чужой роли и отозванного токена. Для записи — повтор без дубля; для клиента — выполнение согласованного сценария. Передаём протокол проверок.

Как это устроено

Что входит в интеграцию

  • Согласованные инструменты

    Названия, описания, входные и выходные схемы, обязательные поля и ограничения. Вместо универсального запроса к базе — конкретные операции: прочитать остаток или подготовить черновик.

  • Серверная авторизация

    Проверка пользователя, роли и доступа к конкретному объекту при вызове. Разделение прав чтения и записи, работа с отзывом доступа. Способ авторизации выбираем с учётом транспорта и клиента.

  • Ошибки и журнал

    Ограничение времени ожидания, понятный ответ при сбое, правила повторов. В журнале — кто вызвал инструмент и чем завершился запрос; секреты и лишние данные в него не включаем.

  • Размещение и сопровождение

    Согласуем среду, хранение секретов, обновления и ответственного за эксплуатацию. Внутренний сервер сам по себе не делает внешний AI-клиент локальным.

    Локальный AI-контур →

Отличие

Готовый сервер или разработка на заказ

Сначала проверяем существующее решение на вашем сценарии. Собственная разработка оправдана, когда нужный контракт или ограничения в нём не поддерживаются.

Готовый MCP-серверРазработка под систему
ОперацииЕсть подходящие инструменты и поля ответа.Нужны отдельные операции над вашим API или сокращённый набор полей.
ПраваПоддерживает ваши роли и ограничения доступа к объектам.Нужно связать корпоративные права с каждым вызовом инструмента.
СовместимостьПроверяем нужного клиента и способ подключения.Фиксируем клиент, версию и испытания в составе пилота.
ЭксплуатацияПринимаете условия поставщика, обновления и размещение.Нужны собственная среда, журнал и порядок обновлений.

Оба варианта требуют проверки безопасности и совместимости. Наличие MCP не гарантирует поддержку любого клиента или защиту от всех атак.

Стоимость

Из чего складывается стоимость

Стоимость разработки MCP-сервера оцениваем после проверки API и границ пилота. Универсальной цены за подключение нет: одинаковое число инструментов может скрывать разную сложность доступов и данных.

  • Готовность API

    Документация, тестовая среда, лимиты, стабильность ответов и недостающие операции.

  • Авторизация и роли

    OAuth или другой подходящий механизм, связь с корпоративными учётными записями, права на объекты и отзыв доступа.

  • Число операций и клиентов

    Сценарии чтения и записи, проверки параметров, подтверждения и матрица совместимости.

  • Размещение и поддержка

    Требования к инфраструктуре и данным, наблюдаемость, документация, обновления протокола и клиентских приложений.

Первый этап заканчивается описанием одного сценария, контрактом инструмента, перечнем ограничений и критериями приёмки. После него согласуем состав реализации и смету.

Вопросы

Частые вопросы

Можно ли использовать готовый MCP-сервер?

Да, если он поддерживает нужные операции, корпоративные права и выбранный клиент. Начнём с проверки этого варианта; разработка требуется, когда остаётся конкретный непокрытый сценарий.

Кто проверяет права: модель или сервер?

Сервер и целевая система. Инструкция модели и скрытая кнопка не являются контролем доступа. Проверяем полномочия пользователя и доступ к объекту при каждом вызове; чтение и запись разделяем.

Можно ли разместить сервер внутри компании?

Возможность зависит от сети, API и выбранного клиента. Внутреннее размещение MCP-сервера не исключает передачу ответа внешней модели. Если данные должны оставаться внутри, отдельно проектируем весь маршрут данных и локальный AI-контур.

Что произойдёт при обновлении протокола или клиента?

На старте фиксируем совместимую конфигурацию и сценарии проверки. Обновление проверяем в тестовой среде до переноса в рабочую. Поддержку всех версий и клиентов заранее не обещаем; порядок сопровождения согласуем отдельно.

Как обрабатываются ошибки и повторные запросы?

Согласуем таймауты, понятные ответы и допустимые повторы. Для операций записи проверяем отсутствие дублей по идентификатору запроса. Недоступность API не должна превращаться в выдуманный ответ об успешном действии.

Сколько стоит разработка и что прислать для оценки?

Нужны название системы, документация API, выбранный AI-клиент и один сценарий с ролями. Укажите требования к размещению и данным. По ним определим обследование и состав пилота; пароли, токены и персональные данные в форму присылать не нужно.

Смежные задачи

Все услуги →

Практический разбор

Что почитать перед запуском

Ваш сценарий

Какую операцию нужно дать AI-клиенту?

Опишите систему, выбранный клиент, операции и требования к данным. Начнём с проверки API и сценария чтения. Не присылайте секреты и персональные данные.

Или напрямую: Telegram ↗ · +7 931 203-30-78 · hello@dev-crabs.ru