Table des matières

1. Configuration étape par étape

     1.1. Créer ou mettre à jour une clé API avec des URI de redirection
     1.2. Enregistrer l’URL de redirection – AI RND – Confluence
     1.3. Choisir et configurer votre application hôte MCP
           a. Connecter Copilot Studio au serveur MCP
           b. Claude Code vers serveur MCP – AI RND – Confluence
           c. Exemple de configuration (VS Code / Cursor)
 

2. Que pouvez-vous faire ?
    2.1. Cas d’utilisation en lecture seule (disponibles maintenant)
    2.2. Cas d’utilisation en écriture (avec permissions appropriées)

1. Configuration étape par étape

1.1. Créer ou mettre à jour une clé API avec des URI de redirection

• Connectez-vous à Cumulus.

• Accédez à Platform Settings → APIs.

• Créez une nouvelle clé API ou sélectionnez-en une existante.

• Notez votre Client ID et votre Client Secret — vous en aurez besoin dans votre application hôte MCP.

• Ajoutez une ou plusieurs URI de redirection selon les exigences de l’application hôte choisie (voir l’étape 3 pour plus de détails).

💡 Conseil : Chaque application hôte peut nécessiter un format d’URI de redirection différent. Consultez la documentation MCP de l’application hôte pour connaître l’URI exacte à utiliser.

1.2. Enregistrer l’URL de redirection – AI RND – Confluence

• Accédez à votre compte partenaire Cumulus dans la section Security API :  https://cumulus.sherweb.com/partners/<partner-unique-name>/security/apis

• Dans le menu « Kebab », sélectionnez « Manage Redirect URIs ».

• Ajoutez l’URI de redirection.
   

1.3. Choisissez et configurez votre application hôte MCP

a. Connecter Copilot Studio au serveur MCP

Conditions préalables

1. Environnement Copilot Studio avec un assistant : Microsoft Copilot Studio | Créez vos assistants IA

2. Clés API dans Cumulus : Get Started

    

Étapes

1. Dans le menu de gauche, sélectionnez la section Agents.

2. Sélectionnez votre agent (par exemple, Demo Agent).

3. Accédez à l’onglet « Outils ».

4. Cliquez sur « Ajouter un outil ».

    

5.Cliquez sur « Protocole de contexte de modèles » (MCP). 

6. Remplissez le formulaire à l’aide de vos informations d’identification.

    a. Configuration du serveur MCP

 i. Informations de base

• Nom du serveur : au choix

• Description du serveur : au choix

• URL du serveur (⚠️ important) : https://mcp.sherweb.com

ii. Configuration de l’authentification 

1. Méthode sélectionnée : OAuth 2.0

2. Mode : Manuel

3. Configuration du client

• ID client : identifiant client provenant de la clé API publique créée dans Cumulus 

• Client Secret : secret correspondant

   

iii. Points de terminaison Oauth :

1. URL d’autorisation : https://cumulus.sherweb.com/oidc/connect/authorize

2. URL de jeton : https://cumulus.sherweb.com/oidc/connect/token

3. URL de rafraîchissement : https://cumulus.sherweb.com/oidc/connect/token

4. Étendue : mcp:tools service-provider

5. URL de redirection :

   1. Générée automatiquement par Copilot Studio après la création 

   2. Doit être configurée pour les informations d’identification client utilisées 

Exemple

Informations d’authentification

URL de redirection

b. Claude Code vers serveur MCP - AI RND - Confluence

Commande CLI pour ajouter le serveur

1. Exécutez cette commande en remplaçant par votre client-id et le port choisi :

claude mcp add --transport http --scope user --client-id <client-id> --client-secret --callback-port <callback-port> Sherweb-MCP https://mcp.sherweb.'com
 

2. L’utilisateur sera invité à saisir le client secret. 

3. Enregistrer l’URL de redirection (Étape 1.2).

4. Lancez une session Claude.

5. Exécutez /mcp.

   a. Dans MCP servers : sélectionnez Sherweb-MCP.

   b. Authentifiez-vous.

6. Copiez l’URL complète et collez-la dans un navigateur

Important : Il arrive que l’option de copie ne sélectionne pas l’URL complète. Utilisez votre souris pour vous assurer que toute l’URL est sélectionnée.

7. Succès

c. Exemple de configuration (VS Code / Cursor) 

{
"servers": {
"sherweb-cumulus": {
"type": "http",
"url": "https://mcp.sherweb.com"
}
}
}

2. Que pouvez-vous faire?

2.1. Cas d’utilisation en lecture seule (disponibles maintenant)

• « Lister toutes les souscriptions à renouveler dans les 60 prochains jours, y compris toute augmentation de prix. »
• « Donne-moi un aperçu de tous les frais pour l’organisation Contoso sur les 3 derniers mois. »
• « Quelles sont les organisations qui n’ont pas de produit de sauvegarde? »
• « Quelles sont mes 10 principales organisations en termes de revenus récurrents? »
• « Afficher toutes les souscriptions récemment annulées. »
• « Lister toutes les offres produits qui incluent une SKU Copilot. »
• « Quelles souscriptions expirent dans les 30 prochains jours pour toutes les organisations? »