MCP (Model Context Protocol)

​

Aperçu

• Accès aux outils externes - Connexion à des services tiers et des API
• Intégration des sources de données - Accès aux bases de données, systèmes de fichiers et stockages cloud
• Fonctionnalités personnalisées - Ajout d’outils spécialisés pour vos cas d’utilisation spécifiques
• Interface standardisée - Utilisation d’un protocole cohérent pour toutes les intégrations
• Authentification sécurisée - Prise en charge d’OAuth 2.0 et d’en-têtes personnalisés

​

Fonctionnement

​

1. Connexion à un serveur MCP

1. Enregistrement du serveur - Le serveur est enregistré dans la configuration de votre agent
2. Découverte des outils - L’agent découvre les outils disponibles sur le serveur MCP
3. Intégration des outils - Les outils deviennent disponibles pour l’agent pendant les conversations
4. Exécution dynamique - L’agent peut appeler ces outils selon ses besoins

​

2. Flux d’exécution des outils

Requête utilisateur → Agent → Appel d'outil MCP → Serveur MCP → Système externe → Réponse → Agent → Utilisateur

​

3. Serveurs multiples

• Chaque serveur fournit son propre ensemble d’outils
• Les outils sont préfixés par le nom du serveur (par exemple, sentry_get_errors)
• Les serveurs peuvent être activés ou désactivés indépendamment

​

Démarrage rapide

​

Ajout de serveurs MCP populaires

1. Accédez à Agents dans la barre latérale
2. Sélectionnez ou créez un agent
3. Cliquez sur Edit pour ouvrir le constructeur d’agents
4. Accédez à l’onglet MCP
5. Dans la section Quick Add Popular Servers, cliquez sur une tuile de serveur pour l’ajouter

​

Serveurs populaires

​

Sentry

• URL : https://mcp.sentry.dev/mcp
• Transport : HTTP
• Authentification : OAuth 2.0
• Scopes : org:read project:write team:write event:write

• Afficher les rapports d’erreurs
• Surveiller les métriques de performance
• Gérer les projets et les équipes
• Suivre les événements et les problèmes

​

Tutoriel vidéo

​

Ajout de serveurs MCP personnalisés

​

Étape 1 : Accéder à la configuration MCP

1. Accédez à Agents dans la barre latérale
2. Sélectionnez ou créez un agent
3. Cliquez sur Edit pour ouvrir le constructeur d’agents
4. Accédez à l’onglet MCP
5. Faites défiler jusqu’à la section Advanced Configuration

​

Étape 2 : Ajouter un nouveau serveur

1. Cliquez sur le bouton Add Server
2. Le formulaire de configuration du serveur apparaîtra

​

Étape 3 : Configurer les paramètres du serveur

​

Nom du serveur

• Utilisez des lettres minuscules et des tirets
• Soyez descriptif mais concis
• Évitez les caractères spéciaux

​

Type de transport

• Requêtes HTTP standard
• Idéal pour les API REST et les services web
• Prend en charge le modèle requête/réponse

• Communication en streaming en temps réel
• Idéal pour les flux de données en direct
• Prend en charge le streaming unidirectionnel serveur-vers-client

​

URL du serveur

• https://api.example.com/mcp
• http://localhost:8000/mcp/
• https://mcp.example.com/v1

• https://api.example.com/sse
• https://stream.example.com/events

​

Étape 4 : Configurer l’authentification

​

Sans authentification

​

OAuth 2.0

1. Sélectionnez OAuth 2.0 comme méthode d’authentification
2. Saisissez les OAuth Scopes (séparés par des espaces)
   • Exemple : read write admin
   • Exemple : org:read project:write team:write

• Lorsqu’un utilisateur interagit avec l’agent, il lui sera demandé d’autoriser
• L’autorisation est gérée automatiquement
• Les jetons sont stockés de manière sécurisée et rafraillis selon les besoins

​

Étape 5 : En-têtes personnalisés (Facultatif)

1. Cliquez sur Add Header
2. Saisissez le nom de l’en-tête (par exemple, X-API-Key, Authorization)
3. Saisissez la valeur de l’en-tête
4. Ajoutez d’autres en-têtes selon les besoins

• X-API-Key : your-api-key
• Authorization : Bearer token
• X-Custom-Header : custom-value

​

Étape 6 : Activer/Désactiver le serveur

• Activé : Les outils du serveur sont disponibles pour l’agent
• Désactivé : Les outils du serveur sont masqués mais la configuration est conservée

​

Étape 7 : Tester la connexion

1. Cliquez sur le bouton Test pour vérifier la connexion
2. Attendez le résultat du test :
   • Succès : Le serveur est accessible et correctement configuré
   • Erreur : Vérifiez votre configuration et la connectivité réseau

​

Étape 8 : Enregistrer la configuration

1. Cliquez sur Save pour enregistrer la configuration de votre serveur MCP
2. Le serveur est désormais disponible pour votre agent

​

Gestion des serveurs MCP

​

Consultation des serveurs configurés

• Nombre de serveurs - Nombre de serveurs configurés
• Statut du serveur - Statut activé/désactivé
• Noms des serveurs - Liste de tous les serveurs configurés

​

Modification de la configuration d’un serveur

1. Recherchez le serveur dans la section Advanced Configuration
2. Cliquez pour développer la configuration du serveur
3. Modifiez les paramètres souhaités
4. Cliquez sur Test pour vérifier les modifications
5. La configuration est enregistrée automatiquement

​

Suppression de serveurs

1. Recherchez le serveur que vous souhaitez supprimer
2. Cliquez sur l’icône Remove (corbeille)
3. Confirmez la suppression
4. Le serveur est supprimé de la configuration de votre agent

​

Activation/Désactivation des serveurs

• Activer : Rend les outils du serveur disponibles
• Désactiver : Masque les outils du serveur tout en préservant la configuration

• Désactiver temporairement des serveurs problématiques
• Tester différentes configurations de serveurs
• Gérer la disponibilité des serveurs sans supprimer la configuration

​

Types de transport

​

HTTP (streamable_http)

• Connexion à des API REST
• Modèles de requête/réponse standard
• Services web et microservices

• L’URL doit pointer vers le point de terminaison MCP
• Prend en charge les méthodes HTTP standard
• Fonctionne avec la plupart des services web

URL: https://api.example.com/mcp
Transport: HTTP

​

SSE (Server-Sent Events)

• Flux de données en temps réel
• Mises à jour et notifications en direct
• Communication unidirectionnelle serveur-vers-client

• L’URL doit pointer vers le point de terminaison SSE
• Le serveur doit prendre en charge le protocole SSE
• Reconnexion automatique en cas de déconnexion

URL: https://stream.example.com/sse
Transport: SSE

​

Méthodes d’authentification

​

Sans authentification

• API publiques
• Services internes
• Serveurs de développement/test

• Sélectionnez No Authentication
• Aucune configuration supplémentaire nécessaire

​

OAuth 2.0

• Services tiers (Sentry, Canva, etc.)
• Accès aux données spécifiques à un utilisateur
• Permissions limitées par scope

1. Sélectionnez OAuth 2.0
2. Saisissez les scopes OAuth (séparés par des espaces)
3. Les utilisateurs autoriseront lors de la première utilisation

• Sentry : org:read project:write team:write event:write
• Canva : asset:read asset:write design:read design:write
• Personnalisé : read write admin

1. L’utilisateur interagit avec l’agent
2. L’agent a besoin d’un outil MCP provenant d’un serveur protégé par OAuth
3. L’utilisateur est invité à autoriser
4. L’autorisation se termine automatiquement
5. Le jeton est stocké de manière sécurisée
6. Les requêtes futures utilisent le jeton stocké

​

En-têtes personnalisés

• Clés API
• Jetons d’authentification personnalisés
• En-têtes spécifiques à un service
• Métadonnées de requête

​

Ajout d’en-têtes

1. Dans la configuration du serveur, trouvez la section Custom Headers
2. Cliquez sur Add Header
3. Saisissez le nom de l’en-tête (par exemple, X-API-Key)
4. Saisissez la valeur de l’en-tête
5. Ajoutez d’autres en-têtes selon les besoins

​

Modèles d’en-têtes courants

Header: X-API-Key
Value: your-api-key-here

Header: Authorization
Value: Bearer your-token-here

Header: X-Service-Name
Value: your-service-identifier

​

Cas d’utilisation

​

Surveillance des erreurs

{
  "server_name": "sentry",
  "transport": "streamable_http",
  "url": "https://mcp.sentry.dev/mcp",
  "auth_type": "oauth",
  "oauth_scopes": "org:read project:write team:write event:write"
}

• « Affichez-moi les erreurs des dernières 24 heures »
• « Quel est le taux d’erreur pour le projet X ? »
• « Listez tous les problèmes non résolus »

​

Accès à une base de données

{
  "server_name": "postgres-db",
  "transport": "streamable_http",
  "url": "https://mcp.example.com/database",
  "auth_type": "oauth",
  "headers": {
    "X-Database-Name": "production"
  }
}

• « Interrogez la table des utilisateurs »
• « Affichez-moi les commandes récentes »
• « Obtenez les statistiques clients »

​

Accès au système de fichiers

{
  "server_name": "filesystem",
  "transport": "streamable_http",
  "url": "https://mcp.example.com/files",
  "auth_type": "oauth"
}

• « Listez les fichiers dans le dossier documents »
• « Lisez le fichier de configuration »
• « Recherchez les fichiers contenant ‘error’ »

​

Flux de données en temps réel

{
  "server_name": "live-data",
  "transport": "sse",
  "url": "https://stream.example.com/sse",
  "auth_type": "oauth"
}

• « Affichez-moi les prix des actions en direct »
• « Surveillez les métriques système »
• « Suivez les événements en temps réel »

​

Bonnes pratiques

​

Nommage des serveurs

• Soyez descriptif : Utilisez des noms clairs et significatifs
• Utilisez les minuscules : Préférez les minuscules avec des tirets
• Évitez les caractères spéciaux : Limitez-vous aux lettres, chiffres et tirets
• Soyez cohérent : Suivez une convention de nommage

• sentry-monitoring
• postgres-production
• weather-api

• Server1
• my_mcp_server
• MCP-Server!!!

​

Configuration des URL

• Utilisez HTTPS : Préférez toujours les connexions sécurisées
• Incluez le chemin complet : Spécifiez l’URL complète du point de terminaison
• Testez les URL : Vérifiez que les URL sont accessibles avant l’enregistrement
• Documentez les points de terminaison : Conservez une documentation de vos points de terminaison

​

Authentification

• Utilisez OAuth lorsque c’est possible : Plus sécurisé que les clés API
• Limitez les scopes : Ne demandez que les permissions nécessaires
• Stockez de manière sécurisée : Les jetons sont gérés automatiquement
• Testez l’autorisation : Vérifiez que le flux OAuth fonctionne correctement

​

Gestion des erreurs

• Testez les connexions : Utilisez le bouton Test avant l’enregistrement
• Surveillez les journaux : Vérifiez les erreurs de connexion
• Gérez les échecs : Configurez des solutions de repli pour les serveurs critiques
• Désactivez les serveurs problématiques : Désactivez temporairement si nécessaire

​

Performance

• Limitez le nombre de serveurs : Trop de serveurs peuvent ralentir les agents
• Désactivez les serveurs inutilisés : Ne gardez que les serveurs actifs activés
• Optimisez les en-têtes : N’incluez que les en-têtes personnalisés nécessaires
• Surveillez les temps de réponse : Surveillez les réponses lentes des serveurs MCP

​

Dépannage

​

Échecs de connexion

• URL incorrecte
• Problèmes de connectivité réseau
• Serveur non démarré
• Pare-feu bloquant la connexion

• Vérifiez que l’URL est correcte et accessible
• Vérifiez la connectivité réseau
• Assurez-vous que le serveur est en cours d’exécution
• Vérifiez les règles du pare-feu

​

Erreurs d’authentification

• Scopes OAuth incorrects
• Le serveur ne prend pas en charge OAuth
• L’utilisateur n’a pas autorisé
• Jeton expiré

• Vérifiez que les scopes OAuth sont corrects
• Consultez la documentation OAuth du serveur
• Réautorisez la connexion
• Vérifiez les paramètres d’expiration des jetons

​

Outils indisponibles

• Le serveur est désactivé
• La connexion n’est pas établie
• Le serveur ne répond pas
• La découverte des outils a échoué

• Activez le serveur
• Testez la connexion
• Vérifiez que le serveur est en cours d’exécution
• Consultez les journaux du serveur

​

Erreurs de dépassement de délai

• Réponse lente du serveur
• Latence réseau
• Serveur surchargé
• Paramètres de délai incorrects

• Vérifiez les performances du serveur
• Vérifiez la vitesse du réseau
• Réduisez la charge du serveur
• Ajustez les paramètres de délai si configurables

​

Test des serveurs MCP

​

Test de connexion

1. Configurez votre serveur MCP
2. Cliquez sur le bouton Test
3. Attendez les résultats :
   • Succès : Indicateur vert avec message de succès
   • Erreur : Indicateur rouge avec détails de l’erreur

​

Résultats des tests

• Message de connexion réussie
• Le serveur répond correctement
• L’authentification fonctionne (le cas échéant)

• Dépassement de délai de connexion
• Échec d’authentification
• URL invalide
• Le serveur ne répond pas

​

Interprétation des résultats

✓ Connection successful
MCP server connection tested successfully

✗ Connection failed
Failed to connect to server: Connection timeout

​

Considérations de sécurité

​

Sécurité OAuth

• Stockage des jetons : Les jetons sont stockés de manière sécurisée
• Rafraîchissement des jetons : Rafraîchissement automatique des jetons lorsqu’ils expirent
• Limitation des scopes : Demandez les scopes minimum nécessaires
• Autorisation de l’utilisateur : Les utilisateurs doivent autoriser explicitement

​

En-têtes personnalisés

• Données sensibles : Ne mettez pas de données sensibles dans les en-têtes si possible
• Clés API : Utilisez OAuth lorsque c’est possible plutôt que des clés API
• Visibilité des en-têtes : Les en-têtes sont stockés dans la configuration
• Contrôle d’accès : Limitez qui peut voir/modifier les configurations MCP

​

Sécurité réseau

• HTTPS uniquement : Utilisez toujours HTTPS pour les serveurs en production
• Réseaux internes : Utilisez des URL internes pour les serveurs privés
• Règles de pare-feu : Configurez les pare-feu de manière appropriée
• Accès VPN : Utilisez un VPN pour des connexions sécurisées si nécessaire

​

Exemples

​

Exemple 1 : Intégration Sentry

{
  "server_name": "sentry",
  "transport": "streamable_http",
  "url": "https://mcp.sentry.dev/mcp",
  "auth_type": "oauth",
  "oauth_scopes": "org:read project:write team:write event:write",
  "enabled": true
}

• L’agent peut surveiller les erreurs
• Afficher les métriques de performance
• Gérer les projets Sentry

​

Exemple 2 : Intégration d’API personnalisée

{
  "server_name": "custom-api",
  "transport": "streamable_http",
  "url": "https://api.example.com/mcp",
  "auth_type": "oauth",
  "oauth_scopes": "read write",
  "headers": {
    "X-Client-ID": "your-client-id"
  },
  "enabled": true
}

• L’agent peut appeler des points de terminaison d’API personnalisés
• Accéder à des ressources protégées
• Utiliser des en-têtes personnalisés pour l’identification

​

Exemple 3 : Service interne

{
  "server_name": "internal-service",
  "transport": "streamable_http",
  "url": "http://internal-service:8000/mcp",
  "auth_type": "none",
  "headers": {
    "X-Internal-Key": "internal-key-value"
  },
  "enabled": true
}

• L’agent peut accéder aux services internes
• Aucun OAuth requis
• En-tête personnalisé pour l’authentification interne

​

Fonctionnalités associées

• Toolkits - Intégrations et outils intégrés
• Tools - Outils et actions personnalisés
• Agent Configuration - Configuration du comportement de l’agent
• API Integration - Connexion à des API externes

​

Support