> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metal.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Other MCP clients

> Connect any MCP-compatible tool to the Metal MCP server.

Any tool that supports remote MCP servers can connect to Metal at:

```
https://mcp.metal.ai/mcp
```

The server uses streamable HTTP transport and OAuth authentication. Make sure an organization admin has [enabled MCP](/mcp/overview#prerequisites) first.

## Clients that support remote MCP

Add the URL using the client's standard MCP configuration. Most clients accept an entry like:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "mcpServers": {
    "metal": {
      "url": "https://mcp.metal.ai/mcp"
    }
  }
}
```

On first use, the client opens a browser window to sign in with your Metal account.

## VS Code (GitHub Copilot)

Add a `.vscode/mcp.json` file to your workspace:

```json .vscode/mcp.json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "servers": {
    "metal": {
      "type": "http",
      "url": "https://mcp.metal.ai/mcp"
    }
  }
}
```

Open the MCP view, start the **metal** server, and complete the browser sign-in.

## Clients that only support local (stdio) servers

Some clients can only launch a local command. Bridge to the hosted server with [`mcp-remote`](https://www.npmjs.com/package/mcp-remote):

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "mcpServers": {
    "metal": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.metal.ai/mcp"]
    }
  }
}
```

`mcp-remote` handles the OAuth flow and forwards requests to the Metal MCP server.

## Troubleshooting

* **Authentication loops or fails**: confirm an admin enabled MCP under **Settings → Organization → API & MCP Access**.
* **Tools don't appear**: verify the URL includes the `/mcp` path and that your client supports remote (HTTP) MCP servers, or use the `mcp-remote` bridge above.

See the [tools reference](/mcp/tools-reference) for parameters and response examples, and the [overview](/mcp/overview) for shared troubleshooting.
