Туториал по MCP-серверам 2026: установка, настройка, запуск

Что такое MCP на самом деле

Model Context Protocol — это спецификация, опубликованная Anthropic в ноябре 2024 года. Она описывает стандартный способ для языковых моделей вызывать внешние инструменты — и для внешних инструментов раскрывать себя моделям. До MCP каждая интеграция AI-инструментов была кастомной; MCP делает интеграции компонуемыми.

Архитектура проще, чем подсказывает название. MCP-сервер — это процесс, работающий на Вашей машине (или удалённо, если речь о хостируемых серверах). При старте Claude Code запускает каждый сконфигурированный MCP-сервер, получает список инструментов, которые этот сервер предоставляет, и затем может вызывать их по имени в любой сессии. Вся коммуникация идёт через stdin/stdout по протоколу JSON-RPC 2.0. Ни HTTP, ни портов, ни сетевой настройки для локальных серверов.

Более глубокий концептуальный разбор — в материале «Что такое MCP». Этот пост — про практическую настройку.

Где живёт конфиг

Конфигурация MCP-серверов живёт в файле settings.json. Существует две локации:

• ~/.claude/settings.json — глобальный; применяется к каждой сессии Claude Code на этой машине
• .claude/settings.json (в каталоге проекта) — на уровне проекта; применяется только когда Claude Code запущен в этом каталоге, и переопределяет глобальный конфиг по совпадающим ключам

Файл уровня проекта предпочтительнее для серверов, специфичных для проекта (сервер базы данных, привязанный к одной строке подключения). Глобальный — для серверов, нужных везде (Fetch, GitHub).

Базовая структура конфига

Ключ mcpServers в settings.json — это карта от имени сервера к его конфигурации. Каждая конфигурация описывает, как запустить процесс сервера.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_fine_grained_token_here"
      }
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

Несколько замечаний по этой структуре:

• Флаг -y у npx устанавливает пакет, если он ещё не установлен. Это удобно при первой настройке, но чуть замедляет старт. Чтобы избежать этого, версию можно зафиксировать: @modelcontextprotocol/server-filesystem@0.6.0.
• Учётные данные размещаются в объекте env, а не в аргументах командной строки. Аргументы пишутся в логи, переменные окружения по умолчанию — нет.
• Имена серверов (ключи) произвольны — они используются только в сообщениях об ошибках и в описаниях инструментов для Claude.

Пять серверов для первой установки

{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_TOKEN": "github_pat_..."
    }
  }
}

{
  "playwright": {
    "command": "npx",
    "args": ["-y", "@playwright/mcp@latest"]
  }
}

{
  "fetch": {
    "command": "uvx",
    "args": ["mcp-server-fetch"]
  }
}

Как убедиться, что сервер работает

После правки settings.json запустите новую сессию Claude Code. В строке ввода спросите Claude, какие инструменты ему доступны:

Какие MCP-инструменты Вам доступны?

Claude должен перечислить настроенные серверы и их инструменты. Если сервер отсутствует, причина обычно одна из трёх:

1. Пакет не установлен. Флаг -y у npx ставит его автоматически, но первый запуск может упасть, если реестр npm работает медленно или в сети есть фаервол. Запустите npx-команду вручную в терминале, чтобы увидеть ошибку.
2. Неверный путь. Сервер Filesystem ожидает абсолютный путь. Относительный путь или путь с опечаткой приведут к сбою при запуске. Claude Code пишет ошибки MCP-серверов в ~/.claude/logs/ — проверяйте эту папку первым делом.
3. Учётные данные недействительны. Если сервер запускается, но его инструменты возвращают ошибки — чаще всего проблема в просроченном или неверно настроенном API-ключе. Прежде чем диагностировать слой MCP, протестируйте учётные данные напрямую через curl или интерактивную консоль API провайдера.

Конфиг проекта против глобального

Распространённый паттерн в Septim: глобальный конфиг содержит Fetch, Memory и Playwright — серверы, полезные в любом проекте. Конфиг уровня проекта содержит Filesystem (с корнем проекта в качестве разрешённого пути), сервер базы данных проекта и GitHub (привязанный к репозиторию проекта).

Такая структура позволяет переходить в любой каталог проекта — и Claude Code автоматически подхватывает нужный набор серверов без ручного переключения конфигов. Файл уровня проекта переопределяет глобальный для серверов с одинаковым именем, поэтому в разных проектах могут быть разные подключения к БД без конфликтов.

Удалённые MCP-серверы

В начале 2026 года Anthropic добавил поддержку удалённых MCP-серверов (доступ через SSE вместо stdio). В конфиге используется ключ url вместо command и args:

{
  "mcpServers": {
    "stripe": {
      "url": "https://mcp.stripe.com",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Удалённые серверы удобны для сервисов, поддерживающих собственные хостируемые MCP-эндпоинты (так делают Stripe и ряд других). Цена компромисса — сетевой round-trip на каждый вызов инструмента и передача учётных данных по сети. Используйте только удалённые серверы по HTTPS и относитесь к заголовку Authorization так же, как к API-ключу в переменной окружения.

Чек-лист безопасности перед добавлением новых серверов

Каждый добавленный сервер расширяет поверхность атаки сессии Claude Code. Чек-лист уязвимостей MCP-серверов содержит 24-пунктовую методику оценки. Краткая версия для туториала:

• Устанавливайте только серверы с активным организационным мейнтейнером или компанией-владельцем
• Перед установкой читайте описания инструментов в исходниках — встроенные в метаданные вредоносные инструкции являются документированным вектором атаки (arXiv 2603.22489)
• Используйте минимальный объём прав в учётных данных — токен GitHub для чтения одного репозитория не должен иметь права записи во все
• Держите .claude/settings.json вне git, если он содержит учётные данные

Полный курированный список серверов, заслуживающих запуска — каждый со своей оговоркой по безопасности — в материале «Лучшие MCP-серверы 2026».