Как подключить и настроить MCP-сервер: пошаговая инструкция для Claude и Cursor

Что такое MCP и зачем его подключать

Model Context Protocol (MCP) — открытый стандарт от компании Anthropic, ставший в 2026 году универсальным протоколом подключения нейросетей к внешним системам.

Без MCP языковая модель изолирована внутри чата: она не видит файлы на вашем жестком диске, не может выполнить SQL-запрос к рабочей базе данных и не умеет взаимодействовать с внешними сервисами (GitHub, Notion, 1С, Jira).

После подключения MCP-сервера нейросеть получает набор конкретных инструментов (Tools):

• Прямое чтение и запись файлов проекта без необходимости копировать текст в чат.
• Выполнение SQL-запросов к PostgreSQL, SQLite или MySQL с автоматическим анализом таблиц.
• Создание issue и pull-request в GitHub прямо из интерфейса Claude или Cursor.

Ниже приведена пошаговая инструкция по настройке MCP на Windows и macOS. Это руководство входит в раздел «Как сделать» — для углубления ознакомьтесь с хабом MCP-серверов и справочником команд Claude Code.

---

Где настраиваются MCP-серверы

Настройка серверов выполняется через один центральный JSON-файл конфигурации:

Операционная система	Точный путь к файлу конфигурации
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json (обычно C:\Users\Имя\AppData\Roaming\Claude\)
Linux	~/.config/Claude/claude_desktop_config.json
Cursor IDE	Cursor Settings $\to$ Features $\to$ MCP Servers $\to$ Add New MCP Server

---

Пошаговая настройка в Claude Desktop

Шаг 1. Создание и редактирование конфигурационного файла

Откройте файл claude_desktop_config.json в любом текстовом редакторе (VS Code, Notepad, Cursor). Если файла еще нет, создайте его.

Пример универсального рабочего конфига (Filesystem + GitHub + SQLite):

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Projects"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    },
    "sqlite": {
      "command": "uvx",
      "args": [
        "mcp-server-sqlite",
        "--db-path",
        "/Users/username/Projects/main.db"
      ]
    }
  }
}

Важно для безопасности: В аргументах server-filesystem перечисляйте только те директории, к которым вы действительно хотите дать доступ агенту. Не указывайте корневую директорию / или диск C:\.

Шаг 2. Перезапуск Claude Desktop и проверка инструментов

1. Полностью закройте Claude Desktop (на macOS: Cmd + Q, на Windows: выход через трей).
2. Запустите приложение заново.
3. В правом нижнем углу поля ввода сообщения появится иконка молотка (Tools). Нажмите на нее, чтобы увидеть список доступных функций: read_file, write_file, list_directory, search_files.

Теперь вы можете отдавать прямые команды:

• «Прочитай файл sales.csv из папки Projects, найди аномалии в продажах за третий квартал и напиши краткий аналитический отчет».
• Claude сам вызовет инструмент filesystem.read_file, получит данные и выдаст ответ без ручного перетаскивания файлов.

---

Настройка MCP в редакторе Cursor

В редакторе Cursor подключение MCP дает агенту Composer возможность видеть окружение разработки в реальном времени.

1. Откройте настройки Cursor (Cmd + , на Mac или Ctrl + , на Windows).
2. Перейдите во вкладку Features $\to$ MCP Servers.
3. Нажмите кнопку + Add New MCP Server.
4. Заполните поля:
   • Name: postgres-dev
   • Type: command
   • Command: npx -y @modelcontextprotocol/server-postgres postgresql://user:password@localhost:5432/mydb
5. Сохраните. Кружок статуса станет зеленым (Active).

Теперь в режиме Composer (Cmd + I) агент сможет самостоятельно читать схему таблиц, валидировать названия колонок и писать точные SQL-миграции без ошибок в типах данных.

---

4 частые проблемы при подключении MCP и их решение

1. Значок молотка не появляется (сервер не стартует):
   Причина: Ошибка в синтаксисе JSON (лишняя запятая или незакрытая скобка). Проверьте валидность файла через онлайн-валидатор JSONLint.
2. Ошибка spawn npx ENOENT:
   Причина: Приложение не может найти команду npx в системных путях.
   Решение: Замените "command": "npx" на полный путь к исполняемому файлу (например, "/usr/local/bin/npx" или "/opt/homebrew/bin/npx"). Узнать путь можно в терминале командой which npx (Mac/Linux) или where npx (Windows).
3. Ошибка прав доступа (Permission Denied):
   Причина: Вы пытаетесь прочитать файл вне списка разрешенных путей в server-filesystem. Добавьте нужную папку в массив args конфига.
4. Таймаут подключения (Timeout 30000ms):
   Причина: Первый запуск пакета через npx -y долго скачивает зависимости. Запустите команду один раз вручную в обычном терминале, чтобы пакет закешировался на диске.

---

Что изучить дальше

• Полный каталог готовых серверов смотрите в разборном хабе MCP.
• Как связать MCP с корпоративными системами описано в гайде MCP для 1С.
• Как автоматизировать задачи через консольного агента — в разделе Claude Code.
• Больше прикладных решений ищите в разделе «Как сделать».