Справочный центр › ИИ и API

Claude, ChatGPT и API

Спрашивайте о данных прямо в Claude, ChatGPT, Copilot или Cursor или читайте их из скриптов и BI-инструментов — всегда только чтение и одно пространство.

MCP: Claude, ChatGPT и другие приложения

На странице ИИ и API указан Адрес MCP-сервера вашего пространства — он заканчивается на /mcp.

  • claude.ai или Claude Desktop: Settings → Connectors → Add custom connector, вставьте адрес, затем войдите в Megametrics и разрешите доступ.
  • ChatGPT: в настройках добавьте свой коннектор (MCP) с этим адресом, затем войдите и разрешите доступ.
  • Claude Code: выполните команду со страницы:
claude mcp add --transport http megametrics https://<ваш адрес>/mcp
  • Copilot, Cursor и другие: тот же адрес и ключ API в заголовке Authorization: Bearer <ключ>.

Когда приложение подключается, вы видите, что оно просит, и выбираете пространство, которое ему можно читать. Оно видит проекты, их источники и загруженные данные, читает отчёты и делает запросы только на чтение. Менять данные, настройки, команду и оплату оно не может. Подключённые приложения на странице ИИ и API перечисляют их, Отозвать сразу закрывает доступ.

Что приложения умеют по MCP: перечислить проекты, описать данные, прочитать обзор, сделать срез как в «Запросах», выполнить SQL-запрос только на чтение, перечислить сигналы и показать путь человека к конверсии — касания с долями, без почты и телефона. Каждый ответ приходит с SQL, которым получены его строки.

Ключи API

Ключи API на странице ИИ и API — для скриптов, BI-инструментов и MCP-клиентов без входа. Ключ читает одно пространство от имени того, кто его создал, и ничего не меняет. Назовите его, нажмите Создать ключ и сразу скопируйте — он показывается один раз и хранится только хэшем. Отозвать сразу его останавливает. Когда человек уходит из пространства, его ключи перестают действовать.

Ключами управляют только владелец и администраторы.

API запросов

Те же данные, что в «Запросах», по HTTPS с ключом:

  • GET /api/projects — проекты пространства;
  • POST /api/projects/<проект>/explore — любой срез в JSON вместе с SQL, которым он получен;
  • POST /api/projects/<проект>/explore/download — тот же срез файлом CSV или Excel.
curl -H "Authorization: Bearer $MEGAMETRICS_KEY" https://<ваш адрес>/api/projects

Формат запроса — тот же, что «Запросы» пишут в адрес страницы и в сохранённые запросы. Запрос к набору attribution ещё содержит модель, окно и дату учёта, см. «Атрибуция и пути покупателей». Запрос возвращает первые 1000 строк; добавьте "full": true, чтобы получить до 100 000. В каталоге данных у каждой метрики указано, можно ли складывать её по строкам (additive), — это нужно BI-инструментам, которые не должны складывать отношения.

Много выгрузок сразу

Агентству часто нужен один и тот же отчёт для каждого клиента. Создайте ключ с отметкой Может ещё создавать и менять выгрузки — такой ключ ещё создаёт и меняет сохранённые запросы и выгрузки, а аккаунты, команду и оплату по-прежнему не трогает. Он никогда не может больше, чем сейчас может тот, кто его создал: потерял человек роль — теряет право и ключ.

  • POST /api/bulk/exports — до 100 выгрузок одним вызовом. В каждой строке — проект, запрос (name и spec), куда отправлять с настройками и, если нужно, расписание. Каждая строка сама по себе: ответ скажет, какие выгрузки созданы и почему не созданы остальные.
  • PATCH /api/bulk/exports — пауза, возобновление, новое расписание или удаление до 200 выгрузок сразу. Сначала проверяются все: если хоть одна недоступна, не меняется ничего.
curl -X POST -H "Authorization: Bearer $MEGAMETRICS_KEY" -H "Content-Type: application/json" \
  -d '{"items": [{"project": "rawai-shore", "name": "Расход за неделю", "destination": "email",
       "spec": {"dataset": "ads", "metrics": ["cost"], "dimensions": ["campaign"], "range": {"preset": "last_7_days"}},
       "config": {"recipients": ["client@example.com"]},
       "schedule": {"frequency": "weekly", "weekday": 1, "minute_of_day": 540, "timezone": "Europe/Moscow"}}]}' \
  https://<ваш адрес>/api/bulk/exports

События со своего сервера

Ключ с отметкой Может ещё отправлять события присылает в проект заявки и оплаты с вашего сервера, из CRM или страницы оплаты. Больше он ничего не меняет и, как право на выгрузки, никогда не может больше, чем сейчас может тот, кто его создал. Читает он, как любой ключ, все данные пространства: отдавайте его сервису форм или CRM, только если им доверяете.

  • POST /api/projects/<проект>/events — одно событие. event_name обязательно; mm_token, email, phone или external_id говорят, чьё оно; order_id или idempotency_key не дают повтору засчитаться дважды. Ответ — {"id": "…", "duplicate": false}.
curl -X POST -H "Authorization: Bearer $MEGAMETRICS_KEY" -H "Content-Type: application/json" \
  -d '{"event_name": "Lead", "email": "anna@example.com", "idempotency_key": "form-8812"}' \
  https://<ваш адрес>/api/projects/<проект>/events

Почту и телефон, присланные как есть, сервер сразу превращает в хэш и нигде не хранит. Все поля, токен посетителя с сайта и вебхуки Stripe и Shopify — в статье «Код на сайте и события».

Дальше: Команда и безопасность

Не нашли ответ?

Напишите нам — ответит человек в течение рабочего дня.