Get Started

Connect your MCP-compatible application to Cumulus at https://mcp.sherweb.com.

Before you begin

An active Sherweb Cumulus partner account with API access
A compatible MCP host application
A Client ID and Client Secret from Cumulus API settings
The Cumulus permissions required for the information or action you need

For interactive sign-in, you will also need to register the redirect URI provided by your MCP host. Keep your Client Secret and access tokens private.

1. Create or select an API credential

Sign in to Cumulus and open Security > APIs.
Create an API credential or select an existing one.
Record the Client ID and store the Client Secret securely.
If you will use interactive sign-in, keep the host’s redirect URI available for registration.

See the Sherweb setup article for screenshots and Cumulus-specific instructions.

2. Configure your MCP host

Use the remote server URL https://mcp.sherweb.com. Follow your host’s current setup instructions and register the exact redirect URI it provides in Cumulus > Security > APIs.

VS Code and Cursor

Add the server to your MCP configuration, for example in .vscode/mcp.json:

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

When the host prompts you, complete authentication with your Cumulus API credentials. See the VS Code MCP documentation for host-specific details.

Microsoft Copilot Studio

Open your agent and select Tools > Add a tool > Add a new MCP.
Enter a server name and description, and set the server URL to https://mcp.sherweb.com.
Choose OAuth 2.0 with manual configuration and enter your Client ID and Client Secret.
Use these OAuth settings:

Setting	Value
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	`openid offline_access mcp:tools service-provider`

After creating the connection, register the redirect URI generated by Copilot Studio in Cumulus.
Authenticate and confirm that the agent discovers its available tools.

Other hosts

Claude Desktop, Claude Code, and other MCP-compatible hosts may work. Follow the host’s current remote MCP and OAuth instructions; configuration and redirect URI requirements vary by application and version.

3. Authenticate and test

Choose the authentication flow that matches your scenario:

Flow	Typical use	Redirect URI
Authorization Code with OIDC	Interactive user sessions	Required; register the host-provided URI in Cumulus.
Client Credentials	Automation or machine-to-machine workflows	Not required.

After sign-in, refresh or reconnect the host if needed. Start with a focused, read-only request, such as:

Which subscriptions are expiring within the next 30 days?
Show recent audit history for a specific subscription.
Summarize subscriptions for a specific organization.

Verify important results in Cumulus. For an overview, return to Overview. If something goes wrong, visit Troubleshoot.