> 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/remote-oauth-mcp/set-up-claude-desktop-using-remote-oauth.md). # Set up Claude Desktop using Remote OAuth ## Scenario Use this procedure to connect the OvalEdge Remote MCP Server to Claude Desktop via OAuth. After the connection is established, Claude Desktop can securely access OvalEdge MCP tools without manually configuring local MCP server processes or API keys. {% hint style="info" %} * If Claude Desktop is already signed in, selecting Connect opens the authorization page directly. * If Claude Desktop is not signed in, the browser first redirects to the Okta sign-in page. After successful authentication, OAuth authorization continues automatically. {% endhint %} ### Steps Involved 1. Open **Claude Desktop**, click the **Profile** menu in the lower-left corner, and then select **Settings**. ![](https://1121831267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFZv5WsZmBfXjiJfMU2zR%2Fuploads%2F1FO788kvDWG0vF2fqd2L%2Funknown.png?alt=media\&token=337fe18c-2d9e-450a-ac3d-1f279ebd0ac9) 2. In the **Settings** window, select **Connectors** from the left navigation pane. ![](https://1121831267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFZv5WsZmBfXjiJfMU2zR%2Fuploads%2Foix8hdwRBW1n8HKWvFfQ%2Funknown.png?alt=media\&token=0101885e-61f6-4667-a09f-4e2cc12e498e) 3. Click the **Add** dropdown icon in the upper-right corner. ![](https://1121831267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFZv5WsZmBfXjiJfMU2zR%2Fuploads%2FDiM5t1yDmNoDPkFit7jO%2Funknown.png?alt=media\&token=bf34b1d4-3707-4689-9e39-a8f5b4b9b217) 4. Select **Add custom connector**. ![](https://1121831267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFZv5WsZmBfXjiJfMU2zR%2Fuploads%2FOCpJ62WQq7LRDQAgMBUn%2Funknown.png?alt=media\&token=1df2a7d1-9a87-4c37-b537-f0fee80fbcdc)

The Browse connectors option lists pre-built connectors. Select Add custom connector to configure the OvalEdge Remote MCP Server.

5. In the **Add custom connector** dialog, enter (Eg: **OvalEdge MCP OAuth**) as the connector name. ![](https://1121831267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFZv5WsZmBfXjiJfMU2zR%2Fuploads%2FxFpZNRcAQZIu9n7LYSX0%2Funknown.png?alt=media\&token=092f3c81-cc8d-4722-a7c0-df0d932b6555)

Server URL Remote MCP endpoint format: https://YOUR_PUBLIC_MCP_BASE_URL/mcp

6. In the **Server URL** field, enter the Remote MCP endpoint. Click **Add**. 7. When the connector is created, a **Connection issue** message appears because authentication has not yet been completed. Click **Connect**. ![](https://1121831267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFZv5WsZmBfXjiJfMU2zR%2Fuploads%2FjkAqg9sC82oXsCffxMk7%2Funknown.png?alt=media\&token=5570feab-5848-45e1-9855-2df9016da51f) 8. The default web browser opens and prompts to launch Claude Desktop. Optionally select **Always allow claude.ai to open links of this type in the associated app**, and then click **Open Claude**. ![](https://1121831267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFZv5WsZmBfXjiJfMU2zR%2Fuploads%2FhvWtdrE6WDIx1eeaMeeT%2Funknown.png?alt=media\&token=f91b3a55-934a-4ee9-a3bb-99297b055cbc) 9. If Claude Desktop is already authenticated, the OAuth authorization page opens directly. **OR** \ If Claude Desktop is not authenticated, the browser redirects to the **Okta** sign-in page. Sign in using the organization's Okta credentials to continue the OAuth authentication process. ![](https://1121831267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFZv5WsZmBfXjiJfMU2zR%2Fuploads%2F5qgFnRNLDogDFZ1SO3o3%2Funknown.png?alt=media\&token=4b1268b1-eb4d-4f04-8b3c-34481a50d7c8) 10. After authentication completes successfully, the browser automatically returns to Claude Desktop. ![](https://1121831267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFZv5WsZmBfXjiJfMU2zR%2Fuploads%2Fc34WT3VS0xILvInGcNS3%2Funknown.png?alt=media\&token=9a2dd846-f458-4b5e-962a-5998bbb96fe7) 11. Verify that the connector status changes to **Connected to OvalEdge MCP OAuth**. The connector details display the available OvalEdge MCP tools and their permission settings, confirming that the Remote MCP Server has been configured successfully. ![](https://1121831267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFZv5WsZmBfXjiJfMU2zR%2Fuploads%2FH02EzbvdTGlRPr6fcrMk%2Funknown.png?alt=media\&token=c70a7730-2261-4d92-a733-310f37b6376e) *** 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, and the optional `goal` query parameter: ``` GET https://docs.ovaledge.com/release8.1/mcp-server/deployment-options/remote-mcp/remote-oauth-mcp/set-up-claude-desktop-using-remote-oauth.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.