Cet article explique comment intégrer Scanova avec des outils propulsés par LLM tels que ChatGPT, LangChain, AutoGen, Cursor, Claude Desktop et d’autres en utilisant le protocole Model Context Protocol (MCP).
Introduction
Le Model Context Protocol (MCP) permet une intégration sécurisée entre un compte Scanova et des outils d’IA ou des environnements de développement tels que ChatGPT, LangChain, AutoGen, VS Code, Cursor et Claude Desktop. Grâce à MCP, les utilisateurs peuvent générer, gérer et télécharger des codes QR directement depuis des applications compatibles MCP, réduisant ainsi les étapes manuelles et permettant l’automatisation.
Cette intégration est idéale pour les développeurs et les équipes techniques travaillant avec des flux de travail de codes QR à grande échelle ou pilotés par l’IA.
A. Générer un jeton MCP depuis Scanova
Pour lier de manière sécurisée un compte Scanova à un outil compatible MCP, suivez ces étapes :
Connectez-vous au compte Scanova
Dans la barre latérale gauche, allez à Intégrations > Model Context Protocol (MCP)
Cliquez sur Configurer
Cliquez sur Générer un jeton
Le jeton généré sert de justificatif d’autorisation pour le serveur MCP. Il doit être stocké en toute sécurité et ne pas être partagé publiquement.
B. Configurer le client MCP
Une fois le jeton généré, il doit être ajouté au fichier de configuration de l’outil compatible MCP. Voici des exemples de configurations pour les environnements couramment utilisés :
Pour Cursor (~/.cursor/mcp.json) :
{
"mcpServers": {
"scanova-mcp": {
"transport": "http",
"url": "https://mcp.scanova.io/mcp",
"headers": {
"Authorization": "VOTRE_CLÉ_API_SCANOVA_ICI"
}
}
}
}
Pour VS Code (~/.vscode/mcp.json) :
{
"mcpServers": {
"scanova-mcp": {
"transport": "http",
"url": "https://mcp.scanova.io/mcp",
"headers": {
"Authorization": "VOTRE_CLÉ_API_SCANOVA_ICI"
}
}
}
}
Pour Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json) :
{
"mcpServers": {
"scanova-mcp": {
"transport": "http",
"url": "https://mcp.scanova.io/mcp",
"headers": {
"Authorization": "VOTRE_CLÉ_API_SCANOVA_ICI"
}
}
}
}
Remplacez VOTRE_CLÉ_API_SCANOVA_ICI par le jeton généré à l’étape A.
C. Outils et actions pris en charge
Le serveur MCP de Scanova prend en charge une gamme d’actions pouvant être déclenchées via des invites en texte clair ou directement via des outils compatibles MCP :
| Outil | Description | Phrase d’exemple |
|---|---|---|
create_qr_code |
Créer un nouveau code QR | « créer qr », « faire un code qr » |
list_qr_codes |
Lister tous les codes QR | « lister codes qr », « afficher qrs » |
update_qr_code |
Modifier le nom ou l’URL d’un code QR | « mettre à jour qr », « modifier code qr » |
retrieve_qr_code |
Obtenir les détails d’un code QR | « obtenir détails qr », « info qr » |
download_qr_code |
Télécharger l’image du code QR | « télécharger qr », « obtenir image qr » |
activate_qr_code |
Réactiver un code QR désactivé | « activer qr » |
deactivate_qr_code |
Désactiver un code QR | « désactiver qr » |
Ces outils utilisent l’API Scanova via la couche MCP pour garantir une expérience fluide et sécurisée.
D. Dépôt GitHub public pour Scanova MCP
Scanova fournit un serveur MCP open source qui peut être cloné, étendu ou exécuté localement à des fins de développement.
Visitez : Scanova MCP sur GitHub
Le dépôt comprend :
Étapes d’installation
Instructions de déploiement Docker
Directives pour les tests locaux
Liste complète des outils pris en charge et des points d’accès API
E. Dépannage
| Problème | Action suggérée |
|---|---|
| « Clé API requise » | Vérifiez que le jeton est correctement ajouté sous Authorization dans le fichier de configuration |
| Erreur « Jeton invalide » | Générez à nouveau le jeton depuis le tableau de bord Scanova |
| « Erreur de connexion » | Confirmez que l’URL est correcte et que l’accès à Internet est disponible |
| « Outil non trouvé » | Redémarrez l’IDE et assurez-vous que la configuration est valide |
La santé du serveur MCP peut être vérifiée en visitant : https://mcp.scanova.io/health
Si une assistance supplémentaire est nécessaire
Pour des conseils supplémentaires ou de l’aide concernant la configuration MCP, les utilisateurs peuvent consulter cette base de connaissances ou contacter l’équipe des relations clients à support@scanova.io.