Сторонние сервисы: API и MCP — что это и зачем подключать
Разбираемся, как подключить к агенту сервисы, которых нет в списке готовых интеграций: что такое API и MCP, чем они отличаются и когда какой способ выбрать.
Встроенные интеграции ASCN Agent покрывают самые популярные инструменты: Gmail, Google Calendar, Slack, Notion, GitHub. Но у каждого бизнеса своя экосистема. Кто-то работает в Airtable, кто-то в HubSpot, кто-то в Shopify. Чтобы агент умел работать с любым из этих сервисов, нужно разобраться в двух понятиях: API и MCP.
Что такое API
API (Application Programming Interface) — это способ, которым одна программа разговаривает с другой.
Представьте ресторан. Вы сидите за столиком и хотите заказать блюдо. Вы не идёте на кухню сами — вы говорите официанту. Официант передаёт заказ поварам, а потом приносит вам готовое блюдо обратно.
В этой аналогии:
- Вы — это агент, которому нужна информация или действие
- Официант — это API
- Кухня — это сервис (Airtable, Stripe, Shopify и т.д.)
Почти каждый современный веб-сервис имеет API. Airtable, HubSpot, Stripe, Shopify, любая CRM, любой SaaS-продукт — всё это общается через API.
Чтобы агент мог использовать API, нужны две вещи:
- Документация — описание того, что умеет сервис и как его просить
- API-ключ — что-то вроде пропуска, который подтверждает: «да, этот агент имеет право обращаться к нашим данным»
Что такое MCP
MCP (Model Context Protocol) — это современный стандарт, созданный специально для ИИ-агентов.
Если API — это общий язык между программами, то MCP — это язык между программами и ИИ-агентами. Разница в том, насколько легко агенту разобраться в инструменте.
Вот другая аналогия. Представьте, что вы нанимаете нового сотрудника.
- API — это когда вы даёте ему книгу инструкций на 500 страниц и говорите: «разберись сам».
- MCP — это когда к вам приходит специалист и сам говорит: «вот что я умею, вот как меня попросить, вот что я верну в ответ».
Когда вы подключаете MCP-сервер к агенту, агент сам обнаруживает его возможности. Не нужно объяснять команды вручную — агент понимает инструмент автоматически.
В чём разница на практике
| API | MCP | |
|---|---|---|
| Для кого | Любой сервис | Сервисы с MCP-сервером |
| Как агент разбирается | Вы даёте документацию | Агент обнаруживает сам |
| Что нужно от вас | Документация + API-ключ | Конфиг сервера + (иногда) ключ |
| Надёжность | Зависит от качества документации | Обычно проще и стабильнее |
Где найти MCP-серверы
MCP-серверы публикуют сами разработчики сервисов или сообщество.
Вы можете найти пользовательские и официальные mcp в каталогах:
- Smithery.ai — каталог готовых MCP-серверов
- mcp.so — ещё один каталог с фильтрами
- GitHub — многие сервисы публикуют официальные MCP-серверы. Поиск:
MCP server [название сервиса]
С решениями из каталогов нужно быть аккуратными, как с mcp, так и с готовыми скиллами для ваших агентов. Всегда есть риск, что внутри будет зараженный md файл. Для вас это риск потери ваших API ключей, поэтому если используете агента для торговли или, например, работы с приватными данными клиентов, то исключите неофициальные api и mcp для устранения рисков.
Самый надежный способ — использовать официальные mcp, для этого просто вбейте в поиск “название компании + mcp” или попросите агента найти. Как правило компании на официальном сайте дают ссылку на mcp, либо всё будет находиться в документации самого проекта.
Сейчас уже есть MCP для Notion, GitHub, Slack, Google Drive, Airtable, Linear, Jira и десятков других инструментов.
- Вбиваем запрос “Notion mcp “ в поисковик
- Видим такую страницу на официальном домене https://developers.notion.com/guides/mcp/overview
- Говорим агенту “подключи этот mcp https://developers.notion.com/guides/mcp/overview “ и дальше агент всё сделает сам, вам возможно придется ему дать только токен от вашего аккаунта.
Как агент использует всё это
Если подключаете через MCP:
- Берёте конфиг MCP-сервера (обычно JSON с URL и настройками)
- Вставляете его в настройки агента: Мозг → интеграции/инструменты
- Пишете агенту на обычном языке: «проверь новые задачи в Linear»
- Агент сам понимает, что умеет инструмент, и выполняет задачу
Если подключаете через API:
- Открываете документацию сервиса (обычно
developer.сервис.comилиdocs.сервис.com/api) - Копируете нужный раздел документации или просто ссылку
- Берёте API-ключ в настройках своего аккаунта
- Вставляете документацию в базу знаний агента или прямо в чат
- Добавляете API-ключ в секреты агента
- Пишете агенту задачу — он сам разбирается как вызвать нужный метод
От вас обычно нужно только одно: API-ключ. Если агент знает документацию — остальное он делает сам.
Пример
Carla ведёт интернет-магазин в Барселоне на Shopify. Она хочет, чтобы агент каждое утро проверял новые заказы и отправлял сводку в Telegram.
Shopify имеет API. Carla открыла документацию Shopify, скопировала раздел про получение заказов и добавила его в базу знаний агента. Потом добавила API-ключ в секреты. Написала агенту: «Каждый день в 8:00 проверяй новые заказы в Shopify и отправляй сводку в мой Telegram».
Агент разобрался в документации и теперь каждое утро без напоминаний отправляет сводку.