How-to guide
How to add an MCP server to Cursor
Cursor reads MCP servers from an mcp.json file, for all projects or for one. A remote server needs only its URL, and Cursor handles the OAuth sign-in.
Last checked November 2026
Add a remote MCP server to mcp.json
-
Open the config file
- Global: ~/.cursor/mcp.json, used in every project.
- Project: .cursor/mcp.json at the root of the repo, shared through git.
-
Add the server
Paste this, or add the connectchats entry inside your existing mcpServers object:
{ "mcpServers": { "connectchats": { "url": "https://api.connectchats.com/mcp" } } } -
Save and sign in
Cursor picks up the change. Open the MCP server list (under Customize in current versions, Cursor Settings in older ones), find connectchats and sign in. Cursor opens your browser for OAuth.
-
Check the tools
The server shows its tools once it is connected. Use its toggle to switch a server off without deleting it.
Use it in the agent
-
Ask in the Agent chat
- "What did the team say in the WhatsApp release group today?"
- "Find the error message Marco pasted in our chat yesterday."
-
Approve tool calls
Cursor asks before it runs an MCP tool unless you set that tool to run automatically.
If the server does not connect
Open the Output panel, choose MCP Logs and look for the server's error. Most failures are a typo in the URL or a sign-in that did not finish.
Example: your WhatsApp chats in Cursor
-
Create a ConnectChats account
Open https://connectchats.com/app and sign in with a passkey. There is no email or password to remember.
-
Link WhatsApp
Choose Link a chat app, then WhatsApp. Scan the QR code from WhatsApp on your phone (Linked devices, then Link a device), or switch to Use a pairing code.
-
Choose the chats your AI can read
Chats appear on the Chats page as they import. Turn on only the ones you want your AI app to see.
-
Add the server
Add the mcp.json entry above with https://api.connectchats.com/mcp and sign in.
Tips
- A remote server needs no command or args, only url.
- Keep secrets out of a project mcp.json you commit. ConnectChats uses OAuth, so the file holds no token.
- For a server that takes an API key, add a headers object next to url.
Questions
Where is mcp.json in Cursor?
~/.cursor/mcp.json for servers you want everywhere, and .cursor/mcp.json inside a project folder for that project only.
Does Cursor support remote MCP servers with OAuth?
Yes. Cursor reads the server's OAuth metadata, registers itself and opens a browser window for you to sign in.
Can I share the setup with my team?
Yes, commit .cursor/mcp.json. Each person still signs in with their own account, so nobody sees anyone else's chats.
Related pages
More guides
- Add an MCP server to Claude Code One claude mcp add command, scopes, OAuth with /mcp, list and remove.
- Add an MCP server to Codex codex mcp add with --url, the config.toml block and codex mcp login.
- Add an MCP server to ChatGPT Custom MCP plugins on the web, which plans allow them, and how to call one in a chat.
Connect your chats
More on ConnectChats
Stop switching apps. Ask your AI instead.
Add ConnectChats in one click. Your first two chat apps are free.
Get started free