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.

In this article
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.
Related articles
- MCP and agentsBest MCP Servers for Marketing in 2026Seven servers, from Google Analytics and HubSpot to Klaviyo and Metricool, checked against vendor docs (9 Nov 2026). The best MCP servers for marketing.Read the article
- MCP and agentsClaude Code Pricing: Plans and Costs (2026)Claude Code has no price of its own: it comes with a paid Claude plan or API billing. Here is what Pro, Max, Team and the API cost, checked on 9 Nov 2026.Read the article
- MCP and agentsClaude Code vs Codex vs Cursor: Which to ChoosePick by where you work: the terminal, OpenAI's ecosystem or an editor with the agent built in. Claude Code vs Codex vs Cursor, compared from their docs.Read the article
Put it into practice
- The Agentic Social Media ManagerSchedule social media posts with CursorThe documented setup adds the Clautia MCP server to Cursor's mcp.json, so the Cursor agent can draft, adapt and schedule posts for your brands.Read the guide
- Features and networksSocial media MCP server and API: let your AI agent do the legworkConnect Claude Code, Codex, Cursor or another MCP-compatible agent to Clautia with an API key. Draft, schedule and manage posts by MCP or REST API.Read the guide
- The Agentic Social Media ManagerSchedule social media posts with Claude CodeConnect Clautia MCP to Claude Code. Your agent drafts and schedules posts on 10 networks (Google Business Profile included) from the terminal.Read the guide

