Serveurs MCP
Connectez des outils et services externes à AI SmartTalk en utilisant le Modèle de Protocole de Contexte (MCP). MCP est une norme ouverte qui permet à votre assistant IA d'interagir avec des systèmes externes via une interface unifiée.
Aperçu
L'intégration des serveurs MCP vous permet de :
- Connecter plusieurs serveurs MCP simultanément
- Exposer des outils externes que votre IA peut appeler lors des conversations
- S'authentifier avec des en-têtes HTTP personnalisés (clés API, jetons, etc.)
- Tester les connexions avant de passer en production
- Étendre les capacités sans développement personnalisé
Qu'est-ce que le MCP ? Le Modèle de Protocole de Contexte est une norme ouverte (développée par Anthropic) qui permet aux systèmes IA de se connecter en toute sécurité à des sources de données et outils externes. En savoir plus sur modelcontextprotocol.io.
Prérequis
Avant de commencer, assurez-vous d'avoir :
- Un compte AI SmartTalk actif
- Accès à un ou plusieurs serveurs compatibles MCP
- L'URL du serveur pour chaque serveur MCP
- Les informations d'authentification requises (clés API, jetons)
Fonctionnement du MCP
- L'utilisateur pose une question nécessitant des données externes
- AI SmartTalk reconnaît qu'il a besoin d'un outil MCP
- Le serveur MCP approprié est appelé avec le bon outil
- La réponse est renvoyée et l'IA formule une réponse en langage naturel
AI SmartTalk prend en charge plusieurs serveurs MCP à la fois. Les outils provenant de différents serveurs sont automatiquement namespace pour éviter les conflits.
Configuration Étape par Étape
Étape 1 : Accéder à l'Intégration MCP
- Connectez-vous à votre compte AI SmartTalk
- Accédez à Administration → Mes Assistants → [Nom de votre Assistant]
- Cliquez sur Connecteurs dans la barre latérale gauche
- Localisez Serveurs MCP et cliquez dessus
Étape 2 : Ajouter un Serveur MCP
Cliquez sur Ajouter un Serveur pour ouvrir le formulaire de configuration du serveur. Remplissez les champs suivants :
| Champ | Requis | Description |
|---|---|---|
| Nom du Serveur | Oui | Un nom convivial pour identifier ce serveur (par exemple, "CRM de l'Entreprise", "Wiki Interne") |
| URL du Serveur | Oui | L'URL de point de terminaison du serveur MCP (par exemple, https://mcp.example.com) |
| En-têtes HTTP | Non | En-têtes personnalisés pour l'authentification ou d'autres exigences |
AI SmartTalk ajoute automatiquement /mcp à votre URL si elle ne se termine pas déjà par cela. Par exemple, https://example.com devient https://example.com/mcp. Si votre serveur utilise un chemin de point de terminaison différent, incluez-le dans l'URL (par exemple, https://example.com/api/mcp).
Étape 3 : Ajouter des En-têtes d'Authentification (Optionnel)
Si votre serveur MCP nécessite une authentification, cliquez sur Ajouter des En-têtes pour configurer des en-têtes HTTP personnalisés :
| En-tête Commun | Cas d'Utilisation |
|---|---|
Authorization | Jetons Bearer (par exemple, Bearer sk-xxx...) |
X-API-Key | Authentification par clé API |
X-Auth-Token | Authentification par jeton personnalisé |
Pour chaque en-tête, fournissez :
- Clé : Le nom de l'en-tête (sélectionnez parmi les en-têtes communs ou tapez un personnalisé)
- Valeur : La valeur de l'en-tête (les valeurs sensibles sont automatiquement masquées dans l'interface)
Vous pouvez ajouter plusieurs en-têtes par serveur. Les en-têtes contenant "secret", "password", "token" ou "auth" dans le nom de la clé sont automatiquement cachés pour des raisons de sécurité.
Étape 4 : Tester la Connexion
Avant de sauvegarder, cliquez sur Tester la Connexion pour vérifier que votre serveur est accessible :
- AI SmartTalk envoie une requête d'initialisation JSON-RPC à votre serveur
- Le test vérifie plusieurs points de terminaison dans l'ordre :
/mcp,/health, puis l'URL de base - Les résultats affichent l'état de la connexion, le temps de réponse et les informations sur le serveur
| Résultat du Test | Signification |
|---|---|
| Connecté | Le serveur a répondu avec succès avec le protocole MCP |
| Échec de l'authentification | Vérifiez votre clé API ou votre jeton dans les en-têtes |
| Serveur introuvable | Vérifiez que l'URL est correcte |
| Connexion refusée | Le serveur peut être hors ligne ou un pare-feu bloque l'accès |
| Délai d'attente | Le serveur a mis trop de temps à répondre (limite de 10s) |
| Erreur SSL | Vérifiez que le serveur dispose d'un certificat SSL valide |
Étape 5 : Sauvegarder la Configuration
- Cliquez sur Ajouter pour ajouter le serveur à votre liste
- Répétez les Étapes 2-4 pour ajouter d'autres serveurs MCP si nécessaire
- Cliquez sur Sauvegarder l'Intégration pour activer tous les serveurs configurés
Support Multi-Serveurs
AI SmartTalk prend en charge la connexion à plusieurs serveurs MCP simultanément. Cela vous permet de combiner des outils provenant de différentes sources :
Nommage des Outils
Les outils de chaque serveur sont automatiquement préfixés par le nom du serveur pour éviter les conflits de nom. Par exemple :
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
Cela signifie que vous pouvez connecter en toute sécurité des serveurs qui exposent des outils avec le même nom.
Gestion de Plusieurs Serveurs
Le tableau de bord d'intégration affiche tous les serveurs configurés avec :
- Nom et URL du serveur pour une identification facile
- Badge de compte d'en-têtes si des en-têtes personnalisés sont configurés
- Indicateur de statut (Configuré / Incomplet)
- Boutons d'action : Tester la connexion, Éditer ou Supprimer des serveurs individuels
Découverte des Outils
Une fois vos serveurs MCP connectés, AI SmartTalk découvre automatiquement tous les outils disponibles exposés par chaque serveur. Ces outils deviennent immédiatement disponibles pour votre assistant IA.
L'assistant IA va :
- Voir la liste de tous les outils disponibles de tous les serveurs connectés
- Sélectionner automatiquement le bon outil en fonction des requêtes des utilisateurs
- Appeler l'outil avec les paramètres appropriés
- Traiter la réponse et fournir une réponse en langage naturel
Vous n'avez pas besoin de configurer ou d'activer manuellement des outils individuels. Tous les outils exposés par un serveur MCP connecté sont automatiquement disponibles pour votre assistant IA.
Cas d'Utilisation
Gestion de la Relation Client
Connectez votre CRM via MCP :
- "Rechercher le client John Smith"
- "Quel est le statut du compte #12345 ?"
- "Combien de tickets de support ouverts avons-nous ?"
Outils Internes
Accédez aux systèmes de l'entreprise :
- "Vérifiez l'inventaire pour le produit SKU-123"
- "Quel est le programme pour demain ?"
- "Recherchez dans notre wiki interne les documents d'intégration"
Sources de Données Externes
Récupérez des données en direct :
- "Quel est le temps actuel à Paris ?"
- "Obtenez le dernier prix de l'action pour AAPL"
- "Vérifiez le statut du vol UA123"
Outils de Développement
Pour les équipes techniques :
- "Quel est le statut de la dernière version ?"
- "Recherchez dans nos problèmes GitHub les bugs d'authentification"
- "Vérifiez la santé des serveurs de production"
Exemples de Serveurs MCP
Serveurs MCP Populaires
| Serveur | Objectif | Lien |
|---|---|---|
| Filesystem | Lire/écrire des fichiers locaux | Serveur de référence intégré |
| PostgreSQL | Interroger des bases de données | Serveur communautaire |
| GitHub | Gestion de dépôts | Serveur communautaire |
| Slack | Intégration de messagerie | Serveur communautaire |
| Google Drive | Gestion de fichiers | Serveur communautaire |
| Brave Search | Recherche web | Serveur communautaire |
Découvrez plus : Visitez le Registre des Serveurs MCP pour une liste croissante de serveurs MCP communautaires.
Serveurs MCP Auto-Hébergés
Vous pouvez créer des serveurs MCP personnalisés pour :
- Systèmes internes propriétaires
- Logique métier personnalisée
- Accès à des données sécurisées ou privées
Utilisez n'importe quel SDK MCP (TypeScript, Python) pour construire votre propre serveur.
Considérations de Sécurité
Authentification
Configurez l'authentification via HTTP Headers dans la configuration du serveur :
| Méthode | Exemple d'En-tête |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Key | X-API-Key: your-api-key |
| Custom Token | X-Auth-Token: your-token |
Confidentialité des Données
- Les requêtes MCP peuvent contenir des données de conversation utilisateur
- Assurez-vous que votre serveur MCP gère les données conformément à vos politiques de confidentialité
- Prenez en compte les exigences de résidence des données
- AI SmartTalk masque les valeurs d'en-tête sensibles dans l'interface utilisateur
Sécurité Réseau
- Utilisez HTTPS pour toutes les connexions MCP
- Restreignez l'accès au serveur MCP aux IP de confiance
- Implémentez une limitation de taux sur votre serveur MCP
- Assurez-vous que des certificats SSL valides sont en place
Dépannage
Problèmes de Connexion
| Problème | Solution |
|---|---|
| "Connexion refusée" | Vérifiez l'URL et le port du serveur. Assurez-vous que le serveur est en cours d'exécution |
| "Échec de l'authentification" (401) | Vérifiez votre clé API ou votre token dans la configuration des en-têtes |
| "Interdit" (403) | Vérifiez que vos identifiants ont les autorisations requises |
| "Serveur non trouvé" (404) | Vérifiez l'URL. L'application AI SmartTalk ajoute automatiquement /mcp |
| "Délai d'attente" | Vérifiez la connectivité réseau et les règles de pare-feu. Le test a un délai d'attente de 10 secondes |
| "Erreur SSL" | Assurez-vous que votre serveur MCP dispose d'un certificat SSL valide |
| "Limité par le taux" (429) | Trop de requêtes. Attendez et réessayez, ou augmentez les limites du serveur |
Problèmes d'Outils
| Problème | Solution |
|---|---|
| Outils non apparaissant | Vérifiez que le serveur MCP expose correctement les outils. Essayez de rafraîchir |
| Mauvais outils appelés | Vérifiez que les noms de serveur sont descriptifs pour aider l'IA à choisir correctement |
| Échec de l'appel d'outil | Vérifiez les journaux du serveur pour des erreurs. Assurez-vous que l'outil retourne le format attendu |
Erreurs Courantes
- Oublier
/mcp: AI SmartTalk l'ajoute automatiquement, mais si votre point de terminaison est différent, incluez le chemin complet - Mauvais format d'en-tête : Assurez-vous que les en-têtes d'authentification correspondent à ce que votre serveur attend
- Noms de serveur dupliqués : Chaque serveur doit avoir un nom unique
Gestion des Serveurs MCP
| Action | Comment |
|---|---|
| Ajouter un serveur | Cliquez sur "Ajouter un Serveur", remplissez les détails, testez et enregistrez |
| Modifier un serveur | Cliquez sur l'icône de modification sur la carte du serveur |
| Tester la connexion | Cliquez sur l'icône de test sur la carte du serveur |
| Supprimer un serveur | Cliquez sur l'icône de suppression sur la carte du serveur |
| Enregistrer les modifications | Cliquez sur "Enregistrer l'Intégration" pour persister toutes les modifications |
Meilleures Pratiques
- Utilisez des noms de serveur descriptifs : Aide l'IA à comprendre quel serveur interroger (par exemple, "CRM de l'entreprise" plutôt que "Serveur 1")
- Testez avant d'enregistrer : Testez toujours les connexions pour détecter les problèmes de configuration tôt
- Commencez par un serveur : Familiarisez-vous avec une intégration avant d'en ajouter d'autres
- Sécurisez vos identifiants : Utilisez des clés API dédiées pour AI SmartTalk, pas de tokens personnels
- Surveillez vos serveurs : Suivez quels outils sont appelés et leur performance
- Gardez les serveurs à jour : Assurez-vous que vos serveurs MCP suivent la dernière spécification du protocole