Connexion à un serveur MCP à partir d’un client MCP

Connectez-vous à un Model Context Protocol serveur (MCP) à partir d’un client MCP en créant une intégration entrante OAuth et en configurant le client avec les détails du serveur.

Avec le serveur de démarrage rapide ou après avoir créé un serveur, vous pouvez effectuer les étapes suivantes pour vous connecter à un serveur à partir d’un client :

1. Créer une intégration entrante OAuth pour un client MCP
2. Configurer un client MCP pour se connecter à un serveur MCP

Le processus de configuration d’un client pour se connecter à un serveur dépend du client utilisé. Pour plus d’informations, consultez la documentation de votre application et de votre client IA.

Créer une intégration entrante OAuth pour un client MCP

Sécurisez l’accès aux serveurs (MCP) sur Model Context Protocol une instance en créant une intégration entrante OAuth pour chaque client MCP.

Avant de commencer

Rôle requis : oauth_admin, mi_admin, admin

Pourquoi et quand exécuter cette tâche

Pour chaque client auquel vous souhaitez accéder aux serveurs d’une instance, créez une intégration entrante OAuth dans la Console des identités des machines. Pour créer l’intégration OAuth, vous avez besoin d’une URL de redirection du client. Pour plus d’informations, consultez la documentation de votre application et de votre client IA.

Procédure

1. Accédez à la Tous > Console du serveur MCP.
2. Dans l’onglet Configuration, sélectionnez Serveurs.
3. Dans la bannière de configuration requise OAuth, sélectionnez Configurer OAuth.
   Vous pouvez également accéder à Tous > Console des identités des machines et sélectionnez l’onglet Intégrations entrantes .

   Remarque :

   Dans la liste des intégrations entrantes existantes, vous pouvez voir des intégrations créées avec les mêmes noms que les serveurs (y compris les traits de soulignement). Il s’agit d’intégrations destinées à surveiller les serveurs à partir de Tour de contrôle IA et ne doivent pas être utilisées pour s’intégrer aux clients.
4. Sélectionnez Nouvelle intégration.
5. Sélectionner OAuth : attribution du code d’autorisation.
6. Renseignez les champs requis du formulaire.
   Pour en savoir plus sur ce formulaire, reportez-vous à la section Configure an OAuth authorization code grant.

   Tableau 1. Formulaire d’intégration entrante

   Champ	Valeur
   Section Détails
   Nom	Saisissez un nom pour l’intégration OAuth.
   URL de redirection	Entrez l’URL de redirection pour un client. Le code d’autorisation est envoyé à cette URL après authentification. Pour obtenir l’URL de redirection, consultez la documentation de votre application et de votre client IA. Pour vous connecter au ServiceNow client MCP sur une autre instance, utilisez l’URL de redirection suivante : https://<client-instance>.service-now.com/oauth_redirect.do. Pour plus d’informations, consultez la Client Model Context Protocol documentation.
   Section du périmètre d’authentification
   Autoriser l’accès uniquement aux API dans le champ d’application sélectionné	Décochez la case pour élargir le champ d’application de l’intégration OAuth.
   Section des options avancées
   Format du jeton	Sélectionnez JWT.

7. Sélectionnez Enregistrer.
   L’intégration entrante OAuth est créée avec un champ d’application large avec un ID client et un secret client que vous utilisez lors de la configuration du client pour se connecter aux serveurs sur l’instance.

   

Que faire ensuite

Configurez le client pour qu’il utilise l’ID client et le secret client pour s’authentifier auprès des serveurs de l’instance.

Configurer un client MCP pour se connecter à un serveur MCP

Configurez un Model Context Protocol client (MCP) pour qu’il se connecte à un serveur MCP et invitez le serveur à effectuer une tâche.

Avant de commencer

Rôle requis : aucun

Pourquoi et quand exécuter cette tâche

Le processus de configuration d’un client pour se connecter à un serveur dépend du client utilisé. La procédure suivante est une vue d’ensemble de haut niveau du workflow pour configurer un client afin d’appeler un serveur. Pour plus d’informations, consultez la documentation de votre application et de votre client IA. Pour obtenir un exemple de connexion à partir d’un serveur sur une instance à une autre, reportez-vous à l’exemple ServiceNow Client Model Context Protocol suivant cette procédure.

Procédure

1. Configurez un client avec les détails du serveur requis tels que déterminés par le client.

   Tableau 2. Détails du serveur pour la configuration du client MCP

   Détails du serveur	Valeur
   URL serveur	https://<instance-serveur>.service-now.com/sncapps/mcp-server/mcp/<nom-serveur> Pour vous connecter au serveur de démarrage rapide préconfiguré, utilisez https://<server-instance>.service-now.com/sncapps/mcp-server/mcp/sn_mcp_server_default.
   Hôte	<instance-serveur>.service-now.com
   URL de base	/sncapps/mcp-server
   Périmètre	mcp_server
   Type d'authentification	OAuth 2.0
   Fournisseur d'identité	OAuth générique 2
   URL d'autorisation	https://<instance-serveur>.service-now.com/oauth_auth.do
   URL de jeton	https://<instance-serveur>.service-now.com/oauth_token.do
   URL de révocation du jeton	https://<instance-serveur>.service-now.com/oauth_revoke.do
   Actualiser l’URL	https://<instance-serveur>.service-now.com/oauth_auth.do
   URL de redirection	https://<instance-serveur>.service-now.com/oauth/callback
   ID client	ID client de l’intégration entrante OAuth sur l’instance de serveur.
   Secret client	Clé secrète du client issu de l’intégration entrante OAuth sur l’instance serveur.

   Après avoir configuré ces détails, le client appelle le serveur avec l’en-tête Autorisation : porteur <jeton> . Si le jeton est validé par le serveur, le client reçoit la liste des outils disponibles.

2. À partir du client, vous pouvez afficher la liste des outils disponibles pour déterminer comment inviter le serveur.
3. Saisissez une invite pour obtenir les informations dont vous avez besoin ou pour que l’outil effectue une action sur l’instance.

   Par exemple, si l’outil Rechercher des enregistrements d’incidents est disponible, vous pouvez saisir « Obtenir tous les incidents ouverts ». Avec l’outil de synthèse des tickets, vous pouvez saisir « Résumer tous les tickets fermés cette semaine ».

   Le serveur exécute les outils appropriés et renvoie le résultat au client sous forme de données JSON. Le client présente la réponse sous forme de texte formaté.

Connexion à un serveur MCP à partir de ServiceNow Client Model Context Protocol

Cet exemple montre comment se connecter à un serveur à partir d’un agent IA sur une autre instance à l’aide du ServiceNow Client Model Context Protocol. Tout d’abord, vous configurez le client pour qu’il appelle le serveur de démarrage rapide préconfiguré. À partir d’un agent IA, vous accédez à la liste d’outils du serveur de démarrage rapide et ajoutez des outils individuels à l’agent. Enfin, vous pouvez tester l’agent en Studio d'agents IA fournissant une invite et en voyant la réponse de l’agent. Pour plus d’informations, consultez la Client Model Context Protocol documentation.

Rôle requis : sn_mcp_client.admin

1. Sur l’instance serveur, créez une intégration entrante OAuth pour le ServiceNow Client Model Context Protocol fichier .

   Pour plus d'informations, consultez Créer une intégration entrante OAuth pour un client MCP.

2. Sur l’instance cliente, accédez à Tous > Studio d'agent IA > Paramètres.
3. Sélectionnez Gérer les serveurs MCP.
4. Sélectionnez Nouveau.
5. Ajoutez le serveur de démarrage rapide.

   Pour en savoir plus sur cette étape, reportez-vous à la section Ajouter un serveur MCP avec OAuth 2.1.

   1. Renseignez les champs du formulaire Ajouter un serveur MCP.

      Tableau 3. Formulaire Ajouter un serveur MCP

      Champ	Valeur
      Nom	Serveur de démarrage rapide
      Type d'authentification	OAuth 2.1
      URL du serveur MCP	https://<instance-serveur>.service-now.com/sncapps/mcp-server/mcp/sn_mcp_server_default

   2. Sélectionnez Suivant.
   3. Remplissez les champs du formulaire.

      Tableau 4. Formulaire Ajouter un serveur MCP

      Champ	Valeur
      Type d'inscription des clients	Inscription manuelle
      Type d'accord	Code d'autorisation
      Méthode d'authentification du jeton	Publication du secret client
      ID client	ID client de l’intégration entrante OAuth pour l’instance Client Model Context Protocol de serveur.
      Secret client	Clé secrète du client issu de l’intégration entrante OAuth pour l’instance Client Model Context Protocol de serveur.
      URL d'autorisation	https://<instance-serveur>.service-now.com/oauth_auth.do
      URL de jeton	https://<instance-serveur>.service-now.com/oauth_token.do
      URL de révocation du jeton	https://<instance-serveur>.service-now.com/oauth_revoke.do

   4. Sélectionnez Enregistrer.
6. Vérifiez la configuration OAuth.
   1. Sélectionnez Authentifier.
   2. Sélectionnez Autoriser pour permettre au client de se connecter au serveur.
7. Ajoutez des outils du serveur de démarrage rapide à un agent IA.

   Pour en savoir plus sur cette étape, reportez-vous à la section Ajouter un MCP outil serveur à un agent IA.

   1. Dans Studio d'agents IA, sélectionnez l’onglet Créer et gérer .
   2. Dans l’onglet Agents IA, sélectionnez un agent existant ou créez-en un.

      Pour en savoir plus sur la création d’un agent, reportez-vous à la section Créer un agent IA.

   3. Sélectionnez Ajouter des outils et des informations.
   4. Sélectionner Ajouter un outil > Outil de serveur MCP.
   5. Remplissez les champs du formulaire.

      Tableau 5. Formulaire Ajouter un Model Context Protocol outil

      Champ	Valeur
      Sélectionner un Model Context Protocol serveur	Serveur de démarrage rapide
      Sélectionner un outil	Sélectionnez les outils du serveur de démarrage rapide que vous souhaitez utiliser avec cet agent IA.

      

   6. Sélectionnez Ajouter.
   7. Sélectionnez Enregistrer et continuer.
8. Testez l’agent IA.

   Pour en savoir plus sur cette étape, reportez-vous à la section Tester un agent IA.

   1. Dans Studio d'agents IA, sélectionnez l’onglet Test .
   2. Sélectionnez Démarrer le test manuel.
   3. Dans le champ Choisir un type de test, sélectionnez Agent IA ou Workflow.
   4. Sélectionnez l’agent IA que vous avez configuré et sa version.
   5. Dans le champ Tâche, saisissez une invite pour obtenir des informations ou effectuer une action sur l’instance.

      L’invite doit être basée sur les outils disponibles. Par exemple, si vous avez ajouté les outils Rechercher des enregistrements de tickets et Synthèse de tickets, vous pouvez saisir « Résumer tous les tickets fermés cette semaine ».

      

   6. Sélectionnez Continuer pour tester la réponse de la messagerie instantanée.

   L’agent IA appelle le serveur, et le serveur exécute les outils demandés en fonction de l’invite. Le serveur renvoie les informations à l’agent sous forme de données JSON, qui les présente sous forme de texte formaté. Dans cet exemple, l’agent renvoie des résumés des tickets fermés par Abel Tuter au cours de la semaine écoulée.