Adding the Ezurio MCP Server to Claude Desktop

Adding the Ezurio MCP Server to Claude Desktop

Overview

Claude Desktop supports remote MCP servers via Custom Connectors (Settings → Connectors). This is the recommended method for connecting to a hosted, remote MCP server such as the Ezurio MCP server. Custom Connectors use the Streamable HTTP transport with OAuth authentication and are available on Pro, Max, Team, and Enterprise plans.

Method 1: Custom Connector (Recommended for Remote MCP)

Step 1 – Open Claude Desktop Settings

1. Open the Claude Desktop application.
2. On macOS: click Claude in the menu bar and select Settings…
3. On Windows: click your profile icon or use the application menu, then select Settings.

Step 2 – Navigate to Connectors

1. In the Settings panel, click Connectors in the left-hand sidebar.
2. Click Add custom connector (this button appears at the top-right of the Connectors section).

Step 3 – Enter the MCP Server Details

1. In the New Connector dialog, fill in the following fields:

   • Name:Ezurio MCP (or any descriptive label you prefer)
   • Description:Ezurio MCP Server
   • MCP Server URL: Enter MCP Server URL: https://mcp.ezurio.com/ez/mcp
2. Set the Authentication mode to OAuth if prompted.
3. If prompted, check the acknowledgement that you trust this connector.
4. Click Add or Save.

Step 4 – Authenticate

1. After saving, Claude Desktop will initiate the authentication flow for the connector.
2. Follow any prompts to complete authentication (OAuth login) as directed by your administrator.

Step 5 – Verify the Connection

1. Open a new chat in Claude Desktop.
2. Look for the hammer (🔨) icon at the bottom of the chat window — a number next to it indicates how many MCP tools are available.
3. Click the hammer icon to confirm that Ezurio MCP tools appear in the list.

Method 2: JSON Configuration File (Local/stdio Servers Only)

This method is for advanced users running a local MCP proxy or bridge. It does not apply to the hosted Ezurio MCP server unless specifically instructed by your administrator.

1. Open Claude Desktop Settings → Developer → Edit Config. This opens the file claude_desktop_config.json at:
   • macOS:~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows:%APPDATA%\Claude\claude_desktop_config.json
2. Add an entry to the mcpServers object. For a remote server bridged via mcp-remote:
   

   {
     "mcpServers": {
       "ezurio-mcp": {
         "command": "npx",
         "args": [
           "mcp-remote",
           "https://mcp.ezurio.com/ez/mcp"
         ]
       }
     }
   }

3. Save the file.
4. Fully quit Claude Desktop (do not just close the window) and reopen it.
5. Verify using the hammer icon in a new chat as described in Method 1, Step 5.

Troubleshooting