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

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

Tamara + ChatGPT

Tamara, «купи сейчас, плати потом» (Саудовская Аравия, ОАЭ, Кувейт, Бахрейн, Оман): поиск заказов по вашему номеру заказа или ID Tamara со статусом и суммами списаний, возвратов и выплат, проверка способов оплаты и допуска клиента. Списание и возврат включены, но отключены при установке.

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

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

TAMARA_API_URL, TAMARA_API_TOKEN

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

Настройка занимает около 2 минут. Нужен аккаунт продавца Tamara и его API-токен.

1. Войдите в Tamara Partners Portal и откройте API Token Management или используйте API-токен, который Tamara прислала вместе с аккаунтом продавца. У песочницы и продакшена разные токены.
2. Вставьте токен в TAMARA_API_TOKEN без "Bearer" и пробелов. Он передаётся как Authorization: Bearer <token>. Токен уведомлений и публичный ключ здесь не используются.
3. Укажите в TAMARA_API_URL https://api.tamara.co для продакшена или https://api-sandbox.tamara.co для песочницы. Адрес должен соответствовать токену.
4. Установите коннектор и запустите tamara_list_payment_types: он покажет способы оплаты, которые предлагает ваш магазин, и подтвердит токен.

Ваш номер заказа или ID Tamara: order_reference_id — ваш собственный номер заказа, переданный при оформлении, например номер заказа магазина; order_id — UUID, выданный Tamara. Большинство вопросов начинается с вашего номера заказа и tamara_get_order_by_reference.

Что он читает: заказ по вашему номеру или по ID заказа Tamara со статусом, способом оплаты и числом платежей, клиентом, адресами, позициями, итоговой суммой, суммами списаний, возвратов, отмен и оплат, статусом и датой выплаты, а также его транзакциями (списания, возвраты и отмены); способы оплаты, доступные в стране (например, PAY_BY_INSTALMENTS или PAY_NOW), с минимальной и максимальной суммой заказа и допустимым числом платежей, при желании только подходящие для суммы; до оформления — какие варианты оплаты доступны конкретному клиенту для суммы и считает ли Tamara сейчас клиента допущенным (по телефону, e-mail или обоим); и зарегистрированный вебхук с URL, событиями и заголовками.

Статус заказа: new, approved, authorised, затем partially_captured или fully_captured и partially_refunded или fully_refunded; canceled, declined и expired — окончательные. paid_amount — сколько клиент уже заплатил; settlement_status и settlement_date показывают, выплатила ли Tamara вам деньги.

Отключено при установке: tamara_capture_order (полностью или частично списывает авторизованный заказ при отправке, чтобы Tamara его выплатила) и tamara_refund_order (полностью или частично возвращает списанный заказ; деньги уходят клиенту, и вернуть их нельзя). Оба двигают деньги, поэтому администратор включает их осознанно. Даже тогда ИИ показывает вам заказ, сумму и валюту и ждёт вашего «да».

Суммы и время: суммы — объекты с amount и currency; у SAR и AED 2 знака после запятой, у BHD, KWD и OMR 3. Время в UTC, ISO 8601.

Ограничения: у Tamara нет эндпоинта для списка или поиска заказов, поэтому ИИ ищет заказы по вашему номеру заказа или по ID Tamara.

Частые ошибки: 401 означает неверный токен или токен другой среды (песочница или продакшен). 404 по заказу означает, что в этой среде нет заказа с таким номером или ID. 400 или 422 при списании или возврате называют поле, которое отклонила Tamara, например сумму больше доступной для списания. 403 означает, что токен работает, но не может использовать этот API; попросите Tamara включить его для вашего аккаунта продавца.

Коннектор не создаёт сессии оформления заказа, не авторизует и не отменяет заказы, не использует claims API и не загружает отчёты о выплатах.

Шаг 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 — Добавьте коннектор в ChatGPT

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

ChatGPT добавляет MCP-серверы как плагины на странице Plugins, в веб-версии и в платных планах. Режим разработчика для этого больше не нужен. В рабочем пространстве Business это могут только администраторы и владельцы; в Enterprise и Edu администратор может выдать право Create plugins with MCPs.

1. Перейди на chatgpt.com/plugins, нажми Add, затем Add custom MCP server.
2. Введи название, например Name: Tamara.
3. В разделе Connection укажи в поле Server URL адрес https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID и оставь Authentication на OAuth.
4. Выбери I understand and want to continue, затем Create as a plugin. Когда ChatGPT попросит, войди в AnythingMCP и разреши доступ.
5. Установи новый плагин из своих личных плагинов, затем введи @ в чате и выбери его.

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

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

• «Какой статус у нашего заказа 100245 в Tamara и выплатила ли его нам уже Tamara?»
• «Какая часть заказа 100245 уже списана, возвращена и оплачена клиентом?»
• «Какие способы оплаты Tamara наш магазин предлагает в Саудовской Аравии для заказа на 1 200 SAR?»
• «Может ли клиент с номером телефона +966501234567 оплатить 800 SAR через Tamara?»
• «Заказ 100245 отправлен: спишите его полностью. Сначала покажите заказ и сумму.»

FAQ

Работает ли бесплатный план ChatGPT со своими MCP-серверами? OpenAI описывает свои MCP-серверы только для платных планов; план Free в этом списке не указан.

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

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