Cursor Integration

Cursor has excellent MCP support and provides the best Pointa experience. The server starts automatically when you open Cursor.

Setup Steps

Step 1: Open Cursor Settings

  1. Open Cursor
  2. Go to Settings (Cmd/Ctrl + ,)
  3. Click Cursor Settings in the left sidebar

Step 2: Navigate to Tools & Integrations

  1. Click the Tools & Integrations tab
  2. Scroll to the MCP Servers section

Step 3: Add MCP Server

  1. Click + Add new global MCP server
  2. Paste this configuration:
{
  "mcpServers": {
    "pointa": {
      "command": "npx",
      "args": ["-y", "pointa-server"]
    }
  }
}
  1. Click Save

Step 4: Restart Cursor

Close and reopen Cursor to apply the changes.

Verify Connection

After restarting:

  1. Open a project
  2. Open the Cursor Agent (Cmd/Ctrl + I)
  3. Look for Pointa tools in the available tools list

You should see:

  • read_annotations
  • mark_annotations_for_review
  • read_issue_reports
  • And other Pointa tools

Using Pointa with Cursor

Reading Annotations

Ask Cursor to implement your annotations:

  • "Implement the Pointa annotations"
  • "Check Pointa for feedback and implement it"
  • "Work on the pending annotations"

Cursor will:

  1. Call read_annotations to get your feedback
  2. Find the relevant code files
  3. Make the requested changes
  4. Mark annotations as "in-review"

Working with Bug Reports

For bugs:

  • "Check Pointa for bug reports"
  • "Investigate the bug reported in Pointa"
  • "Fix the Pointa bug report"

Design Mode Changes

After using Design Mode:

  • "Implement the design changes from Pointa"
  • "Apply the CSS changes I made in Pointa"

Cursor-Specific Tips

Use Composer Mode

Cursor's Composer (Cmd/Ctrl + Shift + I) works great with Pointa:

  1. Open Composer
  2. Ask to implement annotations
  3. Review changes across multiple files

Reference Specific Annotations

You can be specific:

  • "Implement only the button color annotation"
  • "Skip the header change, just do the footer"

Batch Processing

Add multiple annotations, then ask Cursor to implement them all at once for efficiency.

Troubleshooting

Server not starting

Check if the server is running:

npx pointa-server status

If not running:

npx pointa-server start

Tools not appearing

  1. Ensure configuration is saved correctly
  2. Restart Cursor completely (quit and reopen)
  3. Check for JSON syntax errors in configuration

Connection issues

Make sure port 4242 is available:

lsof -i :4242

If another process is using it, stop it or configure a different port.

Alternative Configuration

If the auto-start approach doesn't work, use manual start:

  1. Start server manually:

    npx pointa-server start

  2. Use URL-based configuration:

    {
  "mcpServers": {
    "pointa": {
      "url": "http://127.0.0.1:4242/mcp"
    }
  }
}

Related