ConnectChats

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

  1. 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.
  2. Add the server

    Paste this, or add the connectchats entry inside your existing mcpServers object:

    {
      "mcpServers": {
        "connectchats": {
          "url": "https://api.connectchats.com/mcp"
        }
      }
    }
  3. 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.

  4. 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

  1. 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."
  2. 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

  1. Create a ConnectChats account

    Open https://connectchats.com/app and sign in with a passkey. There is no email or password to remember.

  2. 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.

  3. 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.

  4. Add the server

    Add the mcp.json entry above with https://api.connectchats.com/mcp and sign in.

Tips

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

Stop switching apps. Ask your AI instead.

Add ConnectChats in one click. Your first two chat apps are free.

Get started free