Tidio

officiel

Connectez Tidio à votre site web via MCP. Intégrez le widget sans quitter votre environnement de programmation.

Que pouvez-vous faire avec Tidio MCP ?

  • Connecter Tidio à un site — Demandez de connecter Tidio à une URL de site via tidio_connect, ce qui ouvre un navigateur pour la connexion OAuth et récupère automatiquement votre clé publique.
  • Vérifier l’état de la connexion — Utilisez pour vérifier si Tidio est connecté et récupérer votre code d’intégration actuel.
  • Générer le code d’intégration — Appelez avec une clé publique pour produire du JavaScript prêt à l’emploi, en choisissant éventuellement le chargement async ou sync.
  • Déconnecter Tidio — Exécutez pour effacer les informations d’identification stockées localement dans ~/.tidio-mcp/credentials.json.

Documentation

Connecteur MCP Tidio

Un serveur MCP (Model Context Protocol) qui connecte les assistants IA au chat en direct Tidio - avec configuration automatique

Fonctionnalités

  • Configuration automatique : Connectez-vous à Tidio avec une seule commande - aucune copie manuelle de clé
  • Authentification OAuth : Ouvre le navigateur pour une connexion sécurisée à Tidio, récupère automatiquement votre clé publique
  • Persistance des identifiants : Les identifiants sont enregistrés localement pour les sessions futures
  • Génération de code d'intégration : Obtenez un code JavaScript prêt à l'emploi pour n'importe quel site web

Installation

npm install tidio-mcp-connector

Ou clonez et compilez localement :

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

Utilisation

Avec Claude Desktop

Ajoutez à votre configuration Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json) :

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

Avec Lovable

Ce connecteur MCP fonctionne avec Lovable et des plateformes de développement similaires propulsées par l'IA. Ajoutez-le comme serveur MCP personnalisé.

Avec MCP Inspector (Test)

npx @modelcontextprotocol/inspector npx tidio-mcp-connector

Outils disponibles

tidio_connect (Recommandé)

Connectez-vous à Tidio et obtenez automatiquement votre clé publique.

Comment cela fonctionne :

  1. Ouvre votre navigateur sur la page de connexion de Tidio
  2. Vous vous authentifiez avec votre compte Tidio
  3. Renvoie automatiquement votre clé publique et le code d'intégration

Paramètres :

  • site_url (obligatoire) : L'URL du site web où Tidio sera intégré

Exemple :

Connect Tidio to https://mywebsite.com

tidio_status

Vérifiez votre état de connexion et obtenez votre code d'intégration.

Paramètres : Aucun

tidio_disconnect

Effacez les identifiants stockés.

Paramètres : Aucun

generate_tidio_embed

Générez un code d'intégration pour une clé publique spécifique (si vous en possédez déjà une).

Paramètres :

  • public_key (obligatoire) : Votre clé publique Tidio
  • loading_mode (facultatif) : "async" (par défaut) ou "sync"

Comment cela fonctionne

  1. L'utilisateur appelle tidio_connect avec l'URL de son site web
  2. Le navigateur s'ouvre sur la page d'authentification de Tidio
  3. L'utilisateur se connecte à son compte Tidio
  4. Rappel reçu - le serveur MCP obtient le jeton d'actualisation
  5. Appels API effectués - échange le jeton contre un jeton d'accès, puis récupère la clé publique
  6. Identifiants enregistrés dans ~/.tidio-mcp/credentials.json
  7. Code d'intégration renvoyé - prêt à être ajouté au site web

Stockage des identifiants

Les identifiants sont stockés localement à ~/.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"
}

Sortie du code d'intégration

Le connecteur génère un code de chargement asynchrone optimisé :

<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>

Développement

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run built version
npm start