Set up Claude Desktop with Remote MCP

Scenario

If Users want to set up the OvalEdge Remote MCP Server with the Claude Desktop AI Tool to enable AI-assisted metadata discovery, catalog search, glossary exploration, lineage analysis, profiling insights, and governed data exploration from OvalEdge. As a prerequisite, ensure Node.js is installed on the machine for npx to run.

Steps Involved

1. Log in to the OvalEdge application.

2. Click the Profile icon in the top-right corner and click My Profile.

   
3. Click the 9-Dot menu icon, then select Download User API Credentials.

   
4. Click Download User API Credentials in the confirmation dialog box.

   
5. Navigate to the Downloads folder on the local system.

   
6. Locate the downloaded .credentials file, right-click it, and select Open with.

   
7. Select Notepad or any text editor.

8. Copy the generated userToken and userSecret values from the credentials file.

   
9. Open the Claude Desktop application and click the Settings icon.

   
10. Click the Developer option, then the Edit Config option.

    
11. Open the Claude_desktop_config file using Notepad or any text editor.

    
12. Add the Claude Config JSON file to the text editor.

    Copy

    {
      "mcpServers": {
        "ovaledge-mcp-remote": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://YOUR_OvalEdge_MCP_ENDPOINT/mcp",
            "--header",
            "X-OvalEdge-Token:Your OvalEdge User Token",
            "--header",
            "X-OvalEdge-Secret:Your OvalEdge User Secret"
          ]
        }
      }
    }

    1. Add the MCP Remote URL in the mcp-remote placeholder. Note: Insert the OvalEdge instance server URL (Amazon AWS)

    2. Add the copied “X-OvalEdge Token” and “X-OvalEdge Secret” in the Credentials JSON file.

13. Click Exit to exit the Claude application.

    
14. Open the Claude Desktop application and navigate to Settings > Developer > Edit Config.

    

1. Enter a metadata retrieval prompt such as Retrieve metadata from "Customer" Table? and click Send.

   
2. Verify that Claude Desktop AI retrieves and displays metadata from the OvalEdge platform through the Remote MCP integration.

   

Copyright © 2026, OvalEdge LLC, Peachtree Corners, GA, USA.