Tidio MCP Server

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

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