Table of Contents
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.
- Go to your cumulus partners Account into security API. https://cumulus.sherweb.com/partners/<partner-unique-name>/security/apis
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:
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
Server Name: whatever you like
Server Description: whatever you like
Server URL (⚠️ Important: https://mcp.sherweb.com)
ii. Authentication Configuration
Selected method: OAuth 2.0
Mode: Manual
Client configuration
a. Client ID: client ID from the public API key created in Cumulus
b. Client Secret: corresponding secret
iii. OAuth Endpoints:
Authorization URL: https://cumulus.sherweb.com/oidc/connect/authorize
Token URL: https://cumulus.sherweb.com/oidc/connect/token
Refresh URL: https://cumulus.sherweb.com/oidc/connect/token
Scopes: mcp:tools service-provider
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.
