How to Use Local MCP

Step 1: Enable Local MCP in Pixso Desktop

1. Install and sign in to Pixso desktop (version >= 2.2.0)
2. Create or open a design file in Pixso desktop
3. In the file menu (top-left), find and enable Pixso MCP

After enabling Pixso MCP successfully, you will see a confirmation message at the bottom of the canvas.

The local endpoint of Pixso MCP server is: http://127.0.0.1:3667/mcp

Step 2: Configure in Your MCP Client

Claude Code (CLI)

Run this command in terminal:

claude mcp add --transport http pixso-desktop http://127.0.0.1:3667/mcp

Cursor

1. Open Cursor -> Cursor Settings -> MCP & Integrations
2. In MCP Tools, click New MCP Server
3. Use any name (for example Pixso MCP), select sse or http, and set URL to http://127.0.0.1:3667/mcp
4. Or edit mcp.json directly:

   {
     "mcpServers": {
       "Pixso MCP": {
         "url": "http://127.0.0.1:3667/mcp",
         "headers": {}
       }
     }
   }

5. Save and click start in the settings panel

Cline (VS Code and others)

1. In Cline sidebar, click MCP Servers (or click "Configure MCP Servers" under Configure tab)
2. It opens cline_mcp_settings.json
3. Add an SSE server config:

   {
     "mcpServers": {
       "pixso-mcp": {
         "type": "streamableHttp",
         "url": "http://127.0.0.1:3667/mcp"
       }
     }
   }

4. Save the file, and Cline will connect automatically

Trae IDE

Trae v1.3.0+ supports MCP natively.

1. Configure project-level .trae/mcp.json or global ~/.cursor/mcp.json (Trae-compatible directory)
2. Add an SSE MCP service:

   {
     "mcpServers": [
       {
         "name": "pixso",
         "url": "http://127.0.0.1:3667/mcp",
         "type": "sse"
       }
     ]
   }

3. Restart Trae or refresh in MCP panel

Kiro

1. Open Kiro config: global ~/.kiro/settings/mcp.json or workspace .kiro/settings/mcp.json
2. Add Pixso MCP config:

   {
     "mcpServers": {
       "pixso-mcp": {
         "url": "http://127.0.0.1:3667/mcp"
       }
     }
   }

3. (Optional) Add "autoApprove": ["getCode", "getNodeDSL"] to reduce permission prompts, then reload Kiro

Windsurf

1. Open Windsurf settings -> MCP Servers -> Manage MCPs
2. Click View raw config to open mcp_config.json
3. Add config:

   {
     "mcpServers": {
       "pixso": {
         "serverUrl": "http://127.0.0.1:3667/mcp"
       }
     }
   }

4. Refresh in settings panel; a green status means connected

Step 3: Chat in MCP Client

After your MCP client is connected to Pixso MCP server, you can start using it in conversations.

Pixso MCP supports two ways to get design data:

Copy Layer Link

Notes

The layer link is not a file share link and not a page link.

The item-id in the link helps the agent locate the exact target layer.

1. Open a design file in Pixso desktop
2. Select a container layer and copy its layer link
3. In your IDE client (such as Cursor), paste the link in chat and provide instructions (for example: generate HTML code)

Paste the link into the agent chat box.

Select Container on Canvas

1. Open a design file in Pixso desktop
2. Select a single container layer on the canvas
3. In your IDE client (such as Cursor), start chatting (for example: generate HTML code)

Notes

1. To keep MCP connection stable:
2. Keep Pixso desktop open
3. Keep the design file tab containing the selected container active
4. Use advanced models (such as Claude-4.6-sonnet)