Tidio

официальный

Подключите Tidio к вашему сайту через MCP. Встраивайте виджет, не выходя из среды разработки.

Что можно делать с Tidio MCP?

  • Подключение Tidio к сайту — Запросите подключение Tidio к URL-адресу веб-сайта через tidio_connect, который открывает браузер для входа через OAuth и автоматически получает ваш публичный ключ.
  • Проверка статуса подключения — Используйте для проверки, подключен ли Tidio, и получения текущего кода встраивания.
  • Генерация кода встраивания — Вызовите с публичным ключом для создания готового к использованию JavaScript, при желании выбрав асинхронную (async) или синхронную (sync) загрузку.
  • Отключение Tidio — Запустите для очистки локально сохраненных учетных данных из ~/.tidio-mcp/credentials.json.

Документация

MCP-коннектор Tidio

MCP-сервер (Model Context Protocol), который подключает AI-ассистентов к живому чату Tidio — с автоматической настройкой

Возможности

  • Автоматическая настройка: Подключение к Tidio одной командой — без ручного копирования ключей
  • OAuth-аутентификация: Открывает браузер для безопасного входа в Tidio и автоматически получает ваш публичный ключ
  • Сохранение учетных данных: Учетные данные сохраняются локально для будущих сессий
  • Генерация кода встраивания: Получите готовый к использованию JavaScript-код для любого сайта

Установка

npm install tidio-mcp-connector

Или клонируйте репозиторий и соберите локально:

git clone https://github.com/your-username/tidio-mcp-connector.git
cd tidio-mcp-connector
npm install
npm run build

Использование

С Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tidio": {
      "command": "npx",
      "args": ["tidio-mcp-connector"]
    }
  }
}

С Lovable

Этот MCP-коннектор работает с Lovable и аналогичными AI-платформами разработки. Добавьте его как пользовательский MCP-сервер.

С MCP Inspector (тестирование)

npx @modelcontextprotocol/inspector npx tidio-mcp-connector

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

tidio_connect (рекомендуется)

Подключение к Tidio и автоматическое получение вашего публичного ключа.

Как это работает:

  1. Открывает ваш браузер на странице входа в Tidio
  2. Вы проходите аутентификацию с помощью своей учетной записи Tidio
  3. Автоматически возвращает ваш публичный ключ и код встраивания

Параметры:

  • site_url (обязательный): URL-адрес сайта, на который будет встроен Tidio

Пример:

Connect Tidio to https://mywebsite.com

tidio_status

Проверка статуса подключения и получение кода встраивания.

Параметры: нет

tidio_disconnect

Очистка сохраненных учетных данных.

Параметры: нет

generate_tidio_embed

Генерация кода встраивания для конкретного публичного ключа (если он у вас уже есть).

Параметры:

  • public_key (обязательный): ваш публичный ключ Tidio
  • loading_mode (необязательный): "async" (по умолчанию) или "sync"

Как это работает

  1. Пользователь вызывает tidio_connect с URL-адресом своего сайта
  2. Открывается браузер на странице аутентификации Tidio
  3. Пользователь входит в свою учетную запись Tidio
  4. Получен обратный вызов — MCP-сервер получает токен обновления
  5. Выполняются API-запросы — токен обменивается на токен доступа, затем извлекается публичный ключ
  6. Учетные данные сохраняются в ~/.tidio-mcp/credentials.json
  7. Возвращается код встраивания — готов к добавлению на сайт

Хранение учетных данных

Учетные данные хранятся локально по адресу ~/.tidio-mcp/credentials.json:

{
  "public_key": "abc123...",
  "access_token": "...",
  "refresh_token": "...",
  "site_url": "https://example.com",
  "created_at": "2024-01-01T00:00:00.000Z",
  "updated_at": "2024-01-01T00:00:00.000Z"
}

Вывод кода встраивания

Коннектор генерирует оптимизированный код асинхронной загрузки:

<script type="text/javascript">
document.tidioChatCode = "YOUR_PUBLIC_KEY";
(function() {
  function asyncLoad() {
    var tidioScript = document.createElement("script");
    tidioScript.type = "text/javascript";
    tidioScript.async = true;
    tidioScript.src = "//code.tidio.co/YOUR_PUBLIC_KEY.js";
    document.body.appendChild(tidioScript);
  }
  if (window.attachEvent) {
    window.attachEvent("onload", asyncLoad);
  } else {
    window.addEventListener("load", asyncLoad, false);
  }
})();
</script>

Разработка

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run built version
npm start