01 /
Поиск и чтение данных
Ассистенту нужен ограниченный доступ к информации продукта.
AI / инструменты
MCP-сервер
для вашего API.
Открываем нужные операции существующего продукта для AI-клиентов через понятные инструменты, права доступа и наблюдение за вызовами.
MCP
Go
Текущий API
Авторизация
Доступ к операциямrazrabotchik.com / MCP
AI-клиент01 / ЗАПРОС
MCP-инструменты02 / КОНТРОЛЬ
Существующий API03 / ВЫПОЛНЕНИЕ
Права и подтвержденияНаблюдаемые вызовы
Основа
Рабочий API
Выбор
Разрешённые операции
Контроль
Доступ и журналирование
Когда это полезно
Ассистенту нужны действия, а не весь API.
MCP связывает AI-клиент с инструментами. Для действующего продукта важнее всего решить, какие действия допустимы, кому они доступны и как пользователь поймёт их результат.
Сервер проектируется поверх проверенных операций API. Небезопасно автоматически превращать каждый endpoint в инструмент.
02 /
Действия по запросу
Нужно выполнить операцию с правами конкретного пользователя и понятным результатом.
03 /
Несколько AI-клиентов
Одни и те же инструменты должны иметь стабильные контракты и ограничения.
Разработка
Каждый инструмент — отдельное обещание.
01 /
Выбрать сценарии
Какие действия действительно нужны пользователю.
02 /
Определить права
Идентичность, разрешения, опасные операции и подтверждения.
03 /
Собрать инструменты
Контракты аргументов, ответы, ошибки и связь с API.
04 /
Проверить вызовы
Права, отказоустойчивость, журналирование и реальные сценарии клиентов.
Пример подхода
Помочь оператору найти заказ и изменить статус.
Поиск можно оформить как инструмент чтения. Изменение статуса требует проверки роли, допустимого перехода и подтверждения там, где действие существенно. Сервер передаёт понятные ошибки API, а операции остаются видимыми для команды.
Это схема возможной интеграции, не описание внедрённого клиентского проекта.
API → инструменты
Нужные действия. Понятные границы.
Контракты · права · наблюдение
Частые вопросы
Можно просто обернуть OpenAPI?
Автоматическая генерация может помочь с черновиком, но операции нужно отобрать, описать и проверить права и последствия вызова.
Нужен ли новый backend?
Не обязательно. MCP-сервер может использовать существующий API; объём изменений зависит от его контрактов и авторизации.
На чём пишется MCP-сервер?
Обычно на Go: у протокола есть официальный Go SDK, а сервер собирается в один исполняемый файл, который легко развернуть рядом с существующим API. Если команде удобнее другой стек, язык согласуется до начала работ.
Как ограничить доступ к данным?
Инструмент должен применять разрешения пользователя и минимально необходимые данные, а не полагаться только на подсказку модели.
Следующий шаг
Расскажите о вашей задаче.
Опишите систему, цель и ограничения. В ответ предложим следующий шаг, формат работы и способ технического контроля.