Connecting to the MCP Server

This guide covers how to connect popular MCP clients to the Revel Digital MCP Server.

Server Endpoints

Transport URL Use When
Streamable HTTP https://mcp.reveldigital.io/mcp Recommended for most clients
SSE https://mcp.reveldigital.io/sse For clients that only support SSE

Authentication Flow

All connections use OAuth 2.0. When you first connect:

  1. Your MCP client sends a request to the server
  2. The server returns a 401, prompting your client to start the OAuth flow
  3. A browser window opens to the Revel Digital login page
  4. You sign in with your Revel Digital credentials
  5. After successful login, the browser redirects back and your client receives an access token
  6. All subsequent tool calls use this token automatically

No manual API key configuration is required.

Claude Desktop

Add the following to your Claude Desktop MCP configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "revel-digital": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.reveldigital.io/mcp"
      ]
    }
  }
}

Restart Claude Desktop after saving. A browser window will open for authentication on first use.

Note: Claude Desktop uses mcp-remote as a local proxy to connect to remote MCP servers. Make sure you have Node.js 18+ installed.

Claude Code (CLI)

Claude Code supports remote MCP servers natively. Add the server in your project or global settings:

claude mcp add revel-digital --transport http https://mcp.reveldigital.io/mcp

Or add it to your .mcp.json file:

{
  "mcpServers": {
    "revel-digital": {
      "type": "url",
      "url": "https://mcp.reveldigital.io/mcp"
    }
  }
}

Cursor

  1. Open Settings > MCP Servers
  2. Click Add Server
  3. Set the URL to https://mcp.reveldigital.io/mcp
  4. Select Streamable HTTP as the transport type
  5. Click Save

A browser window will open for authentication when you first use a Revel Digital tool.

Windsurf

Add the server in your Windsurf MCP configuration:

  1. Open Settings > MCP
  2. Add a new remote server with URL https://mcp.reveldigital.io/mcp
  3. Save and connect

VS Code (Copilot)

Add the following to your VS Code settings.json:

{
  "mcp": {
    "servers": {
      "revel-digital": {
        "type": "http",
        "url": "https://mcp.reveldigital.io/mcp"
      }
    }
  }
}

Or use the mcp-remote proxy approach:

{
  "mcp": {
    "servers": {
      "revel-digital": {
        "type": "stdio",
        "command": "npx",
        "args": [
          "mcp-remote",
          "https://mcp.reveldigital.io/mcp"
        ]
      }
    }
  }
}

ChatGPT Desktop

ChatGPT Desktop supports remote MCP servers:

  1. Open Settings > Tools & Plugins > MCP Servers
  2. Click Add Server
  3. Enter the URL: https://mcp.reveldigital.io/mcp
  4. Authenticate via the browser when prompted

Cloudflare AI Playground

  1. Visit playground.ai.cloudflare.com
  2. Paste https://mcp.reveldigital.io/mcp as the MCP server URL
  3. Click Connect
  4. The playground handles OAuth natively

MCP Inspector (Debugging)

The MCP Inspector is a browser-based tool for testing and debugging MCP servers.

npx @modelcontextprotocol/inspector@latest https://mcp.reveldigital.io/mcp

Then open http://localhost:5173 in your browser:

  1. Verify the transport is set to Streamable HTTP
  2. Click OAuth Settings and enable Quick OAuth Flow
  3. Click Connect
  4. After authenticating, click List Tools to see all available tools

Custom MCP Clients

If you’re building your own MCP client, connect to:

The server implements the full MCP specification with OAuth 2.1 authentication. Key headers:

Header Description
Authorization Bearer <token> from the OAuth flow
mcp-session-id Session identifier (returned by server, must be sent on subsequent requests)
Content-Type application/json

Refer to the MCP specification for full transport details.

Troubleshooting

“Connection Error - Check if your MCP server is running”

Make sure you’re using the correct transport type (Streamable HTTP vs SSE) and the correct URL path (/mcp or /sse).

“Mcp-Session-Id header is required”

You’re connecting with SSE transport to the Streamable HTTP endpoint (/mcp). Either switch to Streamable HTTP transport or use the /sse endpoint.

CORS errors in the browser

The server includes CORS headers for all origins. If you see CORS errors, ensure your client is sending requests to the correct endpoint and not being blocked by a browser extension.

OAuth login loop

Clear your browser cookies for mcp.reveldigital.io and id.reveldigital.com, then try connecting again.

Back to Home