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 Cursor with Transform MCP

Cursor can connect to the hosted Transform MCP server so Agent can list Projects, inspect runs, and call other tools within your Coalesce permissions.

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
  • Cursor with MCP support enabled

Configure Transform MCP in Cursor​

Step 1: Open MCP Settings​

In Cursor, go to Settings > Tools & MCP > New MCP server.

Step 2: Edit mcp.json​

Create or edit ~/.cursor/mcp.json. Add a coalesce-transform entry. Replace <your-app-host> and <your-refresh-token>.

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

Step 3: Restart Cursor​

Restart Cursor so it loads the new MCP configuration.

Step 4: Verify in Agent​

Open Cursor Agent and ask:

List Coalesce projects using Transform MCP.

You should see Projects from your organization. If the assistant answers from general knowledge instead of calling tools, name the server explicitly in your prompt.

Project-Level Configuration​

Some teams commit a project-level .cursor/mcp.json for shared server URLs. Do not commit refresh tokens. Use environment-specific secrets or local overrides for the Authorization header.

Troubleshooting​

SymptomWhat to check
Failed to connectConfirm the URL is https://<your-app-host>/api/v1/mcp with the host you sign in to.
401 UnauthorizedRegenerate or re-copy the token from the Deploy tab.
Tools not usedReference the server by name: Search Coalesce Transform MCP for…

For more errors, see Transform MCP Troubleshooting.

What's Next?​