Home / Integrations

Set up in 2 minutes

Works with Cursor, Windsurf, and any MCP-compatible IDE.
One config file. Zero hassle.

Supported Integrations

Cursor

Full MCP integration with Codesona rules

Verified ⏱️ 2 min setup
Setup Guide

Windsurf

Native Codesona support via MCP

Verified ⏱️ 2 min setup
Setup Guide

Any MCP IDE

Works with all Model Context Protocol IDEs

Community ⏱️ 5 min setup
Custom Setup
1

Get your API key

Sign up at codesona.dev and generate your API key from Settings → API Keys

Your API Key
cdsn_1234567890abcdefghijklmnop
2

Open Cursor Settings

Go to Cursor → Settings → MCP Servers or press Cmd+, and search for "MCP"

3

Add Codesona MCP Server

Create or edit your mcp.json file:

mcp.json 
{
  "mcpServers": {
    "Codesona": {
      "url": "https://mcp.codesona.ai/sse",
      "transport": "sse",
      "headers": {
        "Authorization": "ApiKey your_api_key_here"
      }
    }
  }
}
4

Restart Cursor

Quit and reopen Cursor. You should see a "Codesona MCP Connected" badge in your editor.

Connected to Codesona
1

Install Codesona Extension

Open Windsurf Extensions panel and search for "Codesona". Click Install.

2

Configure API Key

After installation, click the Codesona icon in the sidebar and paste your API key:

API Key
cdsn_1234567890abcdefghijklmnop
3

Verify Connection

The status bar should show "Codesona: Connected". Start coding and your rules will be enforced automatically!

Troubleshooting

Solution:

  1. Make sure you have Node.js 18+ installed: node --version
  2. Check your mcp-config.json syntax (use a JSON validator)
  3. Try running npx @codesona/mcp-server manually to see error details
  4. Restart your IDE after making config changes

Solution:

  1. Verify your API key starts with cdsn_
  2. Regenerate your key at codesona.dev/settings/api-keys
  3. Make sure there are no extra spaces or line breaks in your config
  4. Check that your subscription is active

Solution:

  1. Verify MCP is connected (check status bar)
  2. Make sure you have at least one active rule in your Codesona dashboard
  3. Check rule scope - rules may be filtered by file type or directory
  4. Try triggering AI code generation to see if rules are applied
  5. Check the Codesona logs: ~/Library/Logs/Codesona/mcp.log

Solution:

  1. Check your internet connection
  2. Reduce the number of active rules (we recommend max 50 per project)
  3. Update to the latest MCP server: npx @codesona/mcp-server@latest
  4. Check Codesona status page: status.codesona.dev

Ready to set up Codesona?

Start your 7-day free trial and connect your IDE in under 2 minutes

Get Started