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 IA 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 IA 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 IA 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 que le serveur MCP expose
Comment fonctionne le MCP
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Requête Utilisateur │────▶│ AI SmartTalk │────▶│ Serveur MCP │
│ │ │ (Agent IA) │ │ │
│ "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 nécessitant 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 retournée et l'IA formule la réponse
Configuration étape par étape
Étape 1 : Accéder à l'intégration MCP
- Connectez-vous à votre compte AI SmartTalk
- Allez dans 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 IA
- Examinez les outils découverts
- Activez les outils que vous souhaitez que votre IA 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 client
Trigger: Chat Service (quand l'utilisateur demande des informations sur le compte)
Actions:
1. Appel d'outil MCP:
Serveur: Company CRM
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 |
Découvrez-en 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 aux données sécurisé/privé
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
- Prenez en compte les exigences de résidence des données
- Enregistrez 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é du 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 taux" | Mettez en œuvre un backoff 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 en profondeur, 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 gracieusement : L'IA doit gérer les échecs d'outils avec élégance
- 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é