MCP-сервер (AI-агенты)
Graspil предоставляет собственный MCP-сервер — это способ подключить AI-агента (Claude, ChatGPT и любой другой клиент с поддержкой MCP) напрямую к вашим данным в Graspil, чтобы агент мог сам строить отчёты, смотреть статистику, управлять рассылками и автоматизациями — без захода в личный кабинет.
Подключив MCP-сервер к своему агенту, можно просто попросить его словами:
«Покажи, сколько новых пользователей пришло за последнюю неделю, и сравни с предыдущей» «Собери отчёт по воронке оплат за июнь и сохрани его» «Сколько я заработал по реферальной программе в этом месяце?» «Создай рассылку с текстом ... и запусти её на всех активных пользователей»
— и агент сам вызовет нужные инструменты, получит данные и ответит.
MCP-сервер — это тонкая надстройка над обычным API Graspil: агент работает с теми же ботами и правами, что разрешены вашему API-ключу, и ограничения по доступу и тарифу применяются точно так же, как при обычной работе через интерфейс или API.
Что умеет агент через MCP
Смотреть список доступных событий и ресурсов (ботов), строить и просматривать отчёты (тренды, воронки, ретеншен, UTM), сохранять готовые отчёты, получать список уже сохранённых
Premium
Дашборды
Смотреть, создавать, редактировать и удалять дашборды
Premium
Создавать, редактировать, публиковать/снимать с публикации, удалять и просматривать автоматизации (триггер → действие)
Premium
Лендинги
Создавать, редактировать, удалять и просматривать лендинги
Premium
Интеграции
Смотреть список подключённых интеграций и доступных типов
Premium
Смотреть историю переписки бота с пользователями, с фильтрами и поиском по тексту (только просмотр)
Premium
Смотреть баланс, список рефералов, историю выплат и действующие ставки (только просмотр)
Premium
Документация
Полнотекстовый поиск по документации Graspil — агент может сам найти ответ на вопрос «как это работает»
Любой (включая бесплатный)
На бесплатном тарифе через MCP доступен только поиск по документации. Все остальные разделы требуют тарифа Premium (или Trial) — иначе запрос завершится ошибкой 403 Forbidden («Premium tariff required»).
Через MCP нельзя выполнять чувствительные операции с реферальной программой (начисления, выплаты, привязка кодов) — эти действия остаются доступны только через интерфейс или прямой API.
Авторизация
Агент подключается по вашему персональному ключу из раздела «API-ключи» — обычный ключ одного бота (из раздела «Мои боты», см. Авторизацию) для MCP не подходит, нужен именно пользовательский ключ.
Откройте Профиль → API-ключи в личном кабинете.
Нажмите «Создать ключ», задайте название (например, «Claude MCP»).
При необходимости ограничьте ключ конкретными ботами и правами по разделам (только чтение / полный доступ) — по умолчанию ключ даёт доступ ко всем вашим ботам.
Скопируйте значение ключа — он показывается один раз в открытом виде, сохраните его в надёжном месте.
Один ключ работает сразу со всеми ботами, к которым у вас есть доступ — агент сам выбирает нужного бота в разговоре (спрашивает вас, если ботов несколько), отдельно подключать каждого бота не нужно.
Как подключить агента
MCP-сервер Graspil работает по протоколу Streamable HTTP — большинство современных AI-клиентов (Claude Desktop, Claude Code и т. д.) поддерживают такое подключение как «удалённый MCP-сервер» по URL.
Адрес сервера: https://mcp.graspil.com/mcp
Общий вид настройки для клиентов, поддерживающих MCP-серверы через URL и заголовки:
Точные шаги отличаются в зависимости от клиента:
Claude Desktop / Claude Code — добавьте сервер в настройках интеграций (Settings → Connectors / MCP servers), указав URL и заголовок
Api-Key.Другие MCP-совместимые клиенты — используйте аналогичный механизм добавления удалённого MCP-сервера по URL с кастомным заголовком авторизации.
После подключения агент сам запросит список доступных ботов (если их несколько) и уточнит, с каким из них работать в рамках разговора.
Частые вопросы
Может ли агент видеть данные других пользователей? Нет. Агент действует строго в рамках прав вашего API-ключа — видит только тех ботов и те данные, к которым у ключа есть доступ.
Можно ли ограничить, что агент может делать? Да. Как и для обычного API-ключа, можно ограничить доступ по ботам и выдать права «только просмотр» для отдельных разделов (например, разрешить агенту смотреть отчёты, но не создавать рассылки) — настраивается при создании или редактировании ключа в разделе «API-ключи».
Что если я отзову ключ? Агент сразу потеряет доступ — MCP-сервер не хранит собственных данных и не кэширует права надолго, все проверки идут через тот же ключ при каждом запросе.
Нужно ли что-то дополнительно устанавливать? Нет, сервер уже развёрнут и обслуживается на стороне Graspil — нужен только сам API-ключ и MCP-совместимый клиент.
Почему агент получает 403 Forbidden?
На бесплатном тарифе через MCP доступен только поиск по документации — все остальные разделы (отчёты, дашборды, рассылки, автоматизации, лендинги, интеграции, история переписки, реферальная программа) требуют тарифа Premium (или Trial); запрос будет отклонён с ошибкой 403 («Premium tariff required»). Нужно перевести аккаунт/бота на Premium.
Последнее обновление