Guides · Cursor
How to add an MCP server to Cursor
Cursor supports stdio, SSE and Streamable HTTP servers. You can install from the Cursor Marketplace, or configure any server yourself in an mcp.json file.
Steps summarize the official docs linked below, checked 2026-10-19. Client UIs change; if a menu name differs, the linked docs win.
1. Choose where the config lives
Project: .cursor/mcp.json in the repository. Global: ~/.cursor/mcp.json in your home directory, for servers you want everywhere.
2. Add a remote server
A remote (HTTP or SSE) server only needs its URL. Example with the AgentTask Atlas catalog server, which needs no auth:
{ "mcpServers": { "agenttask-atlas": { "url": "https://agenttaskatlas.com/api/mcp" } } }3. Add a local stdio server
Give the command, its arguments and any environment variables the server's README asks for.
{ "mcpServers": { "server-name": { "command": "npx", "args": [ "-y", "mcp-server" ], "env": { "API_KEY": "${env:API_KEY}" } } } }4. Keep secrets out of the file
Cursor resolves ${env:NAME}, ${userHome} and ${workspaceFolder} in command, args, env, url and headers, so tokens can come from your shell environment.
{ "mcpServers": { "remote-server": { "url": "https://api.example.com/mcp", "headers": { "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}" } } } }5. Use and debug
Cursor lists the tools under Available Tools and asks for approval before running them by default. If a server fails, open the Output panel and pick MCP Logs. Toggle servers on and off from Customize in the sidebar.
Good to know
- OAuth servers can use static client credentials in an auth object when the provider does not support dynamic client registration.
- envFile is only available for stdio servers.
Sources
26 catalog entries with documented Cursor setup
From the AgentTask Atlas catalog: entries whose official README or docs include setup instructions for Cursor.
- GitHub MCP Server · GitHub · needs credentials
Pick it for issues, PRs and Actions from the agent; limit toolsets or use read-only mode for review tasks. - Playwright MCP · Microsoft · no credentials
Pick it to let the agent drive a real browser for E2E checks; it can reach any site the browser can. - Sentry MCP · Sentry · needs credentials
Pick it to debug production errors from Sentry inside the agent; needs Sentry OAuth or a user token. - Stripe MCP / Agent Toolkit · Stripe · needs credentials
Pick it to inspect or create Stripe objects; use the remote server with OAuth and a restricted scope. - Supabase MCP · Supabase · needs credentials
Pick it for Supabase SQL and migrations; use the documented read-only and project-scoped modes. - Cloudflare MCP servers · Cloudflare · needs credentials
Pick it for Workers, observability and Cloudflare docs; each remote server uses its own OAuth scopes. - Context7 · Upstash · credentials optional
Pick it for up-to-date library docs in prompts; queries go to Context7's hosted service. - AWS MCP Servers · AWS Labs · needs credentials
Pick the specific AWS server you need; the docs server needs no credentials, others use your IAM profile. - Terraform MCP Server · HashiCorp · credentials optional
Pick it for Terraform Registry lookups; add TFE_TOKEN only if you need HCP Terraform workspaces. - Grafana MCP · Grafana Labs · needs credentials
Pick it to query dashboards, Prometheus and Loki from the agent; needs a Grafana service account token. - Chrome DevTools MCP · Chrome DevTools (Google) · no credentials
Pick it for performance traces, network and console debugging; it exposes browser content to the client. - MongoDB MCP Server · MongoDB · needs credentials
Pick it for MongoDB or Atlas queries; enable the documented read-only mode for exploration. - Neon MCP Server · Neon · needs credentials
Pick it to manage Neon branches and run SQL; it acts with your account's rights. - Notion MCP Server · Notion · needs credentials
Pick it to read/write Notion specs; it only sees pages shared with the integration. - Docker MCP Gateway · Docker · credentials optional
Pick it to run several MCP servers in containers; permissions depend on the servers you enable. - Firecrawl MCP Server · Firecrawl · needs credentials
Pick it for crawling and scraping at scale; URLs are sent to Firecrawl's hosted API with your key. - Elasticsearch MCP Server (deprecated) · Elastic · needs credentials
Avoid for new setups: the official README marks it deprecated; use it only on existing installs. - Netlify MCP Server · Netlify · needs credentials
Pick it to build and deploy Netlify sites from the agent; it authenticates with your Netlify account. - Heroku Platform MCP Server · Heroku · needs credentials
Pick it to manage Heroku apps from the agent; the README recommends `heroku mcp:start` so you don't expose an API key. - Atlassian Rovo MCP Server · Atlassian · needs credentials
Pick it when the agent must read or update Jira issues, Confluence pages or Bitbucket repos; the README recommends the v2 endpoint for new setups. - Next.js DevTools MCP · Vercel · no credentials
Pick it to let the agent read live errors, routes and logs from a running Next.js 16+ dev server; it needs `npm run dev` running. - SonarQube MCP Server · SonarSource · needs credentials
Pick it if your project already runs on SonarQube Cloud or Server and you want the agent to read issues and quality gates during review; set SONARQUBE_READ_ONLY=true for review-only use. - Microsoft Learn MCP Server · Microsoft · no credentials
Pick it when the agent writes Azure, .NET or other Microsoft code and should look up current official docs and samples; it needs no credentials. - Buildkite MCP Server · Buildkite · needs credentials
Pick it to let the agent investigate failed Buildkite builds and logs; use the read-only endpoint unless you want it to retry jobs or start builds. - Datadog MCP Server · Datadog · needs credentials
Pick it to investigate production issues from the agent using your Datadog account; OAuth keeps access within your existing RBAC. - Figma MCP Server · Figma · needs credentials
Pick it to pull design context into code or (in beta) write back to the Figma canvas; you need a Figma account and a client that supports remote Streamable HTTP.
Ask the catalog from inside Cursor: the AgentTask Atlas MCP server is free, read-only and needs no account.
Compare by task: Databases & SQL · Infra & deploy · Debugging & observability · Library docs & research · Frontend & UI · Docs & writing
⚠ No independent security audit: entries summarize official sources only. Review permissions and code before installing.