Шість серверів MCP, які варто зберегти в Claude Code, та що слід видалити
Оптимізуйте перевантажену конфігурацію MCP: Context7, GitHub, Postgres MCP Pro, Playwright, Sentry та Brave Search, встановивши межі проекту та перевіривши кількість інструментів до 50.
Джерела: *I Tested 8 MCP Servers With Claude Code. These Were Actually Worth Keeping*
Агент для кодування, який отримав завдання знайти у локальній папці src застарілу функцію автентифікації за допомогою команди grep, може опинитися у досить дивному місці. У одному реальному випадку агент ігнорує файлову систему, звертається до сервера Jira MCP, встановленого тиждень раніше, та починає шукати назву функції серед незавершених заявок. Введення команди /mcp пояснює це: працювало 14 серверів, які надавали доступ до 73 інструментів. Приблизно 50 видимих інструментів — це межа, за якою модель більше не може розрізняти схожі інструменти та починає вгадувати. Крім того, ще до того, як було введено перше слово, на схеми JSON інструментів, якими ніхто не користувався, було витрачено близько 18 000 токенів на кожен крок.
Який би сервер не був підключений, його список інструментів потрапляє до системного запиту. Якщо метою є агент, який правильно обирає інструмент з першої спроби, ці ресурси є обмеженим бюджетом.
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 для виявлення проблем та запитів на зміни
Якщо попросити агента виправити проблему №8009, він зазвичай зупиниться та попросить опис, оскільки не може бачити віддалений репозиторій. Офіційний сервер MCP від GitHub надає можливість відстежувати проблеми, працювати з запитами на зміни та шукати код у віддалених репозиторіях.
# 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. Якщо існує офіційний сервер від постачальника, відмовтеся від версії спільноти.
execute_script для простої операції npm install, зіткнувся з помилкою шляху, а потім написав власний скрипт на Python, щоб ініціювати встановлення, проігнорувавши вбудований шелл. Якщо клієнт вже може отримувати URL-адреси чи читати файли, не витрачайте ресурси на сервер, який робить те саме.Продовжуйте аудитування
Перевіряйте файл .mcp.json щоразу, коли робота сесії стає повільною. Здорова конфігурація забезпечує наявність шести основних серверів та залишає простір під порогом у 50 інструментів. Сервер MCP у Slack є типовою причиною проблем: агент продовжує читати історію каналу, коли його просять шукати локальні журнали, тому продуктивність падає. Кандидати на восьме місце, наприклад MCP від Linear для імпорту критеріїв прийняття до редактора, мають довести свою корисність, і якщо вони підвищують кількість інструментів занадто сильно, щось інше мусить піти.
Якщо агент останнім часом працює повільно, збережіть поточну конфігурацію, а потім спробуйте використовувати лише ці основні сервери протягом кількох днів. Запустіть команду /mcp, щоб переглянути обсяг використання ресурсів та переконатися, чи агент обирає інструменти більш ефективно. Повертайте інші сервери лише тоді, коли досягнете межі, яку не можуть подолати вбудовані функції Claude Code.
Пов’язана література
- Пояснення субагентів Claude Code: що це таке та коли їх використовувати — У чому відмінності субагентів Claude Code від навичок та команд агентів: ізоляція контексту, створення першого власного субагента, рекомендації щодо опису та інструментів, а також ситуації, коли їх краще не використовувати.
- Чому агенти для програмування все ще мають проблеми з кодом приватних компаній — Real-SWE тестує вісім агентів для програмування на ліцензованих кодових базах приватних компаній. Найкращий агент вирішує 38,8 відсотка завдань, а п’ять категорій невдач показують, де агенти роблять помилки.