Serveurs MCP
Connectez des outils et services externes à AI SmartTalk en utilisant le Model Context Protocol (MCP). MCP est une norme ouverte qui permet aux assistants AI d'interagir avec des systèmes externes via une interface unifiée.
Aperçu
L'intégration du serveur MCP vous permet de :
- Connecter tout serveur compatible MCP
- Exposer des outils que votre AI peut appeler lors des conversations
- Accéder à des données externes via des protocoles standardisés
- Étendre les capacités sans développement personnalisé
Qu'est-ce que le MCP ? Le Model Context Protocol est une norme ouverte (développée par Anthropic) qui permet aux systèmes AI de se connecter en toute sécurité à des sources de données et des outils externes.
Prérequis
Avant de commencer, assurez-vous d'avoir :
- Un compte AI SmartTalk actif
- Accès à un serveur MCP (auto-hébergé ou tiers)
- URL du serveur MCP et identifiants d'authentification
- Compréhension des outils exposés par le serveur MCP
Fonctionnement du MCP
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Requête Utilisateur │────▶│ AI SmartTalk │────▶│ Serveur MCP │
│ │ │ (Agent AI) │ │ │
│ "Vérifiez mon CRM" │ │ │ │ - Outils CRM │
│ │◀────│ Traite la requête │◀────│ - Requêtes DB │
│ Réponse │ │ Appelle les outils MCP │ - Accès aux fichiers │
└─────────────────┘ └─────────────────┘ └─────────────────┘
- L'utilisateur pose une question qui nécessite des données externes
- AI SmartTalk reconnaît qu'il a besoin d'un outil MCP
- Le serveur MCP est appelé avec l'outil approprié
- La réponse est renvoyée et l'AI formule la réponse
Configuration étape par étape
Étape 1 : Accéder à l'intégration MCP
- Connectez-vous à votre compte AI SmartTalk
- Accédez à Paramètres → Intégrations
- Trouvez Serveurs MCP et cliquez sur Ajouter un serveur
Étape 2 : Configurer le serveur MCP
Entrez les détails de votre serveur MCP :
| Champ | Description |
|---|---|
| Nom du serveur | Nom convivial pour cette connexion |
| URL du serveur | Point de terminaison du serveur MCP (par exemple, https://mcp.example.com) |
| Transport | SSE (Server-Sent Events) ou WebSocket |
| Authentification | Clé API, OAuth ou aucune |
Étape 3 : Tester la connexion
- Cliquez sur Tester la connexion
- AI SmartTalk va pinguer le serveur MCP
- Vérifiez que le statut indique Connecté
Étape 4 : Découvrir les outils disponibles
Une fois connecté, AI SmartTalk récupère la liste des outils disponibles :
| Outil | Description | Paramètres |
|---|---|---|
search_crm | Rechercher des enregistrements clients | query, limit |
create_ticket | Créer un ticket de support | title, description |
get_weather | Récupérer des données météorologiques | location |
Étape 5 : Activer les outils pour votre AI
- Examinez les outils découverts
- Activez les outils que vous souhaitez que votre AI utilise
- Configurez les paramètres spécifiques à chaque outil
- Enregistrez votre configuration
Intégration SmartFlow
Les outils MCP peuvent également être utilisés dans les flux SmartFlow :
Utilisation des outils MCP dans les flux
- Dans SmartFlow, trouvez MCP dans la bibliothèque d'actions
- Faites glisser l'action MCP dans votre flux
- Sélectionnez le Serveur MCP et Outil
- Mappez les paramètres d'entrée à partir du contexte de votre flux
- Utilisez la réponse de l'outil dans les actions suivantes
Exemple : Flux de recherche de client
Trigger: Service de chat (lorsque l'utilisateur demande des informations sur le compte)
Actions:
1. Appel d'outil MCP:
Serveur: CRM de l'entreprise
Outil: search_crm
Paramètres:
query: {{user_email}}
2. Réponse AI:
Contexte: Résultat de la recherche CRM
Invite: Répondre à la question de l'utilisateur sur le compte
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 :
- "Quelle est la météo actuelle à 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 |
Pour en savoir plus : Visitez le MCP Server Registry pour les serveurs communautaires.
Auto-Hébergement de Serveurs MCP
Vous pouvez créer des serveurs MCP personnalisés pour :
- Systèmes internes propriétaires
- Logique métier personnalisée
- Accès sécurisé/privé aux données
Considérations de Sécurité
Authentification
| Méthode | Cas d'utilisation |
|---|---|
| API Key | Authentification simple entre serveurs |
| OAuth 2.0 | Accès délégué par l'utilisateur |
| mTLS | Environnements à haute sécurité |
Confidentialité des Données
- Les requêtes MCP peuvent contenir des données utilisateur
- Assurez-vous que votre serveur MCP gère les données de manière appropriée
- Tenez compte des exigences de résidence des données
- Journalisez et auditez les appels d'outils MCP
Sécurité Réseau
- Utilisez HTTPS pour toutes les connexions MCP
- Restreignez l'accès au serveur MCP aux IPs d'AI SmartTalk
- Mettez en œuvre une limitation de débit sur votre serveur MCP
Dépannage
Problèmes de Connexion
| Problème | Solution |
|---|---|
| "Connexion refusée" | Vérifiez l'URL et le port du serveur |
| "Échec de l'authentification" | Vérifiez les identifiants/API key |
| "Délai d'attente" | Vérifiez la connectivité réseau, les règles de pare-feu |
| "Erreur SSL" | Assurez-vous que le certificat SSL est valide |
Problèmes de Découverte d'Outils
| Problème | Solution |
|---|---|
| "Aucun outil trouvé" | Vérifiez que le serveur MCP expose correctement les outils |
| "Outil non disponible" | Vérifiez que l'outil est activé côté serveur |
| "Incompatibilité de schéma" | Mettez à jour AI SmartTalk pour rafraîchir les schémas d'outils |
Problèmes d'Exécution
| Problème | Solution |
|---|---|
| "Échec de l'appel d'outil" | Vérifiez les journaux du serveur pour des erreurs |
| "Réponse inattendue" | Vérifiez que l'outil renvoie le format attendu |
| "Limité par le débit" | Mettez en œuvre un retour en arrière ou augmentez les limites |
Gestion des Serveurs MCP
| Action | Comment |
|---|---|
| Ajouter un serveur | Paramètres → Intégrations → MCP → Ajouter un serveur |
| Modifier un serveur | Cliquez sur le nom du serveur pour modifier |
| Désactiver un serveur | Désactivez sans supprimer |
| Supprimer un serveur | Bouton de suppression (les outils deviennent indisponibles) |
| Rafraîchir les outils | Cliquez sur Rafraîchir pour redécouvrir les outils |
Meilleures Pratiques
- Commencez simplement : Connectez un serveur, testez soigneusement, puis étendez
- Documentez les outils : Conservez des documents internes sur ce que fait chaque outil
- Surveillez l'utilisation : Suivez quels outils sont appelés et leur performance
- Gérez les erreurs avec élégance : L'IA doit gérer les échecs d'outils de manière élégante
- Sécurisez les identifiants : Utilisez des variables d'environnement, pas de clés codées en dur
- Versionnez vos serveurs : Les serveurs MCP doivent être versionnés pour la stabilité