Skip to main content

Documentation index: llms.txt. This page is also available as markdown: append .md to this URL or send Accept: text/markdown.

Integrate Claude with Transform MCP

Claude Desktop and Claude Code can connect to the hosted Transform MCP server over HTTP. After setup, Claude can list Projects, inspect runs, and perform other actions your Coalesce account allows.

For token and endpoint details, see Configure Transform MCP.

Prerequisites​

You need:

  • A Coalesce refresh token from the Deploy tab or COA ~/.coa/config
  • Your Coalesce App host URL, the same host you sign in to
  • Claude Desktop or Claude Code with MCP support

Transform MCP uses token authentication only. OAuth is not supported.

Claude Desktop​

Claude Desktop reads MCP servers from claude_desktop_config.json.

Open the Configuration File​

  1. In Claude Desktop, go to Settings.
  2. Select the Developer tab.
  3. Click Edit Config.

File locations:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Add Transform MCP​

Add a coalesce-transform entry under mcpServers. Replace <your-app-host> and <your-refresh-token>.

Claude Desktop configuration
{
  "mcpServers": {
    "coalesce-transform": {
      "type": "http",
      "url": "https://<your-app-host>/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <your-refresh-token>"
      }
    }
  }
}

Restart and Verify​

  1. Save the file and quit Claude Desktop completely.
  2. Reopen Claude Desktop. An MCP indicator should appear when the server connects.
  3. Ask: List Coalesce projects in this organization.

Claude Code​

Claude Code reads MCP servers from .mcp.json at your project root, or from user-level config when you use the CLI.

Option 1: CLI Registration​

With Claude Code open, run:

claude mcp add --transport http coalesce-transform "https://<your-app-host>/api/v1/mcp" --header "Authorization: Bearer <your-refresh-token>"

Option 2: Project .mcp.json​

Create or edit .mcp.json at your repository root:

Claude Code project configuration
{
  "mcpServers": {
    "coalesce-transform": {
      "type": "http",
      "url": "https://<your-app-host>/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <your-refresh-token>"
      }
    }
  }
}

Claude Code picks up .mcp.json on startup. Ask a Coalesce question to confirm the connection.

Project Versus User Config

The claude mcp add command may write to user-level config at ~/.claude.json rather than the project .mcp.json. For team-shared setup, commit .mcp.json without secrets and inject the token from your environment.

Troubleshooting​

SymptomWhat to check
Authentication errorRe-copy the token from the Deploy tab. Confirm the header is Bearer <token>.
Server not listedRestart Claude after editing the config file.
Tools not calledAsk explicitly: Use the coalesce-transform MCP server to list environments.

For more errors, see Transform MCP Troubleshooting.

What's Next?​