Cursor хранит список серверов в файле mcp.json с объектом mcpServers. Файл в домашней папке действует во всех проектах, файл в папке проекта — только в нём.

Cursor читает серверы из двух файлов: общего для всех проектов и файла в папке проекта.

Где файл#

Таблица: Файлы настроек Cursor | Область | Файл | |---|---| | Все проекты | ~/.cursor/mcp.json | | Один проект | .cursor/mcp.json в корне проекта |

Сервер можно добавить и из интерфейса: Cursor Settings → Tools & Integrations → MCP → добавить сервер. Многие поставщики публикуют кнопку установки в Cursor, которая заполняет эти настройки сама.

Локальный сервер#

.cursor/mcp.json

{
  "mcpServers": {
    "framelink-figma": {
      "command": "npx",
      "args": ["-y", "figma-developer-mcp", "--figma-api-key=ВАШ_КЛЮЧ", "--stdio"]
    }
  }
}

Удалённый сервер#

Для удалённого сервера достаточно адреса. Если сервер принимает токен, добавьте заголовок:

~/.cursor/mcp.json

{
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": { "Authorization": "Bearer ВАШ_ТОКЕН" }
    },
    "edt": { "url": "http://localhost:8765/mcp" }
  }
}

Cursor поддерживает вход через OAuth для части серверов; тогда заголовок не нужен.

Проверка#

Полностью перезапустите Cursor.
В Settings → Tools & Integrations → MCP у сервера должна гореть зелёная точка.
В чате агента сервер и его инструменты появятся в списке доступных.

Не вписывайте токены в .cursor/mcp.json проекта, если папка попадает в репозиторий. Другие ошибки — в разделе «Частые ошибки».