All Hands AI

Add Cakewalk's MCP Gateway to OpenHands from the Settings > MCP page. OpenHands uses the FastMCP library to auto-initiate the OAuth flow on first agent use.

OpenHands reads remote MCP servers from the Settings > MCP page. Add Cakewalk's gateway and OpenHands auto-initiates OAuth via the FastMCP library on the first agent use.

Install Method

Custom form on the Settings > MCP page. OpenHands stores OAuth tokens locally at ~/.fastmcp/oauth-mcp-client-cache/.

Step 1: Open MCP Settings

1. Open OpenHands.

2. Go to Settings.

3. Open MCP.

Step 2: Add the Cakewalk Gateway

Add a server entry with the following values (UI field labels may differ from the underlying config keys):

• Server URL: https://mcp-gateway.getcakewalk.io/mcp

• Transport: http

• Auth: oauth

Save the configuration.

Step 3: Authenticate on First Agent Use

OpenHands initiates the OAuth flow when the agent first attempts to use a Cakewalk tool. A browser window opens automatically. Sign in with your Cakewalk account and approve the Connection. OpenHands stores the credentials at ~/.fastmcp/oauth-mcp-client-cache/.

Verifying It Works

Ask the agent in OpenHands to list its available tools. The tools surfaced through the Cakewalk gateway appear in the response. In Cakewalk, the OpenHands card on My Agents flips to Connected after the first agent call.

Configuration Equivalent

If you prefer to edit the underlying configuration directly instead of the UI, the equivalent shape is:

{
  "mcpServers": {
    "cakewalk": {
      "url": "https://mcp-gateway.getcakewalk.io/mcp",
      "transport": "http",
      "auth": "oauth"
    }
  }
}

Troubleshooting

• Browser does not open on first agent call: OpenHands relies on a local browser handler. If you are running OpenHands headless, the OAuth flow will fail to launch. Run OpenHands in an environment with a browser, complete the OAuth once, then redeploy with the cached token at ~/.fastmcp/oauth-mcp-client-cache/.

• Tools do not appear: confirm the configuration shape uses transport: "http" and auth: "oauth". Other transport values default to stdio, which is incompatible with Cakewalk's remote gateway.

Learn more

• MCP settings from OpenHands.