> For the complete documentation index, see [llms.txt](https://docs.ovaledge.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ovaledge.com/release8.1/mcp-server/deployment-options/remote-mcp/set-up-claude-desktop-with-remote-mcp.md).

# 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](https://nodejs.org/en/download) 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**.

   <div align="left"><img src="/files/7xhLK5MjqRnXZEUqwYBY" alt="" height="167" width="624"></div>
3. Click the **9-Dot** menu icon, then select **Download User API Credentials**.

   <div align="left"><img src="/files/jmGfxGsBxdvFx2gnuL7P" alt="" height="151" width="624"></div>
4. Click **Download User API Credentials** in the confirmation dialog box.

   <div align="left"><img src="/files/zv77prBKiXWqjz1q0nA4" alt="" height="179" width="624"></div>
5. Navigate to the **Downloads** folder on the local system.

   <div align="left"><img src="/files/yMDwt7A3nOciY0rzifN1" alt="" height="47" width="624"></div>
6. Locate the downloaded `.credentials` file, right-click it, and select **Open with**.

   <div align="left"><img src="/files/ipxHrJeWFpjQGnYjXMbY" alt="" height="160" width="624"></div>
7. Select **Notepad** or any text editor.
8. Copy the generated **userToken** and **userSecret** values from the credentials file.

   <div align="left"><img src="/files/rrrfhmyk0uXfChyre4bf" alt="" height="64" width="624"></div>
9. Open the **Claude Desktop** application and click the **Settings** icon.

   <div align="left"><img src="/files/fyG8XAEMS3Ilz7NzcXkM" alt="" height="327" width="624"></div>
10. Click the **Developer** option, then the **Edit Config** option.

    <div align="left"><img src="/files/Iu5nhSOYFq4RXq9S29RK" alt="" height="328" width="624"></div>
11. Open the **Claude\_desktop\_config** file using Notepad or any text editor.

    <div align="left"><img src="/files/Ch7VPXxxzYHwYuiXdkoM" alt="" height="285" width="624"></div>
12. Add the Claude Config JSON file to the text editor.

    ```json
    {
      "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.

    <div align="left"><img src="/files/mIVhFyfxdSiWPN53Uhaf" alt="" height="353" width="624"></div>
14. Open the **Claude Desktop** application and navigate to **Settings > Developer > Edit Config**.

    <div align="left"><img src="/files/QZJJ8RmjOWlC7N4mg7bl" alt="" height="328" width="624"></div>

{% hint style="info" %}
The Remote MCP set is up and running.
{% endhint %}

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

    <div align="left"><img src="/files/gpn45GIZWw6R0iVw180L" alt="" height="253" width="624"></div>
16. Verify that Claude Desktop AI retrieves and displays metadata from the OvalEdge platform through the Remote MCP integration.

    <div align="left"><img src="/files/UmgPPLn8SckZlVIfwW6S" alt="" height="325" width="624"></div>

***

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ovaledge.com/release8.1/mcp-server/deployment-options/remote-mcp/set-up-claude-desktop-with-remote-mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.