GitHubDashboard
AI Tooling

Cursor Integration

Configure Cursor to use Squidward as your governed MCP gateway. All AI-assisted coding requests will be routed through Squidward for policy enforcement and audit logging.

Policy Enforcement

All MCP calls from Cursor are governed by your organization's policies.

Full Visibility

Every tool invocation is logged with context for audit and analytics.

Zero Friction

One-time setup. All approved MCPs work seamlessly through Cursor.

Quick Setup

1

Generate a Cursor configuration

Use the CLI or dashboard to generate a ready-to-use configuration:

squidward config generate --client cursor
bash
2

Open Cursor Settings

In Cursor, go to Settings → MCP Servers or press Cmd/Ctrl + ,

3

Add Squidward configuration

Paste the following configuration into your MCP servers config:

{
  "mcpServers": {
    "squidward": {
      "url": "https://gateway.squidward.app/mcp",
      "headers": {
        "Authorization": "Bearer ${SQUIDWARD_TOKEN}"
      }
    }
  }
}
json
4

Set your token

Add your Squidward token to your environment:

export SQUIDWARD_TOKEN=mcp_live_xxxxxxxxxxxxxxxx
bash

Tip: Add this to your .zshrc or .bashrc for persistence.

Done! Start using governed MCPs

Restart Cursor. All your approved MCPs are now available through Squidward.

One-Command Setup

The CLI can automatically configure Cursor for you:

# Auto-configure Cursor with Squidward
squidward config install --client cursor

# This will:
# 1. Detect your Cursor installation
# 2. Generate the MCP configuration
# 3. Add it to your Cursor settings
# 4. Prompt you to set the token
bash

How It Works

Cursor
Squidward Gateway
Provider MCP

1. Cursor sends MCP requests to Squidward instead of directly to providers.

2. Squidward authenticates the request using your token.

3. Policies are evaluated against the request context.

4. If approved, Squidward forwards the request to the provider using secure credentials.

5. The response is logged and returned to Cursor.

Accessing Multiple MCPs

Squidward exposes all your approved provider MCPs through a single gateway. You don't need to configure each provider separately in Cursor.

// Available through Squidward (if connected and approved):
- GitHub: search_repos, create_issue, create_pull_request
- Vercel: list_projects, get_deployment, view_logs
- Supabase: query_database, list_tables, run_migration
- Figma: get_file, export_assets, get_comments
- Context7: search_docs, get_library_docs
plaintext

Connect providers in the Squidward dashboard to make them available in Cursor.

Policy Behavior in Cursor

Allowed Actions

Requests that match an allow policy proceed normally. Cursor receives the response from the provider MCP.

Denied Actions

Requests that match a deny policy return an error response with the denial reason and policy name. Cursor will display this to the user.

{
  "error": "policy_denied",
  "reason": "Creating issues in production repos requires approval",
  "policy": "prod-write-approval",
  "recommendations": [
    "Use the staging repository instead",
    "Request approval from a security reviewer"
  ]
}
json

Troubleshooting

Squidward not appearing in Cursor

1. Make sure you restarted Cursor after adding the configuration.

2. Check that your SQUIDWARD_TOKEN environment variable is set.

3. Verify the configuration JSON is valid (no trailing commas).

Authentication errors

1. Verify your token is valid: squidward tokens verify

2. Check the token hasn't expired in the dashboard.

3. Ensure the token has the required scopes for the MCP you're using.

Provider not available

1. Connect the provider in the Squidward dashboard.

2. Verify the provider connection is healthy (not expired).

3. Check that your user role has access to the provider MCP.

Next Steps