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

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

Plivo + Gemini

Дайте ИИ работать с Plivo: проверять баланс и цены, отправлять SMS и MMS, совершать звонки и читать записи о звонках, завершать текущие звонки, просматривать аудиозаписи и расшифровки, находить и проверять номера телефонов, отправлять и проверять одноразовые коды через Verify.

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

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

PLIVO_AUTH_ID, PLIVO_AUTH_TOKEN

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

1. Войдите в консоль Plivo по адресу https://cx.plivo.com.
2. Скопируйте на странице обзора Auth ID (начинается с MA, у субаккаунта с SA) и Auth Token. Субаккаунт (Account → Subaccounts) ограничивает то, к чему получает доступ коннектор.
3. Вставьте их в PLIVO_AUTH_ID и PLIVO_AUTH_TOKEN и установите коннектор.
4. Проверьте настройку с помощью plivo_get_account: он показывает аккаунт, способ оплаты и остаток средств.

Пробного аккаунта достаточно для чтения; для отправки и звонков нужны средства на счёте, а на пробном аккаунте ещё и подтверждённые номера.

Кто что видит: Auth Token действует от имени всего аккаунта Plivo и может тратить его баланс. Делитесь MCP-сервером только с теми, кому разрешено тратить с него деньги. Журналы сообщений, записи о звонках, номера телефонов, аудиозаписи и расшифровки являются персональными данными, а ссылку на аудиозапись может воспроизвести любой, у кого она есть.

Стоит денег и доходит до реальных людей, поэтому ИИ сначала спрашивает: Plivo тарифицирует plivo_send_message (SMS и MMS, за каждую часть сообщения и каждого получателя), plivo_make_call (поминутно) и plivo_send_verification (за каждую верификацию плюс SMS или звонок). Перед каждым таким вызовом ИИ показывает отправителя, получателя и содержание, по вашей просьбе с ценой из plivo_get_pricing, и ждёт вашего «да». plivo_lookup_number оплачивается за каждый запрос, поэтому ИИ называет количество и стоимость, прежде чем проверять больше нескольких номеров.

Отключено при установке: plivo_buy_number, который арендует номер с платой за подключение и ежемесячной арендой, пока номер не освобождён; поиск через plivo_search_available_numbers бесплатный. plivo_hangup_call тоже выключен: он обрывает текущий звонок, а Plivo завершает все текущие звонки аккаунта, если id звонка не указан. Администратор включает их осознанно; после этого ИИ показывает номер с его стоимостью или звонок с номерами и временем начала и действует только после вашего подтверждения.

SMS: plivo_send_message возвращает message_uuid; plivo_get_message показывает статус доставки, оплаченные части и цену, а plivo_list_messages даёт обзор трафика (без текста сообщений). Отправитель в США или Канаде должен быть зарегистрирован для 10DLC или для отправки с бесплатных номеров (toll-free), иначе сообщения не доходят.

Для звонков нужен answer URL: plivo_make_call звонит на номер и, когда отвечают, запрашивает ваш answer_url, который должен возвращать Plivo XML с вашего сервера (например, <Response><Speak>Здравствуйте</Speak></Response>). Параметр time_limit ограничивает стоимость. Текущие звонки: plivo_list_live_calls и plivo_get_live_call. Завершённые звонки: plivo_list_calls и plivo_get_call, с длительностью, оплаченной длительностью, ценой и причиной завершения. Аудиозаписи: plivo_list_recordings, plivo_get_recording и plivo_get_transcription, если для записи заказана расшифровка (платная опция Plivo).

Verify: plivo_send_verification отправляет одноразовый код по SMS или голосовым звонком, plivo_validate_verification проверяет код, который ввёл человек (каждая попытка учитывается в лимите попыток), а plivo_get_verification показывает статус и списания.

Номера и время: передавайте номера в формате E.164 (+4915112345678); в списках Plivo показывает их без плюса. Фильтры по времени задаются в UTC в формате YYYY-MM-DD HH:MM:SS. Поиск звонков и аудиозаписей охватывает последние 7 дней, если вы не укажете период, и не больше 30 дней за один поиск.

Лимит запросов: 300 запросов за 5 секунд на аккаунт; для исходящих звонков действуют ещё лимит звонков в секунду и лимит одновременных звонков (403 Concurrency Limit Breached). Ответ 429 означает, что нужно подождать и повторить.

Частые ошибки: 401: неверный Auth ID или Auth Token, либо токен был перевыпущен. 403: субаккаунт без доступа или ограничение по IP в API access control. 404: такого сообщения, звонка, записи или номера в этом аккаунте нет. 400: параметр отсутствует или задан неверно, например формат номера или отправитель, который не принадлежит аккаунту. Отправка или звонок не проходят из-за низкого баланса: проверьте средства через plivo_get_account и пополните счёт в консоли.

Коннектор не охватывает шаблоны WhatsApp, конференции и звонки с несколькими участниками, перевод звонков и управление записью, applications и endpoints, субаккаунты, документы для комплаенса и освобождение номеров.

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

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

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

• «Какой у нас баланс в Plivo и сколько стоит исходящее SMS в Германию?»
• «Отправь SMS с нашего номера Plivo на +4915112345678 о том, что запись на пятницу на 10:00 подтверждена. Сначала покажи отправителя, получателя, текст и цену.»
• «Какие вчерашние сообщения не были доставлены или завершились ошибкой? Покажи коды ошибок и сколько они стоили.»
• «Покажи звонки за последние 7 дней длиннее пяти минут с оплаченной длительностью, ценой и причиной завершения.»
• «Отправь код подтверждения по SMS на +4915112345678 и спроси меня перед отправкой. Потом проверь код, который мне продиктует клиент.»

FAQ

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

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

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