Выгрузка данных аналитики nana800 через MCP-сервер

Что умеет MCP-сервер в аналитике

Для списков и выгрузки данных в сервере шесть инструментов.

• analytics_orgs_list: организации, в которых вы состоите.
• analytics_projects_list: проекты организации.
• analytics_event_types_list: названия событий проекта.
• analytics_export_create: запуск выгрузки событий проекта, событий одного пользователя или списка пользователей.
• analytics_export_status: статус выгрузки и ссылка на файл.
• analytics_exports_list: 20 последних выгрузок.

Строки событий сервер в ответ помощнику не кладёт, только статус и ссылку на файл. Ещё 15 инструментов строят графики и дашборды, о них отдельная инструкция про графики через ИИ. Остальные инструменты сервера относятся к схемам автоматизации nana800.

Как подключить

Нужен Node.js 18 или новее и личный API-ключ nana800: его можно создать или скопировать в настройках аккаунта на cloud.nana800.io/settings. Ключ действует от вашего имени, поэтому храните его только в настройках помощника, не в коде сайта. Для Claude Desktop добавьте сервер в файл claude_desktop_config.json и перезапустите приложение. В Cursor тот же блок кладётся в ~/.cursor/mcp.json.

{
  "mcpServers": {
    "nana800": {
      "command": "npx",
      "args": ["-y", "nana800-mcp-server"],
      "env": { "MCP_API_KEY": "ваш_личный_api_ключ" }
    }
  }
}

В Claude Code сервер подключается одной командой: claude mcp add nana800 -e MCP_API_KEY=ваш_ключ -- npx -y nana800-mcp-server. Аккаунт должен состоять в организации аналитики, данные которой вы хотите выгружать.

Как выглядит запрос

Помощнику достаточно написать задачу словами, например: «Выгрузи из проекта Лендинг события signup_completed за октябрь в CSV с точкой с запятой». Помощник найдёт организацию и проект, запустит выгрузку с фильтром по событию и периоду, дождётся готовности и пришлёт ссылку на файл.

В фильтре можно указать до 20 типов событий, условия на их свойства и отбор пользователей по свойствам и по совершённым событиям. Условия те же, что в кабинете: равно, не равно, содержит, не содержит, больше, меньше, задано, не задано. Время задаётся в формате ISO 8601 с часовым поясом.

Форматы и лимиты выгрузки

Выгрузка через MCP-сервер работает так же, как кнопка «Экспорт» в кабинете.

• CSV в UTF-8 с разделителем , или ; (точка с запятой удобна для Excel на русском) или JSON Lines, где каждая строка отдельный объект.
• До 1 000 000 строк в файле. Если строк больше, файл обрезается и помечается.
• Ссылка на файл живёт 15 минут, новую выдаёт повторный запрос статуса. Файл хранится 7 дней.
• В организации одна выгрузка за раз и до 10 в час. Выгрузки, запущенные по API-ключу, в том числе через MCP-сервер, не чаще раза в 10 минут.
• Файл отдаётся сжатым: браузер сохранит обычный файл, а из командной строки скачивайте curl --compressed.

Для чего это удобно

Выгрузка через помощника экономит время, когда данные нужны в таблице или в другом инструменте. Например, раз в неделю сводить регистрации по источникам в Google Таблицах, отдать список пользователей с нужным свойством в отдел продаж или проверить сырые события, если цифра на графике вызывает вопросы. Сам анализ файла помощник может сделать после скачивания.