Composio · MCP Connect · Toolkits
Один MCP Connect вместо зоопарка серверов — toolkits, OAuth и сценарии Gmail → Notion → Slack
ИИ-агент — это не «умный чат в окошке». Чат отвечает текстом. Агент ещё и делает шаги во внешних сервисах: читает почту, создаёт карточку в Notion, кидает дайджест в Slack, обновляет CRM.
Без «рук» агент остаётся консультантом: красиво пересказывает бриф, но не кладёт его в базу и не собирает лиды из входящих. С руками появляется рабочий контур: письмо → карточка → алерт команде.
Типичная боль контент-команды и маркетинга из России:
Интеграция ИИ-агентов с приложениями как раз закрывает этот разрыв. Дальше — как сделать это через один MCP-коннектор Composio, а не через зоопарк отдельных серверов.
Коротко: агент без интеграций отвечает; агент с Gmail/Notion/Slack — двигает процесс.
На практике новичок часто ставит отдельный MCP под Slack, отдельный под Notion, ещё один под Gmail. В Cursor или Claude это выглядит как длинный список серверов. Каждый — свой конфиг, свои токены, свои сбои.
Что обычно ломается:
Отдельные MCP из каталогов вроде mcp.so удобны, когда нужен один узкий инструмент. Но для контент- и лид-пайплайна «почта + база + чат + CRM» зоопарк превращается в проект по поддержке инфраструктуры, а не по маркетингу.
Composio Connect — единый endpoint. Агент не держит сотню серверов: ищет tool в каталоге, поднимает OAuth нужного приложения и выполняет действие.
Дальше — как устроен Connect endpoint, meta-tools и чем MCP отличается от native SDK.
Редакционная метафора цикла search → OAuth → execute; не скриншот dashboard Composio.
Composio Connect — это hosted MCP-сервер по адресу https://connect.composio.dev/mcp. По документации Composio он даёт агенту доступ к 1000+ приложений (Gmail, Notion, Slack, GitHub, Linear, HubSpot и др.) через одно подключение.
Вместо того чтобы вываливать в модель тысячи app-tools, наружу отдаются семь meta-tools — «умных обёрток», через которые агент сам ищет нужное действие, поднимает OAuth и выполняет вызовы.
Семь meta-tools по канону Connect:
Паттерн агента простой: search → connect (OAuth) → execute. Сначала нашли нужные tools, потом авторизовали приложение, потом выполнили.
Есть и режим direct-tools: можно выдать «классический» MCP только с белым списком (например, только GMAIL_FETCH_EMAILS и GMAIL_CREATE_EMAIL_DRAFT) — без meta-tools. Удобно, когда хотите жёстко ограничить агента.
Два рабочих пути в v3 SDK:
| Путь | Когда брать | Суть |
|---|---|---|
| MCP Connect | Cursor, Claude Desktop/Code, VS Code Copilot, Windsurf, n8n MCP Client | URL сессии + заголовок с API-ключом; максимальная переносимость между клиентами |
| Native Tools + provider | LangChain, CrewAI, OpenAI Agents, LlamaIndex и др. | composio.create(user_id) → session.tools() + пакет под фреймворк |
Честный trade-off из документации: через MCP не работают SDK-хуки вроде beforeExecute / afterExecute / modifySchema и локальные custom tools. Если нужны хуки и свои tools — идёте в Native + provider.
Термины v3 (чтобы не путаться со старыми гайдами): entity → user_id, actions → tools, apps → toolkits, integration → auth config, connection → connected account, toolset → provider.
Доступ из России. Composio — зарубежный SaaS: регистрация, оплата картой и доступ к dashboard иногда упираются в ограничения банков/VPN. Заранее проверьте вход на docs.composio.dev и оплату. Если карта из РФ не проходит — рабочие обходы: корпоративная/иностранная карта команды, посредник оплаты, либо временно оставить детерминированные сценарии на Make/n8n (у Kovcheg по ним уже есть отдельные гайды) и подключать Composio, когда биллинг стабилен.
Ниже — пошаговый how-to, который новичок может повторить без бэкграунда разработчика. Цель: увидеть tools Composio в клиенте и успешно авторизовать хотя бы одно приложение.
Заведите аккаунт на Composio и создайте API key в кабинете.
Откройте конфиг MCP вашего клиента. В Cursor это обычно файл .cursor/mcp.json в проекте или в пользовательских настройках.
Добавьте сервер Connect. Ориентир: URL https://connect.composio.dev/mcp и заголовок x-consumer-api-key с вашим ключом. Точный JSON лучше сверить с актуальной страницей Connect.
Перезапустите MCP / клиента. В списке tools должны появиться meta-tools Composio.
Напишите: «Найди tools для Gmail и покажи, нужно ли подключение». Агент должен вызвать search; если auth нет — предложит OAuth-ссылку.
Коротко: в интерфейсе клиента MCP помечен как connected, видны meta-tools, по запросу агент выдаёт OAuth-ссылку или уже выполняет GMAIL_* / NOTION_* действие.
Типичные ошибки новичка:
Для Claude Desktop и Claude Code Composio Connect заявлен как клиент «из коробки»: один connector URL, тот же паттерн search → OAuth → execute. Вендорский how-to советует начинать с 3–5 приложений — не потому что «не тянет», а чтобы ясно видеть workflow и не размазать права.
Практичный минимум для контента: Gmail + Notion + Slack. CRM (HubSpot/Salesforce) — следующим слоем, когда почта и база уже стабильны.
В Cursor схема та же: mcp.json + API key в header. Кроме Cursor и Claude в списке клиентов Connect фигурируют Codex, VS Code Copilot, Windsurf, Cline, ChatGPT (Developer Mode), Notion AI agent, OpenAI Agent Builder и n8n MCP Client.
Если пишете агента кодом (Python/TypeScript), можно не возиться с mcp.json, а поднять MCP-сессию из SDK: composio.create(user_id, toolkits=[...], mcp=True) и отдать клиенту session.mcp.url + headers. Для LangChain/CrewAI/OpenAI Agents берите provider-пакеты (для OpenAI Agents — composio_openai_agents / @composio/openai-agents, не путать со старым composio_openai).
OAuth в Connect устроен по требованию: при первом обращении к приложению Composio генерирует ссылку; вы подтверждаете права в браузере; connection сохраняется между сессиями. Ссылки короткоживущие: протухла — повторите действие или подключите app вручную через Connect Apps в dashboard.
Правило least privilege для новичка:
Для production документация и FAQ toolkit’ов рекомендуют свои OAuth credentials приложения, а не только встроенный app Composio. Для теста built-in удобнее; для боевых данных клиентов — свои client id/secret.
Заявления вендора по безопасности: SOC 2 / ISO 27001, шифрование in transit и at rest. Это не отменяет вашу дисциплину: ревокация доступов, минимальные scopes, отдельный work-аккаунт.
По умолчанию — один аккаунт на toolkit. Если нужны work и personal Gmail:
multi_account.enable=true);work-gmail / personal-gmail;require_explicit_selection, чтобы агент не писал «не в тот» ящик.Если action падает с auth error: в dashboard Disconnect → Reconnect «нездорового» connection. Если tools внезапно пропали — кэш клиента + reconnect MCP.
Соберём живой контур «мини-контент-завода» без обещаний волшебного ROI (независимых RU-кейсов с цифрами именно по Composio нет — опираемся на рабочий паттерн).
Задача агенту (пример промпта):
Что делает агент под капотом:
COMPOSIO_SEARCH_TOOLS — находит Gmail/Notion/Slack tools.COMPOSIO_MANAGE_CONNECTIONS + COMPOSIO_WAIT_FOR_CONNECTIONS (вы кликаете OAuth).COMPOSIO_MULTI_EXECUTE_TOOL — читает почту, пишет Notion, готовит Slack-сообщение.COMPOSIO_REMOTE_WORKBENCH / bash sandbox, чтобы не утопить контекст чата.Guardrails (обязательно пропишите в системном промпте):
Telegram. Автопостинг в Telegram нейросетью часто делают через бота или Make — отдельный контур. В каталоге Composio наличие Telegram-toolkit нужно проверить на момент запуска. Честная схема для РФ-команд: Composio закрывает Gmail/Notion/Slack/CRM, Telegram — уже привычным каналом Kovcheg (бот/Make), без натяжки «всё в одном любой ценой».
В маркетинговых материалах встречаются оценки вроде «ИИ сокращает время на SMM». Используйте их как мотив автоматизировать рутину, а не как гарантию эффекта именно от Composio.
| Симптом | Вероятная причина | Что сделать |
|---|---|---|
| Tools не видны | MCP не connected / кэш клиента | Reconnect, Clear cache (Claude), перезапуск |
| OAuth-ссылка не открылась / expired | Короткоживущая ссылка | Повторить действие или Connect Apps в dashboard |
| Auth error на action | «Гнилой» connected account | Disconnect + Reconnect в кабинете |
| Агент пишет не в тот Gmail | Нет aliases / нет explicit selection | Включить multi-account, задать имена |
| Нужны хуки до/после tool | Вы на MCP-пути | Перейти на Native SDK + provider |
| Упёрлись в лимиты | Free/pro rate limits | Смотрите тариф и pro-tools limits в docs |
Тарифы (официально на момент подготовки гайда): usage-based. Totally Free — 20K tool calls/мес; Ridiculously Cheap — $29/мес, 200K calls; Serious Business — $229/мес, 2M calls; Enterprise — custom + SLA/SOC-2/VPC. На сайте анонсирована смена pricing 15 августа 2026 — перед продом сверьте composio.dev/pricing.
Pro tools: на Free — порядка 100/min standard и 1,000/hour pro; на Paid — выше (ориентиры 5,000/min / 10,000/hour); pro-вызовы дороже standard примерно втрое. Точные цифры — в разделе pro-tools документации.
Не «или-или навсегда», а выбор под задачу.
| Инструмент | Сильная сторона | Слабое место | Берите, если… |
|---|---|---|---|
| Composio Connect | Один MCP, 1000+ toolkits, OAuth per-user, meta-tools | Зависимость от SaaS, биллинг/доступ из РФ, MCP без SDK-хуков | Агенту нужны «руки» к многим apps без зоопарка серверов |
| Native Composio + LangChain/CrewAI | Хуки, custom tools, контроль в коде | Нужен разработчик/вайбкодинг | Строите своего агента в коде |
| Свой FastMCP / MCP | Полный контроль, локальность | Пишете и поддерживаете каждый коннектор | 1–2 критичных сервиса и жёсткий security perimeter |
| Каталог mcp.so / community MCP | Быстрый старт точечно | Зоопарк, разный уровень зрелости | Нужен один узкий tool |
| Arcade и аналоги | Акцент на безопасной авторизации | Другая экосистема | Сравниваете auth-first рантаймы |
| Make / n8n | Детерминированные сценарии, наглядные шаги, привычный RU-стек | Меньше «агентной» свободы в runtime | Процесс жёстко задан: «если X → Y → Z» без рассуждений |
Платформа ИИ-агентов в чистом виде редко заменяет iPaaS. Наоборот: Make/n8n закрывают стабильный конвейер, Composio/MCP — слой, где агент выбирает действия. В экосистеме Kovcheg это стыкуется с вайбкодингом в Cursor и курсом «Контент-завод»: агент помогает производить и маршрутизировать контент, а публикации в привычные каналы можно оставить проверенным автоматизациям.
Если нужно собрать систему целиком — агенты, Make/n8n и публикации в рабочие каналы — логичный следующий шаг: обучение по автоматизации и вайбкодингу на kv-ai.ru.
Коротко: за один диалог агент нашёл tools, при необходимости поднял OAuth, создал артефакты в Notion и Slack без самостоятельной отправки писем клиентам.
Опционально: репозиторий ComposioHQ/composio-mcp-plugin даёт готовый mcp.json и skills вроде search→connect→execute и кросс-app дайджеста — удобный старт, если не хотите собирать конфиг с нуля.
Каталог (mcp.so и аналоги) — витрина разных серверов: ставите по одному. Composio Connect — один hosted MCP с meta-tools и каталогом toolkits под капотом. Меньше конфигов, единый OAuth-контур, зато зависимость от вендора.
Нет. Для старта достаточно Connect URL + API key в настройках клиента. Код (SDK + providers) понадобится, когда нужны хуки, custom tools или встраивание в LangChain/CrewAI/OpenAI Agents.
Безопаснее, чем раздавать сырые пароли, но не «подключил и забыл». Давайте минимальные права, начинайте с read/draft, используйте work-аккаунты, для prod — свои OAuth credentials, регулярно проверяйте connections в dashboard. Ревокация — ваш рабочий рычаг.
Для лидов и triage — да: Gmail → Notion → Slack/CRM — сильный контур. Для автопостинга в Telegram/соцсети — часто лучше гибрид: квалификация и черновики через агента+Composio, публикация — через бота или Make/n8n с явным approve.
composio-mcp-plugin.