глава 02

Подключить готовый сервер

Подключение сервера - это запись в конфиг клиента. Клиент по этой записи сам запускает сервер и забирает его возможности. Код писать не нужно.

Где лежит конфиг

  • Claude Desktop - файл claude_desktop_config.json. На macOS он в ~/Library/Application Support/Claude/, на Windows в %APPDATA%\Claude\.
  • В проекте - файл .mcp.json в корне проекта. Его видят клиенты, работающие с этой папкой, удобно держать в репозитории.
  • Cursor - свои настройки MCP в интерфейсе (Settings, раздел MCP), формат записи такой же.
  • Codex - тоже поддерживает MCP, серверы прописываются в его конфиге.

Пример: сервер filesystem

Сервер filesystem даёт модели доступ к указанным папкам. Запись в конфиге выглядит так:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/me/projects"
      ]
    }
  }
}

Здесь command и args - это команда, которой клиент запускает сервер. Последний аргумент - папка, к которой открывается доступ. Можно указать несколько папок.

Пример: сервер github

GitHub-сервер ходит в репозитории через токен. Токен передают через переменную окружения:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_ваш_токен"
      }
    }
  }
}

Перезапуск и проверка

1
Сохраните конфиг
Проверьте, что JSON валиден - лишняя запятая или скобка ломают запуск.
2
Перезапустите клиент
Claude Desktop, Cursor или Codex читают конфиг при старте. Полностью закройте и откройте заново.
3
Найдите индикатор сервера
В интерфейсе клиента появится список подключённых MCP-серверов и их инструментов. filesystem или github должны быть в списке.
4
Дайте проверочную задачу
Например, попросите показать файлы в папке или список последних issue в репозитории. Если модель это сделала - сервер работает.