---
title: "Cursor MCP servers for a team | Bombos"
description: "Cursor reads MCP servers from .cursor/mcp.json in the project or ~/.cursor/mcp.json globally. Enterprise adds an MCP allowlist; teams share servers."
image: "https://bombos.ai/assets/og-en-v2.png"
---

# How do you set up MCP servers in Cursor for a whole team?

Short answer

Cursor reads MCP servers from two files: .cursor/mcp.json in the project, which you can commit so the team shares it, and ~/.cursor/mcp.json in your home folder for yourself. It supports stdio, SSE and Streamable HTTP, OAuth for remote servers, and ${env:NAME} for secrets. Team admins can distribute shared servers; Enterprise admins can configure an MCP allowlist.

*Piet Baudoin · published November 17, 2026 · November 17, 2026*

## Two files, one for the team and one for you

Cursor keeps MCP configuration in plain JSON files.

| File | Applies to | Share it? |
| --- | --- | --- |
| `.cursor/mcp.json` in the project | Everyone who opens this project | Yes, commit it to the repo |
| `~/.cursor/mcp.json` in your home folder | All your projects | No, it is yours |

Each entry is a server. Cursor supports three transports:

| Transport | Runs | Configured with |
| --- | --- | --- |
| `stdio` | Locally, started and managed by Cursor, one user | A shell command |
| `SSE` | Local or remote, multiple users | A URL |
| `Streamable HTTP` | Local or remote, multiple users | A URL |

For remote servers Cursor handles OAuth: either the server registers Cursor dynamically, or you put a client ID, secret and scopes in an `auth` object. Sign-in uses the authorization code flow with PKCE, and Cursor renews tokens itself.

The same files work outside the editor. Cursor’s documentation says “MCP in the CLI uses the same configuration as the editor”, with the same order of precedence. In the terminal, `agent mcp list` shows which servers are configured and where each comes from, and `agent mcp list-tools <name>` shows what a server offers. A server the team commits to the repo is therefore available to everyone who runs Cursor’s agent in a terminal, too.

## Setting it up for a team, step by step

1.  **Pick remote servers where you can.** A remote server with OAuth means nobody has a key in a file, and everyone signs in as themselves. Many vendors run one: see [the GitHub MCP server](https://bombos.ai/en/questions/mcp/github-mcp-server/) or [the Notion MCP server](https://bombos.ai/en/questions/mcp/notion-mcp-server/).
2.  **Write `.cursor/mcp.json` in the repo** with the servers the project needs.
3.  **Keep secrets out.** Use `${env:NAME}` in `env`, `url` or `headers`, and let each developer set the variable. For local stdio servers you can point to an `envFile`.
4.  **Admins set the allowlist.** On Enterprise, go to **Team Settings > MCP Configuration** and allow servers by command or URL, and optionally by tool. Allowlisting does not install a server; it limits what is allowed to run.
5.  **Distribute shared servers.** Under **Dashboard > Plugins & MCPs** admins can make servers available to the team; Cursor notes these are available to Cloud Agents.
6.  **Decide on auto-run.** By default Cursor asks before every MCP tool call. If you switch to a run mode where allowlisted tools run without asking, make sure write tools are not on that list by accident.

Official integrations are also in the Cursor Marketplace, where “Add to Cursor” installs and signs in. Community servers are listed at cursor.directory; vet those as you would any third-party code, see [where to find trustworthy MCP servers](https://bombos.ai/en/questions/mcp/where-to-find-trustworthy-mcp-servers/).

## The common misunderstanding

“Our `.cursor/mcp.json` is in the repo, so everyone’s AI works the same.” Everyone’s AI has the same tools. The MCP config says nothing about what the agent knows or has learned; that lives in rules, AGENTS.md and Cursor’s own features, and project rules in `.cursor/rules` are shared only because someone wrote them down. See [Cursor memory was removed](https://bombos.ai/en/questions/cursor/cursor-memory-removed/) and [how to share Cursor context with your team](https://bombos.ai/en/questions/cursor/share-cursor-context-with-team/).

The other one: the file only works in Cursor. A teammate on Claude Code needs `.mcp.json`; one on Codex needs `config.toml`. Same servers, three files. See [MCP servers in Claude Code for a team](https://bombos.ai/en/questions/mcp/claude-code-mcp-servers-for-a-team/).

## What this means for a team

A committed `.cursor/mcp.json` plus an admin allowlist is a clean setup: the same tools for everyone, nothing unapproved. Keep the list short, because each server adds tools the model has to choose from. And treat the config as part of the codebase: review changes to it like you would review a new dependency.

## Where Bombos fits

Bombos connects to Cursor as one MCP server, and to Claude Code, Codex, Copilot and the other AI tools the same way, so every tool in the team reads and adds to one shared memory: team knowledge, rules the AI learned from corrections, and what already sits in repos, documents and mail, with a trail of what each answer rests on. It runs in our cloud or on your own server, and one developer can try it first with their own agents.

## Related questions

Where is the Cursor MCP config file?

Per project in .cursor/mcp.json, and globally in ~/.cursor/mcp.json in your home folder.

Does Cursor ask before it runs an MCP tool?

Yes, by default Cursor asks for approval before using MCP tools. MCP follows the same run modes as terminal commands; in Auto-review mode, allowlisted MCP tools run right away.

Can I use environment variables in Cursor's mcp.json?

Yes. Cursor resolves ${env:NAME}, ${workspaceFolder}, ${userHome} and a few others in command, args, env, url and headers. Local stdio servers can also load an envFile.

Can a Cursor admin restrict which MCP servers people use?

Yes, on Enterprise. Under Team Settings > MCP Configuration an admin sets an MCP allowlist by command, URL and tool. An allowlist does not install anything; it only limits what may run.

Does Cursor support MCP resources and prompts, or only tools?

Cursor's documentation lists tools, prompts, resources, roots, elicitation and the Apps extension as supported.

## Sources

1.  [Model Context Protocol (Cursor docs)](https://cursor.com/docs/context/mcp)
2.  [MCP in the Cursor CLI (Cursor docs)](https://cursor.com/docs/cli/mcp)

## What does your AI forget?

1.  01You tell us which AI you use and where it keeps starting over.
2.  02We show what a shared memory changes there, on your own examples.
3.  03You keep the plan, with or without Bombos.

![Piet Baudoin](https://bombos.ai/assets/team/piet-klein.jpg)

**Piet Baudoin**You talk to Piet, from the Bombos teamDutch team from Utrecht and Nijmegen · data in Europe

## More questions about MCP

-   [What is the Datadog MCP server and how do you set it up for a team?](https://bombos.ai/en/questions/mcp/datadog-mcp-server/)
-   [What is the GitHub MCP server and how should a team set it up?](https://bombos.ai/en/questions/mcp/github-mcp-server/)
-   [Does the Mem0 MCP server give a whole team shared AI memory?](https://bombos.ai/en/questions/mcp/mem0-mcp-server-vs-shared-team-memory/)
-   [What is the AWS MCP Server and how do you set it up safely?](https://bombos.ai/en/questions/mcp/aws-mcp-server/)
-   [How do you add MCP servers to Claude Code and share them with your team?](https://bombos.ai/en/questions/mcp/claude-code-mcp-servers-for-a-team/)
-   [What does the Figma MCP server give a coding agent, and which seat do you need?](https://bombos.ai/en/questions/mcp/figma-mcp-server/)
-   [What is the Filesystem MCP server and is it safe to use at work?](https://bombos.ai/en/questions/mcp/filesystem-mcp-server/)
-   [Is there an official Gmail and Google Workspace MCP server?](https://bombos.ai/en/questions/mcp/google-workspace-mcp-server/)

[All questions about MCP →](https://bombos.ai/en/questions/mcp/)


---

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://bombos.ai/#organization","name":"Bombos","url":"https://bombos.ai/","logo":"https://bombos.ai/assets/bombos-bee.png","description":"Bombos is the memory layer under every AI your team uses. One shared memory for Claude, ChatGPT, Copilot, Cursor and your own agents, that learns how you work.","sameAs":["https://www.linkedin.com/company/bombos-ai","https://www.youtube.com/@truebombos","https://www.instagram.com/truebombos/","https://bsky.app/profile/bombostrue.bsky.social","https://www.threads.com/@truebombos","https://mastodon.social/@Bombos","https://www.tiktok.com/@truebombos","https://t.me/truebombos","https://www.pinterest.com/truebombos/","https://github.com/bombos-ai","https://linktr.ee/bombos.ai","https://bombosai.substack.com","https://hashnode.com/@bombosai","https://hackernoon.com/u/bombos","https://dev.to/bombos"],"email":"info@bombos.ai","areaServed":["NL","Europe"],"knowsLanguage":["nl","en"],"contactPoint":{"@type":"ContactPoint","email":"info@bombos.ai","contactType":"sales","url":"https://bombos.ai/en/contact/","availableLanguage":["nl","en"]}},{"@type":"WebSite","@id":"https://bombos.ai/#website","name":"Bombos","url":"https://bombos.ai/","inLanguage":["nl-NL","en"],"publisher":{"@id":"https://bombos.ai/#organization"}}]}

{"@context":"https://schema.org","@type":"Article","headline":"How do you set up MCP servers in Cursor for a whole team?","description":"Cursor reads MCP servers from .cursor/mcp.json in the project or ~/.cursor/mcp.json globally. Enterprise adds an MCP allowlist; teams share servers.","abstract":"Cursor reads MCP servers from two files: .cursor/mcp.json in the project, which you can commit so the team shares it, and ~/.cursor/mcp.json in your home folder for yourself. It supports stdio, SSE and Streamable HTTP, OAuth for remote servers, and ${env:NAME} for secrets. Team admins can distribute shared servers; Enterprise admins can configure an MCP allowlist.","datePublished":"2026-11-17T00:00:00.000Z","dateModified":"2026-11-17T00:00:00.000Z","author":{"@type":"Person","name":"Piet Baudoin"},"publisher":{"@type":"Organization","@id":"https://bombos.ai/#organization","name":"Bombos","logo":{"@type":"ImageObject","url":"https://bombos.ai/assets/bombos-bee.png"}},"image":"https://bombos.ai/assets/og-en-v2.png","mainEntityOfPage":"https://bombos.ai/en/questions/mcp/cursor-mcp-server/","inLanguage":"en-US","isPartOf":{"@type":"CollectionPage","name":"MCP","url":"https://bombos.ai/en/questions/mcp/"},"citation":[{"@type":"CreativeWork","name":"Model Context Protocol (Cursor docs)","url":"https://cursor.com/docs/context/mcp"},{"@type":"CreativeWork","name":"MCP in the Cursor CLI (Cursor docs)","url":"https://cursor.com/docs/cli/mcp"}]}

{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Bombos","item":"https://bombos.ai/en/"},{"@type":"ListItem","position":2,"name":"Questions","item":"https://bombos.ai/en/questions/"},{"@type":"ListItem","position":3,"name":"MCP","item":"https://bombos.ai/en/questions/mcp/"},{"@type":"ListItem","position":4,"name":"How do you set up MCP servers in Cursor for a whole team?","item":"https://bombos.ai/en/questions/mcp/cursor-mcp-server/"}]}

{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Where is the Cursor MCP config file?","acceptedAnswer":{"@type":"Answer","text":"Per project in .cursor/mcp.json, and globally in ~/.cursor/mcp.json in your home folder."}},{"@type":"Question","name":"Does Cursor ask before it runs an MCP tool?","acceptedAnswer":{"@type":"Answer","text":"Yes, by default Cursor asks for approval before using MCP tools. MCP follows the same run modes as terminal commands; in Auto-review mode, allowlisted MCP tools run right away."}},{"@type":"Question","name":"Can I use environment variables in Cursor's mcp.json?","acceptedAnswer":{"@type":"Answer","text":"Yes. Cursor resolves ${env:NAME}, ${workspaceFolder}, ${userHome} and a few others in command, args, env, url and headers. Local stdio servers can also load an envFile."}},{"@type":"Question","name":"Can a Cursor admin restrict which MCP servers people use?","acceptedAnswer":{"@type":"Answer","text":"Yes, on Enterprise. Under Team Settings > MCP Configuration an admin sets an MCP allowlist by command, URL and tool. An allowlist does not install anything; it only limits what may run."}},{"@type":"Question","name":"Does Cursor support MCP resources and prompts, or only tools?","acceptedAnswer":{"@type":"Answer","text":"Cursor's documentation lists tools, prompts, resources, roots, elicitation and the Apps extension as supported."}}]}
```
