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.
All MCP calls from Cursor are governed by your organization's policies.
Every tool invocation is logged with context for audit and analytics.
One-time setup. All approved MCPs work seamlessly through Cursor.
Quick Setup
Generate a Cursor configuration
Use the CLI or dashboard to generate a ready-to-use configuration:
squidward config generate --client cursorOpen Cursor Settings
In Cursor, go to Settings → MCP Servers or press Cmd/Ctrl + ,
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}"
}
}
}
}Set your token
Add your Squidward token to your environment:
export SQUIDWARD_TOKEN=mcp_live_xxxxxxxxxxxxxxxxTip: 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 tokenHow It Works
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_docsConnect providers in the Squidward dashboard to make them available in Cursor.
Policy Behavior in Cursor
Requests that match an allow policy proceed normally. Cursor receives the response from the provider MCP.
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"
]
}Troubleshooting
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).
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.
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.