Tidio

oficial

Conecta Tidio con tu sitio web a través de MCP. Inserta el widget sin salir de tu entorno de

Ver en tid.io

¿Qué puedes hacer con Tidio MCP?

  • Autentica y conecta tu cuenta de Tidio — ejecuta tidio_connect con la URL de tu sitio para iniciar sesión a través del navegador y recuperar automáticamente tu clave pública.
  • Verifica el estado de la conexión y obtén el código de inserción — usa tidio_status para confirmar que estás conectado y recuperar el fragmento de JavaScript para tu sitio.
  • Genera el código de inserción con una clave existente — llama a generate_tidio_embed con tu clave pública para producir el código del widget de chat, eligiendo opcionalmente carga asíncrona o síncrona.
  • Desconecta y borra las credenciales almacenadas — invoca tidio_disconnect para eliminar los tokens guardados y la clave pública del almacenamiento local.

Documentación

Conector Tidio MCP

Un servidor MCP (Protocolo de Contexto de Modelo) que conecta asistentes de IA al chat en vivo de Tidio - con configuración automática

Características

  • Configuración Automática: Conéctate a Tidio con un solo comando - sin copiar claves manualmente
  • Autenticación OAuth: Abre el navegador para un inicio de sesión seguro en Tidio, recupera automáticamente tu clave pública
  • Persistencia de Credenciales: Las credenciales se guardan localmente para futuras sesiones
  • Generación de Código Embebido: Obtén código JavaScript listo para usar en cualquier sitio web

Instalación

npm install tidio-mcp-connector

O clona y construye localmente:

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

Uso

Con Claude Desktop

Agrega a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Con Lovable

Este conector MCP funciona con Lovable y plataformas de desarrollo similares impulsadas por IA. Agrégalo como un servidor MCP personalizado.

Con MCP Inspector (Pruebas)

npx @modelcontextprotocol/inspector npx tidio-mcp-connector

Herramientas Disponibles

tidio_connect (Recomendado)

Conéctate a Tidio y obtén automáticamente tu clave pública.

Cómo funciona:

  1. Abre tu navegador en la página de inicio de sesión de Tidio
  2. Te autenticas con tu cuenta de Tidio
  3. Devuelve tu clave pública y código embebido automáticamente

Parámetros:

  • site_url (requerido): La URL del sitio web donde se embeberá Tidio

Ejemplo:

Connect Tidio to https://mywebsite.com

tidio_status

Verifica el estado de tu conexión y obtén tu código embebido.

Parámetros: Ninguno

tidio_disconnect

Limpia las credenciales almacenadas.

generate_tidio_embed

Genera código embebido para una clave pública específica (si ya tienes una).

Parámetros:

  • public_key (requerido): Tu clave pública de Tidio
  • loading_mode (opcional): "async" (predeterminado) o "sync"

Cómo Funciona

  1. El usuario llama a tidio_connect con la URL de su sitio web
  2. Se abre el navegador en la página de autenticación de Tidio
  3. El usuario inicia sesión en su cuenta de Tidio
  4. Se recibe el callback - el servidor MCP obtiene el token de actualización
  5. Se realizan llamadas a la API - intercambia el token por un token de acceso, luego recupera la clave pública
  6. Credenciales guardadas en ~/.tidio-mcp/credentials.json
  7. Código embebido devuelto - listo para agregar al sitio web

Almacenamiento de Credenciales

Las credenciales se almacenan localmente en ~/.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" }

Salida del Código Embebido

El conector genera código de carga asíncrona optimizado:

Desarrollo

Instalar dependencias

npm install

Ejecutar en modo desarrollo

npm run dev

Construir para producción

npm run build

Ejecutar versión construida

npm start

Requisitos

  • Node.js 18+
  • Una cuenta de Tidio (el nivel gratuito funciona)

Licencia

MIT

Relacionado

  • Tidio - Plataforma de chat en vivo y chatbot
  • Model Context Protocol - Estándar abierto para integraciones de IA
  • Lovable - Desarrollo de aplicaciones impulsado por IA