Skip to content
← All articles

How to Add an MCP Server to Cursor

Cursor reads servers from mcp.json, per project or global; remote ones take a url and headers. Add an MCP server to Cursor and debug it in MCP Logs.

John Guerrero, with a beard and round glassesBy John GuerreroUpdated November 9, 2026
Abstract illustration: an editor with a side panel where a new tool docks next to the agent

Frequently asked questions

Where does Cursor store its MCP configuration?

In an mcp.json file. According to Cursor's documentation, .cursor/mcp.json in a project gives you tools for that project only, and ~/.cursor/mcp.json in your home directory makes them available everywhere.

How do I add a remote MCP server with an API key?

Add an entry under mcpServers with a url and a headers object. Remote servers use HTTP or SSE, so they take a url instead of a command. Put the key in the Authorization header and read it from an environment variable.

Can I use environment variables in mcp.json?

Yes. Cursor documents interpolation in the command, args, env, url and headers fields, with the syntax ${env:NAME}. If the variable is not expanded and the server returns a 401, paste the key in its place and keep that file out of git.

How do I turn a server on or off?

Open Customize in Cursor's sidebar, find the server and use its toggle. Cursor says you can toggle servers on and off without removing them.

Does Cursor ask before using an MCP tool?

By default, yes. The documentation says Cursor asks for approval before using MCP tools, and you can click the arrow next to the tool name to see its arguments. Read the arguments before you approve anything that publishes.

Where do I find the MCP logs if the server fails?

Open the Output panel with Cmd+Shift+U (Ctrl+Shift+U on Windows and Linux) and choose MCP Logs from the dropdown. If the logs show a 401, check the key. If they show a 403, the key lacks a scope for that action.

Can Cursor use Clautia's MCP server today?

Yes. Clautia documents an mcp.json entry for Cursor. You create an API key in Clautia, set it as CLAUTIA_API_KEY and add the entry below. Cursor then sees the same ten actions as Claude Code and Codex.