Composio для агентов: как подключить 1000+ инструментов и не утонуть в OAuth

01Что такое Composio и почему это не «ещё один MCP»

Composio — это слой доступа к инструментам для AI-агентов: 1000+ готовых интеграций (toolkits) с уже написанными описаниями функций, аутентификацией и единым способом вызова. Агент не хранит в контексте сотни JSON-схем: он получает meta-tools, которые на ходу ищут нужный инструмент, проводят авторизацию и выполняют вызов. Репозиторий ComposioHQ/composio на 13.10.2026 — 30 531 звезда, 4 849 форков, лицензия MIT, язык TypeScript.

Часть запросов приходит с опечатками — «компосио», «compisio», «compasio». Речь об одном и том же продукте. Важно и другое: Composio не заменяет протокол MCP, а дополняет его — каждая сессия умеет отдавать себя как MCP-эндпоинт, поэтому Claude Code, Cursor или Hermes могут подключиться к ней как к обычному MCP-серверу.

02Установка: SDK, CLI и первый вызов

Ключ берётся в дашборде и кладётся в переменную окружения — в код его не пишем. Дальше выбираете путь: SDK внутрь своего приложения или CLI для терминала и кодинг-агентов. Версии ниже — фактические на 13.10.2026: пакет @composio/core 0.23.0 (npm, 12.10.2026), composio-core 0.7.21 (PyPI), релиз CLI @composio/cli@0.4.3 (13.10.2026).

pip install composio
# или
npm install @composio/core @composio/openai-agents

export COMPOSIO_API_KEY=***

from composio import Composio
composio = Composio()
session = composio.create(user_id="user_123")
tools = session.tools()

curl -fsSL https://composio.dev/install | sh
composio login
composio search "send email"
composio link

03Подключение через MCP: одна ссылка вместо установки

Если у вас уже есть MCP-клиент, SDK можно не ставить вовсе. Каждая сессия выставляет hosted MCP-эндпоинт: включаете флаг mcp: true при создании сессии и передаёте адрес session.mcp.url в конфиг клиента. На стороне сервиса Composio отдельно описан «MCP Gateway» — единая управляемая точка входа для инструментов и агентов.

{
  "mcpServers": {
    "composio": {
      "type": "url",
      "url": "<session.mcp.url из вашего кода>"
    }
  }
}

04Лимиты бесплатного тарифа и тарифы

Composio тарифицирует не токены, а вызовы инструментов. Бесплатный тариф Hobby жёстко ограничен по количеству вызовов, не требует карты и не выставляет счёт «случайно»: при достижении лимита работа просто останавливается до следующих суток месяца или до апгрейда. Важная развилка — чья OAuth-программа используется: со своей программой бесплатных вызовов в месяц больше, чем с общей программой Composio.

Практический вывод для небольшого проекта: 100 000 вызовов в месяц — это примерно 3 300 вызовов в день, что с запасом покрывает личного ассистента и небольшую внутреннюю автоматизацию. Если агент работает с десятками пользователей и внешними системами, считайте по факту статистики в дашборде и ставьте spend caps заранее.

05Место Composio среди open-source платформ агентов

Composio не единственный способ связать агента с сервисами, но у него самая узкая и понятная задача: инструменты и аутентификация. Платформы автоматизации и конструкторы агентов решают другую задачу — оркестрацию. Ниже — сопоставимые по типу open-source проекты; цифры сняты через GitHub API 13.10.2026 и служат только ориентиром масштаба, а не рейтингом.

06Типичные ошибки и как их чинить