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
     1.3. Choisir et configurer votre application hôte MCP
           a. Connecter Copilot Studio au serveur MCP
           b. Claude Code vers serveur MCP
           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

• 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

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. »
• « 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? »