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

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

Twilio Segment + Gemini

Дайте ИИ работать с вашим рабочим пространством Twilio Segment: выводить списки источников, destinations и хранилищ, проверять объём событий, доставку и синхронизацию хранилищ, читать планы трекинга, Functions, данные об использовании и журнал аудита. Рабочие пространства в США и ЕС.

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

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

SEGMENT_API_HOST, SEGMENT_API_TOKEN

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

1. Как Workspace Owner откройте Settings → Workspace settings → Access Management → Tokens (https://app.segment.com/goto-my-workspace/settings/access-management/tokens) и нажмите Create Token.
2. Выберите токен Public API, а не токен Config API. Дайте ему минимальную роль, которой хватает для ваших задач: Workspace Member с ролями только для чтения (например, Source Read-only и Tracking Plan Read-only) для чтения, Workspace Owner только если инструменты записи будут включены.
3. Segment показывает токен один раз: сразу скопируйте его в SEGMENT_API_TOKEN. Он передаётся как Bearer-токен и только в Segment.
4. Укажите в SEGMENT_API_HOST регион рабочего пространства: https://api.segmentapis.com для пространства в США, https://eu1.api.segmentapis.com для пространства в ЕС. Токен работает только в своём регионе.
5. Установите коннектор и запустите segment_get_workspace, чтобы проверить подключение. Токен принадлежит одному рабочему пространству, поэтому ставьте по одному коннектору на каждое пространство.

Что он читает: источники (sources), destinations с их маппингами Actions, хранилища (warehouses) с состоянием подключения и последними синхронизациями, объём событий во времени, Delivery Overview (где теряются события, шаг за шагом, с причинами), метрики доставки по каждому destination, планы трекинга и их правила (Protocols), Functions с их кодом, ежедневное использование по вызовам API и MTU, а также Audit Trail с тем, кто что изменил. Для планов трекинга нужен Protocols, для Functions нужна функция Functions, для маппингов нужны Destination Subscriptions в рабочем пространстве.

Секреты: поля настроек, в которых обычно хранятся учётные данные destinations и хранилищ (ключи API, секреты, токены, пароли), не выводятся. Но segment_get_source возвращает write keys источника, с которыми кто угодно может отправлять данные в этот источник.

Лимиты: Segment ограничивает запросы по токену, IP-адресу и эндпоинту и отвечает 429 с заголовком Retry-After. Некоторые эндпоинты строже: синхронизации хранилищ допускают 2 вызова в минуту, объём событий 60 в минуту, правила планов трекинга и состояние подключения хранилищ 200 в минуту. Списки приходят страницами до 1 000 элементов, и ИИ идёт по pagination.next, пока не получит всё.

Отключены при установке: segment_update_source и segment_update_destination переименовывают источник или destination либо включают и выключают его, а выключенный отбрасывает данные, пока его снова не включат. segment_delete_source и segment_delete_destination нельзя отменить. Администратор включает эти инструменты осознанно, и даже тогда ИИ сначала подтверждает у вас каждое изменение; удаление ждёт, пока вы не подтвердите id и название.

Частые ошибки: 403 "Not authorized to perform this operation": токен неверный или отозван, относится к рабочему пространству в другом регионе, является токеном Config API, или его роль не охватывает этот ресурс. 401: токен не был отправлен. 404: в этом рабочем пространстве нет ресурса с таким id. 422: параметр отсутствует или недействителен, например период для Delivery Overview длиннее, чем позволяет гранулярность. Сообщение о функции означает, что в рабочем пространстве нет Protocols, Functions или Destination Subscriptions. 429: подождите время, указанное в Retry-After.

Коннектор не отправляет события: Tracking API Segment использует write key источника на другом хосте. Он также не создаёт источники, destinations и хранилища и не охватывает фильтры, трансформации, Reverse ETL, аудитории и computed traits Engage, управление доступом, правила удаления и подавления данных и каталог.

Шаг 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 теперь может вызывать инструменты Twilio Segment.

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

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

• «Какие из наших destinations отключены и из каких источников они читают?»
• «Покажи Delivery Overview нашего источника iOS за последние 24 часа и где были отброшены события.»
• «Как менялся объём событий по источникам за последние 7 дней и сколько MTU мы уже использовали в этом месяце?»
• «Кто менял источники или destinations за последние две недели, судя по журналу аудита?»

FAQ

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

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

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