Паветта
Как подключить MCP-сервер к Cursor
Cursor читает MCP-серверы из mcp.json: глобального в домашней папке или проектного в .cursor. Поддерживаются stdio, SSE и Streamable HTTP, удалённые серверы умеют вход через OAuth.
Где лежит конфиг
~/.cursor/mcp.jsonДля всех проектов.cursor/mcp.jsonДля одного проектаКак добавить сервер
1
Из каталога
Откройте Customize, найдите сервер и нажмите Add to Cursor. Если серверу нужен вход, Cursor откроет авторизацию через OAuth.
2
Через файл, локальный сервер
В mcp.json внутри mcpServers задайте command, args и при необходимости env. В таблице полей указан и type со значением "stdio".
3
Через файл, удалённый сервер
В mcpServers задайте url и, если нужно, headers с ключом.
Как проверить и удалить
ПроверкаОткройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
УдалениеПереключатель у сервера в Customize выключает его: выключенный сервер не загружается и не появляется в чате. Чтобы удалить сервер совсем, уберите его запись из mcp.json.
Переменные в конфиге${env:NAME} подставляет переменную окружения, ${userHome} — домашнюю папку, ${workspaceFolder} — корень проекта. Работает в command, args, env, url и headers.
Файл с переменнымиenvFile указывает на .env с переменными для локального сервера, например "${workspaceFolder}/.env".
Подтверждение вызововПо умолчанию Cursor спрашивает разрешение перед вызовом инструмента MCP. В режиме Auto-review инструменты из allowlist запускаются сразу.
Свой клиент OAuthЕсли провайдеру нужны фиксированные ключи, добавьте объект auth с CLIENT_ID, при необходимости CLIENT_SECRET и scopes.
Готовые конфиги для Cursor
Нажмите на сервер, чтобы раскрыть конфиг в формате Cursor.
Playwright MCPДаёт агенту настоящий браузер
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
GitHub MCPПодключает агента к GitHub
{
"mcpServers": {
"github": {
"url": "https://api.githubcopilot.com/mcp/",
"headers": {
"Authorization": "Bearer <GitHub PAT>"
}
}
}
}
Context7 MCPПодтягивает в контекст агента свежую документацию и примеры кода…
{
"mcpServers": {
"context7": {
"url": "https://mcp.context7.com/mcp",
"headers": {
"Authorization": "Bearer <ключ Context7>"
}
}
}
}
Figma MCPПодключает агента к макетам Figma
{
"mcpServers": {
"figma": {
"command": "npx",
"args": ["-y", "figma-developer-mcp", "--stdio"],
"env": {
"FIGMA_API_KEY": "<ваш токен Figma>"
}
}
}
}
Chrome DevTools MCPДаёт агенту живой Chrome с инструментами DevTools
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@latest"]
}
}
}
Filesystem MCPОткрывает агенту доступ к файлам в папках, которые вы перечислили при…
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/path/to/other/allowed/dir"
]
}
}
}
Fetch MCPДаёт агенту читать веб-страницы
{
"mcpServers": {
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
}
}
}
Memory MCPДаёт агенту долгую память между чатами
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"],
"env": {
"MEMORY_FILE_PATH": "<полный путь>/memory.jsonl"
}
}
}
}
Supabase MCPПодключает агента к проектам Supabase
{
"mcpServers": {
"supabase": {
"url": "https://mcp.supabase.com/mcp"
}
}
}
Notion MCPЛокальный сервер Notion поверх Notion API
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_<токен интеграции>"
}
}
}
}
Blender MCPСвязывает агента с запущенным Blender
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}
1С MCPПоказывает агенту метаданные и содержимое базы 1С:Предприятие
{
"mcpServers": {
"1c": {
"url": "http://<веб-сервер>/<имя публикации>/hs/mcp/",
"headers": {
"Authorization": "Basic <логин и пароль пользователя 1С>"
}
}
}
}Ограничения
!
envFile работает только для stdio-серверов, удалённые его не читают.
!
Инструменты MCP подчиняются тем же Run Modes, что и команды терминала.
!
Выключенный в Customize сервер не загружается и не виден в чате.
Если не работает
Сервер не подключается или падает
Output (Cmd+Shift+U) → MCP Logs: там видны ошибки соединения, авторизации и падения сервера.
Частые вопросы
Где лежит mcp.json у Cursor?
Глобальный — в ~/.cursor/mcp.json, он работает во всех проектах. Проектный — в .cursor/mcp.json в папке проекта.
Как не хранить ключ API в mcp.json?
Пишите "${env:API_KEY}" в env или headers: Cursor подставит значение переменной окружения. Для локального сервера подойдёт и envFile с путём к .env.
Как временно отключить сервер?
Выключите его переключателем в Customize. Запись в mcp.json останется.
Где смотреть ошибки MCP?
Откройте панель Output сочетанием Cmd+Shift+U и выберите MCP Logs.
Источники: cursor.com, cursor.com