Skip to main content

​
Quick Start

​
Prerequisites

  • Node.js 18+ installed
  • Tagada Studio open in your browser (CRM embedded or standalone)
No API key or store ID is needed. The MCP server connects directly to your open Studio editor via WebSocket — it doesn’t call any TagadaPay API.

​
Setup for Cursor

Add this to .cursor/mcp.json in your project (or in your global Cursor settings): 
{
  "mcpServers": {
    "tagada-studio": {
      "command": "npx",
      "args": ["@tagadapay/studio-mcp"]
    }
  }
}
That’s it. Cursor will start the MCP server automatically.

​
Setup for Claude Desktop

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json: 
{
  "mcpServers": {
    "tagada-studio": {
      "command": "npx",
      "args": ["@tagadapay/studio-mcp"]
    }
  }
}
Restart Claude Desktop after saving.

​
Manual start (any MCP client)

If your tool doesn’t auto-start MCP servers, run it manually: 
npx @tagadapay/studio-mcp
The server starts on port 14333 by default and prints the endpoints it’s listening on. Configure your MCP client to connect to the SSE endpoint shown in the output.

​
Verify the connection

​
1. Check the MCP server

Visit the /health endpoint in your browser (e.g., http://localhost:14333/health). You should see: 
{
  "status": "ok",
  "server": "tagada-studio-mcp",
  "studioConnected": true
}
If studioConnected is false, make sure Tagada Studio is open in your browser.

​
2. Check Studio

When connected, you’ll see a green Agent badge in the Studio toolbar:
Agent

​
Your first edit

With both sides connected, ask the agent:
“Show me the page structure”
The agent will call view_tree and display the node hierarchy. Then try:
“Change the main heading to ‘Hello World’”
You’ll see the heading update live on the Studio canvas.

​
Options

OptionDefaultDescription
--port <port>14333HTTP/WebSocket port
--help—Show help

​
Custom WebSocket URL

By default, Studio connects to the MCP server running on your machine. To use a different URL (e.g., when using a tunnel), add ?agentWs=ws://your-url/ws to the Studio URL.

​
Next steps