TagoIO | Serveur MCP

Le serveur MCP de TagoIO permet aux modèles d'IA d'interagir directement avec votre compte TagoIO, offrant un accès contextuel aux appareils, aux données et aux ressources de la plate-forme pour améliorer les flux de développement et l'analyse intelligente des données.

Caractéristiques

• Gestion des appareils: Accédez aux informations sur les appareils, aux configurations et aux données en temps réel
• Analyse des données: Effectuez des opérations statistiques (sommes, moyennes, rapports) sur les données stockées
• Intégration de la plateforme: Récupération d'utilisateurs, d'actions, de scripts d'analyse et de statistiques sur les comptes
• Génération de code: Génération de scripts d'analyse TagoIO assistée par l'IA avec le contexte approprié
• Aide au développement: Assistance au débogage et analyse des relations entre les balises

Démarrage rapide

Conditions préalables

• Node.js 18+ installé(https://nodejs.org/en/download/)
• Compte TagoIO avec jeton de profil ou jeton d'analyse valide
• Plateforme d'IA ou IDE compatible (voir Plateformes supportées)

Installation

Configuration manuelle

Créez ou mettez à jour votre fichier de configuration MCP :

{ "mcpServers" : { "@tago-io/mcp" : { "command" : "npx", "args" : ["-y", "@tago-io/mcp-server"], "env" : { "TAGOIO_TOKEN" : "YOUR-TOKEN", "TAGOIO_API" : "https://api.us-e1.tago.io" } } }

Paramètres de configuration :

• Remplacez YOUR-TOKEN par votre jeton de profil TagoIO ou un jeton d'analyse
  • L'utilisation d'un jeton d'analyse est recommandée pour une meilleure sécurité, car vous pouvez limiter les autorisations du jeton aux seules ressources dont vous avez besoin. Votre analyse doit être configurée pour fonctionner en mode "externe" afin que vous puissiez utiliser le jeton.
  • L'utilisation d'un jeton de profil permet au MCP d'accéder instantanément à l'ensemble de votre profil, mais elle n'est pas recommandée pour les environnements de production.
• Mise à jour du point de terminaison de l'API à https://api.eu-w1.tago.io pour les comptes européens

Configuration spécifique à la plateforme

Claude Desktop

1. Téléchargez et installez Claude Desktop
2. Copier la configuration MCP ci-dessus
3. Envoyer l'invite : "Hé Claude, installe le serveur MCP suivant" avec la configuration
4. Claude installera et configurera automatiquement le serveur

Installation en un clic pour les IDE de développement

Ou placer le fichier de configuration dans l'emplacement approprié pour votre IDE et redémarrer l'application.

Authentification du serveur MCP

Le serveur MCP nécessite un jeton de profil TagoIO pour l'authentification :

1. Connectez-vous à votre compte TagoIO
2. Naviguez vers Paramètres du compte → Jetons de profil
3. Générer un nouveau jeton avec les permissions appropriées
4. Remplacez YOUR-PROFILE-TOKEN dans la configuration

Note de sécurité: Gardez votre jeton de profil en sécurité et ne le mettez jamais dans le contrôle de version.

Points d'extrémité de l'API

Le serveur prend en charge les instances TagoIO américaines et européennes :

• US East: https://api.us-e1.tago.io (par défaut)
• UE Ouest: https://api.eu-w1.tago.io

Résolution des problèmes

Problèmes courants

Échec de la connexion

• Vérifiez la validité de votre jeton de profil
• Vérifiez que le point de terminaison de l'API est correct pour votre région

Erreur d'authentification

• Confirmer que le profil ou le jeton d'analyse dispose des autorisations nécessaires
• Vérifier le format du jeton dans le fichier de configuration

Problèmes d'accès aux données

• Vérifier les autorisations des appareils dans votre compte TagoIO
• S'assurer que les appareils disposent de données récentes

Licence

Ce projet est sous licence MIT - voir le fichier LICENSE pour plus de détails.

Besoin d'aide ? Consultez la documentation de TagoIO ou contactez notre équipe d'assistance.