Главная / Статьи

mcpclaude-codeagentsdeveloper-toolsconfigurationllm

Шесть серверов MCP, которые стоит сохранить в Claude Code, и что следует убрать

Оптимизация перегруженной конфигурации MCP: Context7, GitHub, Postgres MCP Pro, Playwright, Sentry и Brave Search, с ограничением объема проекта и аудитом количества инструментов до 50.

Издатель: REACTAPP.TOP7 мин чтения1547 слов

Источники: *I Tested 8 MCP Servers With Claude Code. These Were Actually Worth Keeping*

Агент для программирования, запрошенный к поиску в локальной папке src устаревшей функции аутентификации с помощью команды grep, может оказаться в совершенно неожиданном месте. В одном реальном случае агент пропускает файловую систему, обращается к серверу Jira MCP, установленному неделю ранее, и начинает искать имя функции среди накопившихся заявок. Ввод команды /mcp объясняет это: работало 14 серверов, предоставлявших 73 инструмента. Примерно на уровне 50 видимых инструментов модель перестаёт отличать похожие инструменты и начинает угадывать. К тому же ещё до ввода первого слова тратилось около 18 000 токенов на схемы JSON инструментов, которыми никто не пользовался.

Любой подключённый сервер добавляет свой список инструментов в системное сообщение. Если цель — агент, способный сделать правильный выбор с первой попытки, эти ресурсы являются ограниченным бюджетом.

Context7 для текущих документов

Агенты часто пишут код под API, которые впоследствии меняются. Если запросить процесс аутентификации Supabase, результат может использовать методы, устаревшие к 2025 году. Context7 решает эту проблему путем включения документации библиотек с фиксированной версией в запрос.

# Add --scope project (or -s project) to write the entry into
# a committable .mcp.json instead of your personal ~/.claude.json.

# Context7 provides current, version-pinned library docs
# Canonical path is the installer (OAuth + generates an API key):
npx ctx7 setup

# Or wire the remote server manually (key from context7.com/dashboard):
claude mcp add --transport http context7 https://mcp.context7.com/mcp \
  --header "CONTEXT7_API_KEY: <YOUR_KEY>"

После установки агент загружает актуальные данные в формате Markdown и формирует текущую реализацию. Вам необходимо доверять его индексу, но для основных веб-фреймворков это первый сервер, который стоит установить.

GitHub для отслеживания проблем и pull-запросов

Если попросить агента исправить проблему №8009, он обычно остановится и запросит описание проблемы, поскольку не может видеть удаленный репозиторий. Официальный сервер MCP от GitHub предоставляет возможность отслеживания проблем, работы с pull-запросами и поиска кода в удаленных репозиториях.

# GitHub — OFFICIAL server (issues, PRs, repo search).
# For Claude Code 2.1.1+:
claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer <YOUR_GITHUB_PAT>"}}'

# For Claude Code 2.1.0 or earlier (legacy flag form):
# claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer <YOUR_GITHUB_PAT>"

После этого работает запрос вида «review PR #8042»: агент загружает различия между версиями кода, читает комментарии рецензентов, соотносит их с локальными файлами и применяет необходимые изменения. Рекомендуется использовать собственный сервер GitHub вместо старых сторонних инструментов.

Postgres MCP Pro для реальных схем

Агент, который пытается угадать структуру базы данных, создает ошибки вроде column 'created_at' does not exist. Postgres MCP Pro предоставляет ему такие инструменты, как list_schemas и get_object_details, что позволяет ему сначала определить реальную структуру базы данных перед написанием SQL-запросов.

# Postgres MCP Pro — schema-aware SQL, READ-ONLY restricted mode
pipx install postgres-mcp

# Add the server with the restricted access flag
claude mcp add postgres --env DATABASE_URI="postgresql://user:pass@localhost:5432/db" \
  -- postgres-mcp --access-mode=restricted

Для стадионга или производственной среды флаг --access-mode=restricted является обязательным. Он отключает операции INSERT, UPDATE и DELETE на уровне сервера, так что агент не может удалять таблицы во время исследования.

Playwright MCP для проверки

Агенты с радостью утверждают, что CSS-класс исправил ошибку макета, даже не отрисовывая страницу. Playwright MCP позволяет агенту проверять свою работу с помощью браузера без интерфейса.

# Playwright (Microsoft) — agent drives a real browser to verify its own change
claude mcp add playwright npx @playwright/mcp@latest

Вместо того чтобы анализировать сырой скриншот, агент читает дерево доступности, благодаря чему знает, где находится кнопка в DOM и может ли пользователь её увидеть.

Playwright управляет браузером и тестирует DOM. Chrome DevTools MCP — это отдельный инструмент, предназначенный для анализа сетевой активности и производительности. Добавляйте сервер DevTools только тогда, когда вы активно решаете проблемы с сетью, поскольку Playwright лучше справляется с визуальной проверкой.

Sentry для ошибок в продакшене

Сокращённый стек-трейс React, вставленный в терминал, редко бывает полезен, поскольку версии приложения для продакшена удаляют карты исходного кода. Официальный сервер MCP от Sentry загружает несокращённый стек-трейс, информацию о шагах выполнения и данные окружения в окно контекста.

# Sentry — OFFICIAL remote server; pulls live stack traces
# Triggers OAuth on first launch
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Когда пользователь сообщает о сбое, агенту могут поручить проверить последнюю проблему фронтенда в Sentry, и он будет отлаживать ошибку, используя точную строку кода и состояние переменных в момент сбоя.

Brave Search для поиска новых решений

Двадцать минут могут пройти впустую из-за неясной ошибки esbuild, хотя решение уже существует в вопросе на GitHub, открытом два дня назад. Учебные данные агента были слишком устаревшими, чтобы распознать проблему, поэтому разработчику приходится покидать терминал и искать решение вручную.

# Brave Search — OFFICIAL server from Brave (the @modelcontextprotocol/*
# package was archived May 2025)
# Requires a free API key from api-dashboard.search.brave.com
claude mcp add brave-search --env BRAVE_API_KEY="<YOUR_KEY>" \
  -- npx -y @brave/brave-search-mcp-server --transport stdio

Это предоставляет агенту инструмент для поиска в интернете в реальном времени. При возникновении редкой ошибки он может получить последние ответы с StackOverflow или информацию о статусе обслуживающего сервиса, не покидая терминал.

Защита конфигурации

Прежде чем добавлять что-то новое, необходимо исправить конфигурацию и проверить, что выполняется. Добавление параметра --scope project к любой команде установки записывает настройки в файл .mcp.json внутри репозитория вместо глобального файла ~/.claude.json, что позволяет всей команде использовать один и тот же набор инструментов.

Файл с ссылками на вышеупомянутые серверы, а также два гибких слота, выглядит следующим образом. Гибкие слоты включают сервер Filesystem для организованного доступа к каталогам, находящимся вне текущего проекта, и Sequential-thinking, который помогает агенту отслеживать собственную логику во время крупных рефакторингов.

{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": { "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY}" }
    },
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp",
      "headers": { "Authorization": "Bearer ${GITHUB_PAT}" }
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    },
    "postgres": {
      "command": "postgres-mcp",
      "args": ["--access-mode=restricted"],
      "env": { "DATABASE_URI": "${DATABASE_URI}" }
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@brave/brave-search-mcp-server", "--transport", "stdio"],
      "env": { "BRAVE_API_KEY": "${BRAVE_API_KEY}" }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "${HOME}/projects"]
    },
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    }
  }
}

Для обработки данных используются два способа передачи данных. При использовании http сервер представляет собой удаленный API, и вся его логика выполняется на стороне провайдера. При использовании stdio, как в случае с Playwright или Postgres, из массива command запускается локальный процесс, поэтому соответствующие бинарные файлы необходимо сначала установить на компьютер. Конфиденциальные данные передаются с помощью интерполяции из окружения, например ${DATABASE_URI}, что обеспечивает безопасность файлов при их сохранении.

Чтобы узнать, сколько инструментов требуется для настройки, посмотрите прямую трансляцию сессии:

# List every configured server and its connection status
claude mcp list

# Inside a Claude Code session, inspect connected servers and their tools:
# Type /mcp
# This shows each server, its tool count, and lets you toggle tools.

Интерфейс показывает общее количество инструментов. Там присутствует около пятидесяти видимых инструментов — отключите те, которые не нужны для текущей сессии.

Удалите ненужное

После установления базового уровня удаляйте всё лишнее.

  • Архивированные серверы-референсы. Старая реализация Postgres (@modelcontextprotocol/server-postgres) всё ещё упоминается в устаревших учебниках, но не поддерживается. Замените её на Postgres MCP Pro.
  • Кастомные обёртки от сторонних разработчиков. Обёртки для GitHub, Sentry и подобных сервисов, созданные сообществом, появились в 2025 году в качестве временных решений и отстают от официальных изменений API. Если существует официальный сервер поставщика, откажитесь от версии, созданной сообществом.
  • Любые элементы, дублирующие встроенные возможности. Именно здесь происходит конфликт инструментов. Специализированный сервер для выполнения оболочки предоставляет агенту два способа запуска bash. В одном задокументированном случае агент использовал сторонний инструмент execute_script для простой операции npm install, столкнулся с ошибкой пути, после чего написал собственный скрипт на Python для запуска установки, проигнорировав встроенную оболочку. Если клиент уже может загружать URL-адреса или читать файлы, не тратите ресурсы на сервер, который делает то же самое.

Продолжайте проводить аудит

Проверяйте файл .mcp.json заново каждый раз, когда работа сессии кажется медленной. Нормальная настройка предполагает наличие шести основных серверов и свободного места ниже порога в 50 инструментов. Типичной причиной проблем является сервер Slack MCP: агент продолжает читать историю каналов, когда ему нужно искать локальные логи, из-за чего происходит замедление. Кандидаты на восьмое место, такие как MCP от Linear для импорта критериев принятия в редактор, должны доказать свою полезность, и если они увеличивают общее количество инструментов слишком сильно, что-то другое вынуждено уйти.

Если агент в последнее время работает медленно, сохраните текущую конфигурацию, а затем попробуйте использовать только эти основные сервера в течение нескольких дней. Запустите команду /mcp, чтобы оценить нагрузку, и обратите внимание, стал ли агент выбирать инструменты более эффективно. Возвращайте остальные серверы только тогда, когда встретите ограничение, которое не могут преодолеть встроенные функции Claude Code.

Связанные материалы

  • Семь серверов MCP для Claude Code: команды подключения и проблемы безопасности — серверы Filesystem, Chrome DevTools, Postgres, Supabase, Stripe, Notion и Exa MCP для Claude Code, включая команды подключения и риски доступа для каждого из них.
    • ← Все статьиПрислать бриф