> For the complete documentation index, see [llms.txt](https://docs.graspil.com/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.graspil.com/ru/mcp.md).

# MCP-сервер (AI-агенты)

Graspil предоставляет собственный **MCP-сервер** — это способ подключить AI-агента (Claude, ChatGPT и любой другой клиент с поддержкой [MCP](https://modelcontextprotocol.io/)) напрямую к вашим данным в Graspil, чтобы агент мог сам строить отчёты, смотреть статистику, управлять рассылками и автоматизациями — без захода в личный кабинет.

Подключив MCP-сервер к своему агенту, можно просто попросить его словами:

> «Покажи, сколько новых пользователей пришло за последнюю неделю, и сравни с предыдущей»\
> «Собери отчёт по воронке оплат за июнь и сохрани его»\
> «Сколько я заработал по реферальной программе в этом месяце?»\
> «Создай рассылку с текстом ... и запусти её на всех активных пользователей»

— и агент сам вызовет нужные инструменты, получит данные и ответит.

{% hint style="info" %}
MCP-сервер — это тонкая надстройка над обычным API Graspil: агент работает с теми же ботами и правами, что разрешены вашему API-ключу, и ограничения по доступу и тарифу применяются точно так же, как при обычной работе через интерфейс или API.
{% endhint %}

***

## Что умеет агент через MCP

| Область                                             | Что может агент                                                                                                                                                                  |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Отчёты](/ru/api/reports.md)                        | Смотреть список доступных событий и ресурсов (ботов), строить и просматривать отчёты (тренды, воронки, ретеншен, UTM), сохранять готовые отчёты, получать список уже сохранённых |
| Дашборды                                            | Смотреть, создавать, редактировать и удалять дашборды                                                                                                                            |
| [Рассылки](/ru/api/broadcasts.md)                   | Создавать, редактировать, запускать, отменять и просматривать рассылки                                                                                                           |
| [Автоматизации](/ru/api/automations.md)             | Создавать, редактировать, публиковать/снимать с публикации, удалять и просматривать автоматизации (триггер → действие)                                                           |
| Лендинги                                            | Создавать, редактировать, удалять и просматривать лендинги                                                                                                                       |
| Интеграции                                          | Смотреть список подключённых интеграций и доступных типов                                                                                                                        |
| [Реферальная программа](/ru/api/referral-system.md) | Смотреть баланс, список рефералов, историю выплат и действующие ставки (только просмотр)                                                                                         |
| Документация                                        | Полнотекстовый поиск по документации Graspil — агент может сам найти ответ на вопрос «как это работает»                                                                          |

{% hint style="warning" %}
Через MCP нельзя выполнять чувствительные операции с реферальной программой (начисления, выплаты, привязка кодов) — эти действия остаются доступны только через интерфейс или прямой API.
{% endhint %}

***

## Авторизация

Агент подключается по вашему персональному ключу из раздела [«API-ключи»](https://app.graspil.com/api-keys) — обычный ключ одного бота (из раздела «Мои боты», см. [Авторизацию](/ru/api/auth.md)) для MCP не подходит, нужен именно пользовательский ключ.

1. Откройте **Профиль → API-ключи** в личном кабинете.
2. Нажмите **«Создать ключ»**, задайте название (например, «Claude MCP»).
3. При необходимости ограничьте ключ конкретными ботами и правами по разделам (только чтение / полный доступ) — по умолчанию ключ даёт доступ ко всем вашим ботам.
4. Скопируйте значение ключа — он показывается один раз в открытом виде, сохраните его в надёжном месте.

Один ключ работает сразу со всеми ботами, к которым у вас есть доступ — агент сам выбирает нужного бота в разговоре (спрашивает вас, если ботов несколько), отдельно подключать каждого бота не нужно.

***

## Как подключить агента

MCP-сервер Graspil работает по протоколу **Streamable HTTP** — большинство современных AI-клиентов (Claude Desktop, Claude Code и т. д.) поддерживают такое подключение как «удалённый MCP-сервер» по URL.

Адрес сервера: `https://mcp.graspil.com/mcp`

Общий вид настройки для клиентов, поддерживающих MCP-серверы через URL и заголовки:

{% code overflow="wrap" %}

```json
{
  "mcpServers": {
    "graspil": {
      "url": "https://mcp.graspil.com/mcp",
      "headers": {
        "Api-Key": "YOUR_API_KEY"
      }
    }
  }
}
```

{% endcode %}

Точные шаги отличаются в зависимости от клиента:

* **Claude Desktop / Claude Code** — добавьте сервер в настройках интеграций (Settings → Connectors / MCP servers), указав URL и заголовок `Api-Key`.
* **Другие MCP-совместимые клиенты** — используйте аналогичный механизм добавления удалённого MCP-сервера по URL с кастомным заголовком авторизации.

После подключения агент сам запросит список доступных ботов (если их несколько) и уточнит, с каким из них работать в рамках разговора.

***

## Частые вопросы

**Может ли агент видеть данные других пользователей?**\
Нет. Агент действует строго в рамках прав вашего API-ключа — видит только тех ботов и те данные, к которым у ключа есть доступ.

**Можно ли ограничить, что агент может делать?**\
Да. Как и для обычного API-ключа, можно ограничить доступ по ботам и выдать права «только просмотр» для отдельных разделов (например, разрешить агенту смотреть отчёты, но не создавать рассылки) — настраивается при создании или редактировании ключа в разделе «API-ключи».

**Что если я отзову ключ?**\
Агент сразу потеряет доступ — MCP-сервер не хранит собственных данных и не кэширует права надолго, все проверки идут через тот же ключ при каждом запросе.

**Нужно ли что-то дополнительно устанавливать?**\
Нет, сервер уже развёрнут и обслуживается на стороне Graspil — нужен только сам API-ключ и MCP-совместимый клиент.