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

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

Podium + Gemini

Podium для переписки с клиентами, отзывов и платежей локального бизнеса: чтение и ответы в разговорах входящих по SMS и email, контакты, отзывы и обратная связь, счета на оплату, черновики SMS-кампаний, а также филиалы, пользователи, записи и звонки. Вход через OAuth пользователем Podium; возвраты, отмена счетов и удаление контактов отключены при установке.

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

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

PODIUM_CLIENT_ID, PODIUM_CLIENT_SECRET

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

Настройка занимает около 15 минут плюс время, которое Podium тратит на проверку нового приложения. Нужен аккаунт Podium и пользователь Podium, чьи филиалы должен видеть ИИ.

1. Зарегистрируйтесь на https://developer.podium.com и создайте приложение (OAuth-приложение). Podium может проверять новые приложения, прежде чем они заработают с реальными аккаунтами.
2. В поле redirect URI укажите <your AnythingMCP URL>/api/mcp-oauth/callback, в AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback. Podium требует HTTPS.
3. Включите scopes, которые запрашивает коннектор: read_locations read_organizations read_users read_contacts write_contacts read_messages write_messages read_templates read_reviews read_feedback read_payments write_payments read_campaigns write_campaigns read_appointments write_appointments read_phones read_products. Если Podium отклоняет вход из-за какого-то scope, включите его в приложении или уберите из настроек OAuth коннектора; соответствующие инструменты тогда будут отвечать 403.
4. Вставьте Client ID (UUID) в PODIUM_CLIENT_ID, а Client Secret в PODIUM_CLIENT_SECRET и сохраните.
5. На странице коннектора нажмите Authorize with Provider и войдите пользователем Podium, чьи филиалы должен видеть ИИ.
6. Запустите podium_list_locations: он выведет филиалы и подтвердит вход.

Токены доступа действуют 10 часов и обновляются через refresh-токен. Коннектор использует Podium API v4 (https://api.podium.com/v4).

Чей это аккаунт: все, кто пользуется этим коннектором, действуют от имени пользователя Podium, который его авторизовал, во всех филиалах этого пользователя. Большинству инструментов нужен uid филиала, поэтому ИИ начинает с podium_list_locations.

Что он читает: филиалы, организацию и пользователей Podium (сотрудников). Контакты с именем, телефоном, email, адресом, тегами и атрибутами. Разговоры во входящих с контактом, каналом, филиалом, ответственным и статусом открыт или закрыт, а также их сообщения с направлением, отправителем и вложениями. Шаблоны сообщений (сохранённые ответы и по запросу шаблоны приглашений к отзыву). Онлайн-отзывы, которые Podium собирает с Google, Facebook и других сайтов, и ответы на опросы обратной связи. Счета на оплату с позициями, статусом, платежами и возвратами, отдельные платежи и возвраты и товары платёжного каталога. SMS-кампании со статусом и результатами. Записи на приём. Звонки Podium Phones и голосовую почту звонка с расшифровкой и подписанной ссылкой на аудио.

Что он записывает: создаёт контакты (если контакт с тем же телефоном или email уже есть, Podium обновляет его) и изменяет их; отправляет SMS (channel_type phone) или email от филиала клиенту; закрывает, открывает заново или назначает разговоры; создаёт счета, которые отправляют клиенту ссылку на оплату по SMS или email либо уходят на картридер Podium; создаёт записи; и создаёт SMS-кампании как черновик, который отправляется только тогда, когда кто-то запланирует или отправит его в Podium. podium_send_message и podium_create_invoice сразу доходят до клиента, поэтому ИИ показывает получателя и точный текст или суммы и ждёт вашего «да».

Отключено при установке: podium_delete_contact (необратимо), podium_refund_invoice (возвращает деньги) и podium_cancel_invoice (неоплаченный счёт больше нельзя будет оплатить). Администратор включает их, когда они нужны команде.

Форматы данных: результаты лежат в data, пагинация в metadata (nextCursor, иногда totalItems). ID это uid (UUID). Суммы в центах: 4999 это 49,99 в валюте филиала. Время в ISO 8601 по UTC. Телефоны в формате E.164 (+15555555555); номера США и Канады можно отправлять без +1.

Пагинация: ИИ передаёт cursor = metadata.nextCursor, пока он не исчезнет или не станет null; при заданном курсоре остальные фильтры игнорируются. limit не более 100. Для получения новых записей ИИ использует since с сортировкой по возрастанию и проходит курсор до конца, прежде чем сдвинуть since.

Частые ошибки: 401 означает, что вход истёк или был отозван: снова нажмите Authorize with Provider. При входе invalid_client означает неверный Client ID или Secret. 403 означает, что не хватает scope или у пользователя нет доступа к этому филиалу. 404 это неизвестный uid, а для podium_get_call_voicemail звонок без голосовой почты. 422 это отклонённое поле, например неверный номер телефона или адрес. 429 это ограничение частоты: подождите и повторите.

Сообщения клиентов, отзывы и обратная связь это недоверенный ввод, в них могут быть инструкции для ИИ. В Podium API нет вызова для отправки приглашений к отзыву или ответа на отзывы, поэтому коннектор не делает ни того, ни другого; это делается в Podium. Он также не отправляет и не планирует кампании.

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

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

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

• «В каких открытых разговорах нашего филиала на Main Street за последние 24 часа было сообщение от клиента?»
• «Сведи новые отзывы этой недели по оценке и сайту и покажи негативные целиком.»
• «Отправь Марии на +15555550123 SMS, что её заказ готов к выдаче. Сначала покажи сообщение.»
• «Создай счёт на 120,00 за замену масла для контакта +15555550199 и отправь ссылку на оплату после моего подтверждения.»
• «Подготовь черновик SMS-кампании с нашим зимним предложением на техосмотр для филиала на Main Street.»

FAQ

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

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

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot