Views:

 

Table of Contents

1. Step-By-Step Setup

1.1. Create or Update an API Key with Redirect URI(s)
1.2. Register redirect URL - AI RND - Confluence
1.3. Choose and Configure Your MCP Host Application
a. Connect Copilot Studio to MCP Server
b. Claude Code to MCP Server - AI RND - Confluence 
c. Configuration Example (VS Code / Cursor)
 

2. What Can You Do?
2.1. Read-Only Use Cases (Available Now)
2.2. Write Use cases (w/ appropriate permissions)

 

1. Step-By-Step Setup

1.1. Create or Update an API Key with Redirect URI(s)

  • Log in to Cumulus.

  • Navigate to Platform Settings → APIs.

  • Create a new API key or select an existing one.

  • Note your Client ID and Client Secret — you'll need them in your MCP host application.

  • Add one or more Redirect URI(s) as required by your chosen host application (see Step 3 for specifics).

💡 Tip: Each host application may require a different redirect URI format. Consult the host application's MCP documentation for the exact URI to use.

1.2. Register redirect URL - AI RND - Confluence


Prerequire: Have the redirect URL you need to register to your client.

  • In the “Kebab menu” select “Manage Redirect URIs“

 

  • Add the redirect URI.
     

 

 

1.3. Choose and Configure Your MCP Host Application

The Cumulus MCP Server is compatible with any application that supports the MCP protocol. Here are the tested options:

 
 

 

Host Application

 

Best For

 

Notes

 

Microsoft Copilot Studio

MSP-friendly, no-code agent building

Ideal for building custom agents with your Cumulus data

Claude Desktop

General-purpose AI assistant

Add via Claude's MCP server configuration

VS Code (GitHub Copilot extension)

Developers, technical users

Add the MCP server in your mcp.json or VS Code settings

Cursor

Developers, AI-first IDE users

Native MCP support

 

a. Connect Copilot Studio to MCP Server

Prerequisites

  • Copilot Studio environment with an agent: Microsoft Copilot Studio | Create AI Agents

  • API Keys from Cumulus: Get Started

 

Steps


1. In Agents navigation section

2. Select your agent ( ie : Demo Agent )

3. Naviguate to Tools Tab

4. Click on “Add a tool”

 

5. Click on “Add new MCP”

 

6. Fill the form using your credentials and Information

    a. MCP Server Configuration

i. Basic Information

  1. Server Name: whatever you like

  2. Server Description: whatever you like

  3. Server URL (⚠️ Important: https://mcp.sherweb.com)

ii. Authentication Configuration

  1. Selected method: OAuth 2.0

  2. Mode: Manual

  3. Client configuration

a. Client ID: client ID from the public API key created in Cumulus

b. Client Secret: corresponding secret

iii. OAuth Endpoints:

  1. Authorization URL: https://cumulus.sherweb.com/oidc/connect/authorize

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

  3. Refresh URL: https://cumulus.sherweb.com/oidc/connect/token

  4. Scopes: mcp:tools service-provider

  5. Redirect URL:

a. Generated automatically by Copilot Studio after creation

b. Must be configured for the client credentials you used

Example

Basic information                                                                                                     Authentication Information Redirect URI

 

 

b. Claude Code to MCP Server - AI RND - Confluence

CLI Command to Add Server

Prerequire: Claude code app and an active Claude subscription.

1. Run this comment with your client-id and the chosen port.

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

2. The user will be prompt to enter the client secret.

3. Register redirect URL (Step 1.2).

4. Launch a Claude session.

5. Run /mcp

   a. In the Manage MCP servers: select the Sherweb-MCP

  b. Authenticate

6. Copy the full URL and past it in a browser

Important: Sometime the copy option does not select the full url. Use your mouse

7. Success

c. Configuration Example (VS Code / Cursor)

Add the following to your MCP configuration file (e.g., .vscode/mcp.json): {
"servers": {
"sherweb-cumulus": {
"type": "http",
"url": "https://mcp.sherweb.com"
}
}
}

 

When prompted, enter your Client ID, Client Secret, and set the Redirect URIs documented at MCP developer guide | Visual Studio Code Extension API in cumulus

2. What Can You Do?

2.1. Read-Only Use Cases (Available Now)

Ask your AI assistant questions like:

  • "List all subscriptions up for renewal in the next 60 days, including any price increases."

  • "Give me a breakdown of all charges for organization Contoso over the last 3 months."

  • "Which of my organizations don't have a backup product?"

  • "What are my top 10 organizations by recurring revenue?"

  • "Show me all recently cancelled subscriptions."

  • "List all product offers that include a Copilot SKU."

  • "What subscriptions are expiring within 30 days across all organizations?"

2.2. Write Use Cases (w/appropriate permissions)

Future write capabilities will include:

  • Amend subscription license counts

  • Cancel subscriptions

  • Place new orders

  • Configure platform settings for an organization

⚠️ Human-in-the-Loop:

  • MCP server requires a one-time session consent for reads.

  • MCP client is responsible for the write operations consents: it depends on the client's capabilities.