Огляд
Інтеграція MCP (Model Context Protocol) дозволяє агенту підключатися до кастомних інструментів та інтеграцій через Model Context Protocol. Вона використовує Composio як провайдера й дає AI-асистенту доступ до зовнішніх сервісів та API через кастомні MCP-інструменти, без потреби в прямій API-інтеграції.
Передумови
Перед налаштуванням MCP: Увійдіть у Composio, створіть акаунт на app.composio.dev; Створіть новий проєкт, натисніть Create New Project, вкажіть назву й за бажанням оберіть один з типових auth config.
Створення кастомного MCP-сервера в Composio
Крок 1, Вхід: перейдіть на app.composio.dev і увійдіть.
Крок 2, Створення MCP-сервера: відкрийте вкладку MCP Configs → Create MCP Config;
знайдіть інтеграції (Google Calendar, Slack, GitHub тощо); натисніть на інтеграцію;
створіть auth config обраного набору;
оберіть потрібні інструменти з цієї інтеграції; натисніть Create MCP.
Крок 3, Створення інстансу: у MCP Configs виберіть свій сервер →
Create Instance;
введіть user id і натисніть Connect Account;
пройдіть автентифікацію й натисніть Create Server;
скопіюйте MCP URL.
Підключення MCP до MyChatBot
Крок 1: у кабінеті MyChatBot перейдіть у Integrations, виберіть агента, знайдіть MCP у списку й натисніть Connect.
Крок 2: вкажіть Integration Name (описову назву) і MCP Server URL (з вашого розгорнутого Composio-інструмента), натисніть Submit.
Система автоматично підтягне доступні інструменти з вашого MCP-сервера; перегляньте інструменти, які стануть доступні агенту.
Налаштування MCP-інструментів
Огляд інструментів: система показує всі інструменти з вашого MCP-сервера, кожен із назвою й описом, обов'язковими й опційними параметрами та форматом вихідних даних.
Вибір інструментів: перегляньте кожен, оберіть, які увімкнути для агента, налаштуйте специфічні параметри й збережіть.
Налаштування в інструкціях агента
Базове використання: вкажіть агенту використовувати названий MCP-інструмент із конкретними параметрами й завжди перевіряти відповідь та інформувати клієнта про результат.
Обробка помилок: при збої перевірте параметри, повторіть раз для тимчасових проблем, повідомте клієнта про стійкі помилки й запропонуйте альтернативи.
Багатокрокові операції: поєднуйте інструменти, зберіть дані одним, обробіть і продовжіть наступним, підтвердьте завершення й підсумуйте всі дії.
Усунення проблем
Типові проблеми: MCP-сервер недоступний (перевірте URL, розгортання, мережу); помилки автентифікації (перевірте підключені акаунти, протерміновані токени, переавтентифікуйтесь); інструмент не знайдено (перевірте конфігурацію, точну назву, чи увімкнено для агента); помилки параметрів (обов'язкові vs опційні, формати/типи, спецсимволи).
Отримання допомоги: перегляньте документацію Composio, логи MCP-сервера, тестуйте інструменти окремо в Composio, зверніться в підтримку за потреби.
Питання безпеки
Захист даних: MCP-інструменти обробляють дані через безпечну інфраструктуру Composio; розумійте, які дані передаються третім сторонам, і дотримуйтесь регуляцій приватності. Контроль доступу: регулярно переглядайте підключені акаунти й дозволи, оновлюйте токени, відстежуйте підозрілу активність. Найкращі практики: принцип найменших привілеїв, конфіденційність MCP URL, аудит та оновлення сервісів, документування всіх інтеграцій.
Обмеження й обслуговування
Обмеження: MCP-інструменти залежать від доступності Composio; продуктивність, від rate limits третіх сторін; деякі сценарії потребують кількох викликів; обробка помилок залежить від відповідей сервісів. Кожен сервіс має власні rate limits, відстежуйте використання й передбачте retry-логіку.
Оновлення й моніторинг: регулярно перевіряйте оновлення інтеграцій Composio, тестуйте після оновлень, оновлюйте інструкції агента при зміні інтерфейсів, стежте за deprecation; відстежуйте успішність/збої й час відгуку та налаштуйте сповіщення про критичні збої.