Разработка MCP-серверов для ваших систем
AI-помощнику нужен статус заказа или остаток на складе? Разработаем MCP-сервер над существующим API: он предоставит согласованные инструменты и проверит права перед обращением к системе. Начнём с одного клиента и сценария чтения.
- Один API и выбранный AI-клиент
- Чтение и запись — отдельно
- Права проверяются на сервере
Учебный сценарий
Одна операция — разные права
В каталоге запчастей наблюдатель может проверить остаток, а закупщик — ещё и подготовить черновик заявки. Смените роль и выполните обе операции: журнал покажет разрешение или отказ.
Вымышленная деталь · DEMO-42
Проверьте границу доступа
Наблюдатель: только чтение. Закупщик: чтение и черновик. Попробуйте создать черновик от каждой роли.
Журнал последних действий
- Смежный опыт
Academia Suites
Команда проектировала и разрабатывала портал инвестора, объединяющий данные об объектах, доходности, мероприятиях и документах. Работа включала интеграцию данных по объектам. Это опыт интерфейсов и интеграций, а не публичный кейс MCP.
- Результат первого этапа
Контракт одного инструмента
Зафиксируем источник данных, входные поля, ответ, разрешённые роли и поведение при отказе. Учебный пример выше не доказывает прохождение испытаний реального сервера.
Когда это нужно
Когда нужен свой MCP-сервер
MCP — протокол взаимодействия AI-приложения с внешними инструментами и данными. Сервер связывает согласованные операции с API вашей системы. Он не заменяет саму систему, модель или правила доступа.
Узнать статус заказа
Сотрудник обращается к помощнику, а тот получает статус по номеру заказа. Ответ ограничиваем полями и заказами, доступными этому сотруднику.
Получить справочную информацию
Найти артикул, остаток или карточку оборудования в существующем сервисе. Определяем источник, допустимую давность данных и ответ при недоступности API.
Подготовить действие к проверке
Сформировать черновик заявки по заданной схеме. Создание черновика и окончательная отправка — разные операции с отдельными правами и подтверждением.
Когда можно обойтись без разработки
- Готовый сервер уже покрывает нужные операции, права и требования к данным — сначала проверим его.
- Нужен регулярный обмен между двумя системами без AI-клиента — подойдёт обычная API-интеграция.
- У системы нет доступного интерфейса: сначала исследуем способ интеграции. MCP сам по себе доступ к данным не создаёт.
Границы результата
Инструкция, обмен и инструмент — разные задачи
Выбор начинается с действия сотрудника. MCP нужен там, где совместимый AI-клиент должен вызвать конкретную операцию вашей системы.
API-интеграция
Передаёт данные между системами по событию или расписанию. Полезна для заказов, статусов и документов без участия AI-помощника.
Agent Skills
Описывают процедуру: что учесть, в каком порядке работать и как проверить результат. Инструкция сама не выдаёт права и не заменяет подключение к системе.
MCP-сервер
Предоставляет инструменты выбранному клиенту. Решение о доступе и допустимых параметрах остаётся в серверной логике и корпоративной системе.
Можно сочетать эти подходы. Мы не предлагаем общий доступ AI к базе данных или произвольный SQL вместо ограниченных операций.
Как работаем
Пилот с проверяемым результатом
Фиксируем один клиент и его версию, одну систему, роли и набор операций. Новые клиенты и запись в систему расширяют объём работ отдельно.
- 01 · Обследование
Проверяем API и доступы
Изучаем документацию, ограничения, способ авторизации и тестовую среду. Выбираем сценарий чтения и поля, которые допустимо передавать модели.
- 02 · Контракт
Описываем инструмент
Согласуем входную схему, формат ответа, права, таймауты и ошибки. Определяем, какие действия требуют подтверждения сотрудника.
- 03 · Реализация
Собираем и подключаем
Реализуем сервер, проверку полномочий и журнал. Подключаем выбранный клиент в согласованной среде, документируем настройки и ограничения.
- 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
Заявка отправлена
Спасибо! Свяжемся с вами в течение 24 часов — на почту или в Telegram.