Claude Code

Add Cakewalk's MCP Gateway to Claude Code with one claude mcp add command. OAuth runs the first time you connect.

Claude Code uses the claude mcp add command to register MCP servers. One command points Claude Code at the Cakewalk gateway. OAuth runs in your browser on the first connection.

Install Method

CLI command. Claude Code stores the server config in ~/.claude.json (local or user scope) or .mcp.json in the project root (project scope).

Step 1: Run claude mcp add

In your terminal, run:

claude mcp add --transport http cakewalk https://mcp-gateway.getcakewalk.io/mcp

By default this registers the server at local scope: available only in the current project, private to you, stored in ~/.claude.json.

To change scope, add the --scope flag:

• Project scope (shared via Git):

  claude mcp add --transport http cakewalk https://mcp-gateway.getcakewalk.io/mcp --scope project

  Stored in .mcp.json in the project root. Anyone who clones the project inherits the server.

• User scope (cross project, personal):

  claude mcp add --transport http cakewalk https://mcp-gateway.getcakewalk.io/mcp --scope user

  Stored in ~/.claude.json. Available in every project you open.

Step 2: Authenticate

Start a Claude Code session in the project where you added the server. Run:

/mcp

Claude Code lists the cakewalk server and shows that authentication is required. Follow the prompt to open the OAuth flow in your browser. Sign in with your Cakewalk account and approve the Connection. Tokens are stored securely and refreshed automatically.

Verifying It Works

Run claude mcp list from your terminal to confirm cakewalk appears. Inside a Claude Code session, run /mcp to see live status and the tool count for the server. In Cakewalk, the Claude Code card on My Agents flips to Connected after the first agent call.

Troubleshooting

• Server is missing from /mcp: confirm the scope. A server added at local scope inside one project does not appear in others. Run the claude mcp add command again at the right scope, or use --scope user for cross project availability.

• OAuth callback fails: if the browser redirect errors out after sign in, copy the full callback URL from your browser's address bar and paste it back into the Claude Code prompt. Claude Code recovers the flow from the pasted URL.

• "Incompatible auth server" error: Cakewalk's gateway supports the standard MCP OAuth flow. If you see this error, confirm the gateway URL is correct and report it.

Removing the Connection

Run claude mcp remove cakewalk to deregister the server. To revoke the OAuth token without removing the server, use the in-session /mcp menu and pick Clear authentication.

Learn more

• Connect Claude Code to tools via MCP from Anthropic.