MCP — это руки твоего агента.
Filesystem, GitHub, Memory, Postgres, Playwright — пять MCP-серверов которые реально меняют работу с Claude Code.
Топ MCP-серверов
MCP (Model Context Protocol) — стандарт подключения внешних инструментов к Claude. Без MCP он работает вслепую: не видит файлы, репозитории, базу данных. С правильными серверами — Claude становится частью твоего стека, а не изолированным чатом.
Для кого этот гайд
MCP-серверы работают в Claude Code (терминальное приложение для разработчиков) и Claude Desktop App (claude.ai/download). Они не работают в браузерной версии claude.ai. Если ты только начинаешь — сначала регистрация и быстрый старт или настройка Claude за 10 шагов.
Как подключить за 5 минут
Один файл — и Claude видит весь контекст.
Создай .mcp.json в корне проекта. Claude Code подхватит серверы автоматически при следующем запуске — увидишь список Connected в начале сессии.
``json
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem",
"/path/to/project"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..." }
},
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
}
}
}
``
npx скачивает серверы автоматически — ничего устанавливать отдельно не нужно.
Пять серверов которые используем каждый день
Не все MCP равны. Эти — обязательны.
Нажми на карточку — покажем пошаговую инструкцию по установке.
Filesystem
Доступ к локальным файлам и папкам
УСТАНОВЛЕН У 95% ПОЛЬЗОВАТЕЛЕЙ CLAUDE CODE
Даёт Claude читать, писать, искать файлы на диске. Без этого MCP Claude не видит проект — только то что ты вставишь в чат вручную. С ним — он работает прямо в твоих файлах, ищет по директориям, читает конфиги.
Когда брать: любой проект с файлами на диске. Obsidian-vault, кодовая база, папка с шаблонами. Это первый MCP который ставят все.
_[Как установить →]_ (раскрывающаяся инструкция)
Шаг 1 — добавить в .mcp.json
``json
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/ВАШ_ЛОГИН/Desktop/ВАШ_ПРОЕКТ"
]
}
}
}
``
Замени путь на свой — можно указать несколько папок через запятую в args.
Шаг 2 — перезапустить Claude Code
Закрой и открой заново. В начале сессии увидишь: Connected: filesystem. Готово — Claude теперь видит все твои файлы.
Требования
Node.js 18+. Проверить: node --version в терминале. Если ниже 18 — обновить через nodejs.org.
modelcontextprotocol/servers · github.com/modelcontextprotocol/servers ↗
GitHub
Репозитории, issues, pull requests, поиск кода
Claude открывает репозитории, читает PR, создаёт issues, ищет код по всей организации. Не просто «посмотреть файл» — полноценная работа с GitHub без браузера. Видит историю коммитов, diff'ы, комментарии.
Когда брать: code review, работа с открытыми репозиториями, мониторинг issues, поиск примеров реализации в чужих проектах.
_[Как установить →]_ (раскрывающаяся инструкция)
Шаг 1 — создать Personal Access Token
Открой github.com → Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Нужные разрешения: Contents (read), Issues (read/write), Pull requests (read/write). Скопируй токен — он показывается только один раз.
Шаг 2 — добавить в .mcp.json
``json
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_ВАШ_ТОКЕН_СЮДА"
}
}
}
}
``
Токен хранится только в .mcp.json локально — в git не попадает если файл в .gitignore.
Шаг 3 — перезапустить Claude Code
После перезапуска скажи Claude: «посмотри issues в репозитории ИМЯ/РЕПО» — он сразу увидит их без браузера.
modelcontextprotocol/servers · github.com/modelcontextprotocol/servers ↗
Memory
Постоянная память между сессиями
Claude сохраняет факты, предпочтения, решения в knowledge graph. В следующей сессии — помнит кто ты, как ты любишь работать, что уже обсудили. Без этого каждая сессия = чистый лист.
Когда брать: долгосрочные проекты (3+ месяца), персональные предпочтения, накопление знания о принятых архитектурных решениях.
_[Как установить →]_ (раскрывающаяся инструкция)
Шаг 1 — добавить в .mcp.json
``json
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
}
}
}
``
Память хранится локально в JSON-файле рядом с проектом. Никуда не отправляется.
Шаг 2 — перезапустить Claude Code
После перезапуска Claude автоматически начнёт сохранять важные факты.
Как пользоваться
Скажи Claude: «запомни что я предпочитаю TypeScript и не использую Prisma» — он сохранит. В следующей сессии будет помнить. Также работает автоматически: если Claude видит важное решение — сохраняет сам.
modelcontextprotocol/servers · github.com/modelcontextprotocol/servers ↗
Postgres
Прямые SQL-запросы к базе данных (read-only)
Claude подключается к Postgres, видит схему, выполняет запросы, анализирует данные. Не нужно копировать SQL-результаты в чат — он сам разберётся что в базе. Read-only по умолчанию — данные не изменяет.
Когда брать: дебаг production-данных без экспорта в CSV, проверка миграций, анализ аномалий прямо в боевой базе.
_[Как установить →]_ (раскрывающаяся инструкция)
Шаг 1 — найти строку подключения
Для Supabase: откой проект → Settings → Database → Connection string → URI. Для локального Postgres: postgresql://postgres:password@localhost:5432/mydb
Шаг 2 — добавить в .mcp.json
``json
{
"mcpServers": {
"postgres": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-postgres",
"postgresql://user:password@host:5432/dbname"
]
}
}
}
``
Замени строку подключения на свою. Для Supabase используй Transaction Pooler URL (порт 6543) для лучшей совместимости.
Шаг 3 — перезапустить Claude Code
Теперь можешь сказать: «покажи структуру таблицы users» или «найди все записи где status = pending за последние 7 дней» — Claude сам напишет и выполнит запрос.
Важно
Сервер работает только на чтение (read-only). Claude не сможет изменить, удалить или вставить данные — это защита от случайных изменений в production.
modelcontextprotocol/servers · github.com/modelcontextprotocol/servers ↗
Playwright
Браузерная автоматизация и скриншоты
Claude открывает браузер, кликает, заполняет формы, делает скриншоты, проверяет UI. Используем для E2E-верификации каждой фичи прямо во время разработки — Claude сам смотрит что получилось и исправляет.
Когда брать: проверка UI-изменений после правок, web scraping, тестирование форм и флоу без ручного открытия браузера.
_[Как установить →]_ (раскрывающаяся инструкция)
Шаг 1 — установить браузеры Playwright
``
npx playwright install
``
Запусти один раз в терминале. Скачает Chromium, Firefox, WebKit (~300 МБ). Делается один раз на весь компьютер.
Шаг 2 — добавить в .mcp.json
``json
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp"]
}
}
}
``
Шаг 3 — перезапустить Claude Code
Теперь скажи: «открой localhost:3000 и сделай скриншот главной страницы» — Claude откроет браузер и пришлёт скриншот прямо в чат. Или: «проверь что кнопка Войти работает на /login».
Как используем в AGINE
После каждого UI-изменения говорим Claude: «проверь что выглядит правильно на /dashboard» — он сам открывает, смотрит, и если что-то сломалось — тут же правит. Экономит 10-15 минут ручных проверок за сессию.
microsoft/playwright-mcp · github.com/microsoft/playwright-mcp ↗
Поиск и подключение MCP
Не нашли свой? Введите название сервиса.
MCP-серверов уже сотни — для Notion, Slack, Linear, Figma и тысяч других сервисов. Напишите, с чем работаете, и нейросеть в реальном времени найдёт подходящий сервер, выдаст готовый конфиг с ключами и пошаговую инструкцию подключения.
[Компонент McpFinder — интерактивный поиск]
- Поле ввода с плейсхолдером:
Название сервиса — Notion, Slack, Linear… - Кнопка: Найти MCP (в процессе — «Ищу…»)
- Примеры: Notion · Slack · Linear · Google Drive · Figma
- Состояние загрузки: «Нейросеть ищет актуальный MCP-сервер в реальном времени — это занимает несколько секунд.»
- Ошибки: «Введите название сервиса — минимум 2 символа.» / «Не получилось выполнить поиск.» / «Сеть недоступна. Попробуйте ещё раз.»
- Результат (найдено): бейдж «официальный» или «community», блок
.mcp.jsonс кнопкой «скопировать», раздел «Ключи доступа», раздел «Как подключить» (нумерованные шаги), ссылка «Проверить пакет на источнике». - Результат (не найдено): «Готовый MCP-сервер для этого сервиса не нашёлся. Проверьте официальный реестр MCP.» + ссылка «Открыть реестр MCP».
- Футер результата: «Результат собран поиском в реальном времени. Перед вставкой ключей откройте источник и убедитесь, что пакет — тот, что вам нужен.»
Наш реальный конфиг
Что стоит в AGINE прямо сейчас.
- → filesystem — на папку проекта + Obsidian-vault agine-knowledge. Claude читает весь контекст сессий и принятых решений.
- → github — для работы с репозиториями. Claude Code создаёт PR, читает issues, делает code search.
- → playwright — каждое UI-изменение проверяется скриншотом прямо в сессии, до git push. Claude сам смотрит что получилось.
- → postgres — дебаг Supabase без ручного копирования данных из дашборда.
- → memory — встроенная auto-memory Claude Code сохраняет важные факты и решения между сессиями автоматически.
Все серверы в одном .mcp.json в корне проекта. Ни один не требует дополнительной инфраструктуры — только npx и ключи доступа.
После подключения
Спросите нейросеть, что автоматизировать.
Инструменты подключены — дальше не угадывайте. Дайте нейросети этот промт: она изучит ваши реальные данные, задаст уточняющие вопросы про цель и метрики, предложит что оптимизировать и автоматизировать, и сразу выполнит одну задачу с наибольшим эффектом.
[Компонент CopyPrompt — промт для копирования] (метка: «промт — скопируйте и вставьте в Claude»)
``` Ты подключён к моим рабочим сервисам. Действуй строго по шагам:
1. Посмотри, какие сервисы у меня подключены, и бегло изучи, какие в них реальные данные. Не предполагай, опирайся только на то, что видишь.
2. Прежде чем что-либо советовать, задай мне уточняющие вопросы и дождись ответов: • чем я занимаюсь (свой бизнес, фриланс, проект) и какая у меня роль; • какая у меня главная цель сейчас (вырасти в выручке, сэкономить время, масштабироваться, снизить расходы); • какие 2-3 ключевые метрики я отслеживаю (выручка, прибыль, лиды, клиенты, конверсия, расходы); • какая рутина съедает у меня больше всего времени. Вопросы формулируй с учётом того, что уже увидел в моих данных.
3. Только после моих ответов глубоко проанализируй данные в привязке к моей цели и скажи: 1) что можно оптимизировать, чтобы быстрее прийти к цели? 2) что можно автоматизировать, чтобы освободить моё время? Каждый пункт подкрепи конкретикой из моих сервисов.
4. Выбери одну задачу с наибольшим эффектом для моей цели и выполни её прямо сейчас. ```