Claude Desktop

Connect Claude Desktop to BlueNexus so Claude can access your users' services.

Option 1: Streamable HTTP (Recommended)

Add BlueNexus as a Streamable HTTP MCP server in Claude Desktop's settings.

Using OAuth (Automatic)

In Claude Desktop, go to Settings > MCP Servers and add a new server:

• Type: Streamable HTTP
• URL: https://api.bluenexus.ai/mcp

Claude Desktop will automatically handle the OAuth flow:

1. It fetches /.well-known/oauth-protected-resource to discover the auth server
2. Registers itself via Dynamic Client Registration
3. Opens a browser window for the user to authorize
4. Exchanges the code for tokens and starts making requests

No configuration files needed — Claude Desktop handles everything.

Using a Personal Access Token

If you prefer to skip the OAuth flow (e.g., for testing), use a Personal Access Token:

1. Go to app.bluenexus.ai > Settings > Sessions
2. Create a token with scope universal-mcp-read-write
3. Add to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "bluenexus": {
      "type": "streamable-http",
      "url": "https://api.bluenexus.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
}

Option 2: Using the MCP SDK (npx)

If your version of Claude Desktop requires a command-based MCP server:

{
  "mcpServers": {
    "bluenexus": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.bluenexus.ai/mcp"
      ]
    }
  }
}

This uses the mcp-remote package to proxy the Streamable HTTP connection. The OAuth flow will open in your browser automatically.

Connecting Services

After authentication, go to app.bluenexus.ai > Connections to connect services (Google Workspace, Slack, GitHub, etc.). Each connection you add becomes available to Claude through the use-agent tool.

Testing

Ask Claude something that requires your connected services:

"What meetings do I have today on Google Calendar?" "Create a GitHub issue titled 'Fix login bug' in the myapp repo" "Show me unread Slack messages from the #engineering channel"

Claude will use the use-agent tool to delegate these tasks to the BlueNexus agent, which routes them to the correct service.

Troubleshooting

"Tool call failed" errors: Check that the relevant service is connected in your BlueNexus dashboard. Go to Connections and verify the status is active.

Authentication fails: If using a PAT, ensure it has the universal-mcp-read-write scope. If using OAuth, try disconnecting and reconnecting the BlueNexus MCP server in Claude Desktop settings.

Missing services: The use-agent tool can only access services the user has connected. Use the list-connections tool to see what's available.