# All Hands AI

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:

```json
{
  "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](https://docs.openhands.dev/openhands/usage/settings/mcp-settings) from OpenHands.


---

# Agent Instructions: 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://www.cakewalk.security/docs/ai-agent-access/connections-and-integrations/agent-platforms/all-hands-ai.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.