Подключение AI‑агента через MCP

Adsafee можно подключить к AI‑ассистенту (например, Claude Code) по протоколу MCP (Model Context Protocol). После подключения агент сможет на естественном языке смотреть вашу статистику и управлять кабинетом — строго в рамках ваших прав доступа.

Спрашивайте на обычном языке, например:

• «Покажи вчерашний невалидный трафик по странам.»
• «У какой из моих интеграций больше всего фрода за неделю?»
• «Заведи правило, которое блокирует трафик с хостинг‑провайдеров.»
• «Настрой еженедельный отчёт о трафике на почту.»

Что такое MCP

MCP — открытый стандарт, по которому AI‑ассистенты подключаются к внешним сервисам. Adsafee поднимает MCP‑сервер по адресу https://dashboard.adsafee.com/mcp; вы подключаетесь один раз через обычный вход в браузере — копировать токены или вставлять ключи не нужно.

Подключение

Adsafee работает с любым AI‑клиентом, поддерживающим MCP. Адрес сервера везде один:

https://dashboard.adsafee.com/mcp

При первом обращении клиент откроет браузер: вход в Adsafee (тот же логин, что и в дашборде — email или Google) → экран согласия «Разрешить клиенту действовать от вашего имени?» → Approve. Дальше выдаётся токен на 90 дней, повторный вход не нужен.

Claude Code (CLI)

claude mcp add --scope user --transport http adsafee https://dashboard.adsafee.com/mcp

--scope user делает сервер доступным во всех проектах. Без него claude mcp add прописывает сервер только в текущий проект (scope по умолчанию — local). Проверить: claude mcp list.

Claude Desktop

Настройки → Connectors → Add custom connector, вставьте URL https://dashboard.adsafee.com/mcp (доступно на платных тарифах Claude). При первом запуске пройдите вход через браузер.

Cursor

Добавьте сервер в ~/.cursor/mcp.json (глобально) или .cursor/mcp.json (в проекте):

{
  "mcpServers": {
    "adsafee": {
      "url": "https://dashboard.adsafee.com/mcp"
    }
  }
}

Затем в Settings → MCP нажмите вход рядом с сервером, чтобы авторизоваться.

VS Code (GitHub Copilot, режим Agent)

Для всех проектов выполните команду MCP: Open User Configuration (палитра команд) и добавьте сервер в пользовательский mcp.json; для одного проекта — в .vscode/mcp.json. Формат одинаковый:

{
  "servers": {
    "adsafee": {
      "type": "http",
      "url": "https://dashboard.adsafee.com/mcp"
    }
  }
}

Откройте Copilot Chat в режиме Agent — при первом обращении подтвердите вход.

Другие клиенты

Любой клиент с поддержкой MCP‑серверов (Windsurf, Zed и др.) подключается так же: укажите адрес https://dashboard.adsafee.com/mcp и войдите через браузер при первом обращении.

TIP

Названия пунктов меню зависят от версии клиента — сверяйтесь с его документацией по MCP. Неизменны только адрес сервера и вход через браузер.

Что умеет агент

Агент действует от вашего имени и с вашей ролью — он не получает больше прав, чем есть у вас в дашборде.

Чтение (аналитика):

• Смотреть статистику трафика и фрода — метрики, разрезы, готовые пресеты.
• Перечислять доступные рабочие пространства, интеграции, правила, отчёты.

Изменения — в два шага:

• План — агент сначала готовит изменение и показывает, что именно произойдёт. Ничего не меняется.
• Применение — изменение выполняется только после того, как план явно применён.

Возможность	Owner	Analyst
Чтение статистики и каталогов	✓	✓ (в рамках своих интеграций)
Изменения (правила, отчёты, интеграции, команда…)	✓	—

Несколько рабочих пространств

Если вы состоите в нескольких пространствах, агент попросит уточнить, в каком работать. Если пространство одно — оно подставляется автоматически.

Изменения и подписка

Изменения доступны только владельцу (Owner) и только при активной подписке, разрешающей запись. Необратимые действия (например, удаление) требуют отдельного подтверждения в плане.

Безопасность и отзыв доступа

• Вход — через браузер, как в дашборд: Adsafee никогда не просит копировать токен или вставлять ключ.
• Права пересчитываются на каждый запрос: смена роли, ограничение по интеграциям или окончание подписки сразу влияют на то, что агент может сделать.
• Доступ живёт 90 дней и может быть отозван в любой момент; по истечении вы просто заново проходите вход.
• Отключить на стороне клиента: claude mcp remove adsafee.

Что дальше

• Справочник метрик — что означают показатели, которые вернёт агент
• Команда и доступ — роли Owner/Analyst и ограничение по интеграциям
• Правила фильтрации — что агент может настраивать