Как подключить Amplitude к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Amplitude, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Amplitude + Gemini

Дайте ИИ читать продуктовую аналитику Amplitude: динамику событий, воронки, удержание, активных и новых пользователей, LTV по выручке, сессии, сохранённые графики, когорты, поиск пользователей и план трекинга, а также добавлять аннотации на графики. Дата-центры в США и ЕС.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

AMPLITUDE_API_HOST, AMPLITUDE_API_KEY, AMPLITUDE_SECRET_KEY

Шаг 1 — Получите учётные данные

1. Вам нужна роль Manager или Admin в проекте Amplitude. Выберите Settings (слева внизу), затем Projects, и откройте проект. У каждого проекта свои ключи, поэтому один коннектор читает один проект.
2. На вкладке General проекта выберите Manage рядом с API Key и скопируйте ключ в AMPLITUDE_API_KEY.
3. Выберите Manage рядом с Secret Key и создайте новый секретный ключ для AnythingMCP. Amplitude показывает секретный ключ только один раз, при создании, поэтому сразу вставьте его в AMPLITUDE_SECRET_KEY. У проекта может быть несколько секретных ключей.
4. Укажите в AMPLITUDE_API_HOST дата-центр проекта: https://amplitude.com для дата-центра по умолчанию (США), https://analytics.eu.amplitude.com для проекта в ЕС (его приложение работает на app.eu.amplitude.com). Ключи проекта из ЕС отклоняются на хосте США, и наоборот. analytics.amplitude.com является веб-приложением, а не API.
5. Установите коннектор и запустите amplitude_list_events, чтобы увидеть точные названия событий, которые записывает проект.

Кто что видит: секретный ключ читает все события и всех пользователей проекта. Делитесь MCP-сервером только с теми, кому разрешено видеть эти данные.

Что он читает: динамику событий с фильтрами и группировками, воронки, удержание, активных и новых пользователей (в том числе в реальном времени, с шагом 5 минут), LTV по выручке, длительность сессий и число сессий на пользователя, состав пользователей, результаты графиков, сохранённых в Amplitude (по id после /chart/ в адресе графика), поведенческие когорты, поиск пользователей с их последними событиями и план трекинга (типы событий, свойства событий и пользователей, категории). Даты указываются целыми днями в часовом поясе проекта. Для списка когорт нужно дополнение Behavioral Cohorts на плане Growth или Enterprise.

Лимиты: лимиты Amplitude действуют на проект и общие для всех интеграций. Dashboard REST API выполняет не больше 5 запросов одновременно, а бюджет стоимости запросов составляет 1 000 за 5 минут и 108 000 в час. Стоимость запроса равна числу дней в периоде, умноженному на число условий (сегменты и фильтры; каждая группировка считается за 4) и на стоимость графика (сегментация 1 за событие, воронки 2 за шаг, удержание 8, сессии 4, всё остальное 1). У поиска пользователей и активности пользователя свой лимит: 10 одновременно и 360 в час, а план трекинга допускает 7 200 чтений в час. При превышении лимита Amplitude отвечает 429: ИИ ждёт, а если дело в бюджете стоимости, сокращает период или убирает группировки. Один запрос с группировкой заменяет множество запросов по дням или по пользователям.

Персональные данные: amplitude_search_users и amplitude_get_user_activity возвращают профиль и события пользователя. ИИ использует их для того пользователя, о котором вы спрашиваете.

Сначала подтверждение: аннотация без привязки к графику видна на всех графиках проекта всем участникам, поэтому перед amplitude_create_annotation ИИ подтверждает у вас подпись, время и охват. amplitude_delete_annotation при установке отключён.

Частые ошибки: 403 "Invalid API Key": ключ или секрет неверны, относятся к другому проекту, или проект находится в другом дата-центре (проверьте AMPLITUDE_API_HOST). 401: не хватает одного из двух ключей. 400: параметр или JSON события или сегмента недействителен, или сохранённый график относится к другому проекту. 404 в amplitude_get_chart_results: сохранённого графика с таким id нет. 429: достигнут лимит одновременных запросов, часовой лимит или лимит стоимости, и Amplitude сообщает, какой именно.

Коннектор не отправляет события в Amplitude, не выгружает файлы с сырыми событиями, не скачивает и не загружает когорты, не удаляет пользователей по запросам о персональных данных и не охватывает Experiment, Session Replay и управление пользователями.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Amplitude.

Доступные инструменты

Примеры запросов

• «Сколько пользователей выполняли Sign Up каждую неделю за последние три месяца, с группировкой по странам?»
• «Покажи воронку от Sign Up через Create Project до Invite Teammate за сентябрь и шаг, на котором отваливается больше всего пользователей.»
• «Сколько новых пользователей, пришедших в августе, вернулись в каждую из следующих восьми недель?»
• «Добавь на все графики аннотацию о перезапуске страницы с ценами 1 октября и покажи подпись и дату, прежде чем сохранять.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT