MCP-серверы для AI-агентов: универсальный старт

Что получится

Ты соберёшь не случайный набор “модных MCP”, а понятную карту: какие серверы нужны агенту в первую очередь, какие права они получают, как их подключать в разных клиентах и как проверять без лишнего риска.

Этот гайд универсальный. Он подходит не только для Claude Code. Логика одна и та же для Codex, Claude Desktop, Cursor, OpenCode и других MCP-клиентов: сервер запускается отдельно, клиент подключает его как tool provider, а агент получает новые инструменты.

Когда это нужно

MCP имеет смысл подключать, когда ты регулярно копируешь данные между агентом и внешним инструментом вручную.

Если ты используешь сервер один раз в месяц, возможно, он не нужен. MCP полезен там, где инструмент становится частью постоянного workflow.

Как устроена установка

У разных клиентов разные команды и UI, но под капотом обычно повторяется один формат:

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@package/server"],
      "env": {
        "API_KEY": "your-key"
      }
    }
  }
}

Вместо npx может быть uvx, docker, локальный бинарник или удалённый HTTP endpoint.

Установка в Claude Code

Claude Code даёт удобную команду claude mcp add.

# Установить сервер без ключей
claude mcp add memory -- npx -y @modelcontextprotocol/server-memory

# Установить сервер с API-ключом
claude mcp add tavily --env TAVILY_API_KEY="your-key" -- npx -y tavily-mcp

# Установить глобально для пользователя
claude mcp add github --scope user --env GITHUB_PERSONAL_ACCESS_TOKEN="your-token" -- npx -y @modelcontextprotocol/server-github

# Посмотреть список
claude mcp list

# Удалить сервер
claude mcp remove memory

Команды выше показывают паттерн. Перед установкой конкретного сервера сверяй пакет и переменные окружения с официальным README.

Установка в Claude Desktop

Claude Desktop чаще настраивают через JSON-конфиг.

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/folder"]
    }
  }
}

После изменения конфига приложение нужно перезапустить.

Установка в Codex-подобном workflow

В Codex нет смысла думать только в терминах “одной команды”. Здесь безопаснее мыслить через локальный plugin-wrapper или MCP-конфиг, где сервер описан отдельно от проекта.

Пример формы:

{
  "mcpServers": {
    "magic": {
      "type": "stdio",
      "command": "npx.cmd",
      "args": ["-y", "@21st-dev/magic@latest"],
      "env": {
        "API_KEY": "${TWENTY_FIRST_API_KEY}"
      }
    }
  }
}

На Windows для stdio-серверов часто надёжнее указывать npx.cmd, а не просто npx.

Установка в Cursor, OpenCode и похожие клиенты

Многие клиенты поддерживают .mcp.json или собственную страницу MCP-настроек. Проверяй документацию конкретного клиента, но структура обычно такая же:

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

Разница чаще всего не в MCP-сервере, а в том, где клиент хранит конфиг и как перезапускает tools.

Первая безопасная база серверов

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

1. Memory — память между сессиями

Нужен, если агент должен помнить устойчивые предпочтения, правила проекта или повторяющиеся решения.

npx -y @modelcontextprotocol/server-memory

Риск: агент может начать опираться на устаревшую память. Нужна привычка периодически чистить или перепроверять сохранённые факты.

2. Filesystem — доступ к локальной папке

Полезен для чтения и редактирования файлов внутри явно разрешённой директории.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    }
  }
}

Риск: это файловый доступ. Не давай серверу весь диск. Начинай с read-only сценария или отдельной рабочей папки.

3. GitHub — репозитории, issues, PR

Нужен, если агент должен видеть задачи, pull requests, workflows и контекст разработки.

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    }
  }
}

Риск: токен GitHub может давать write-доступ. Для старта лучше использовать минимальные permissions.

4. Playwright — браузер для агента

Нужен, если агент должен открыть сайт, проверить UI, заполнить форму или сделать end-to-end проверку.

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

Риск: браузерный агент может выполнить реальные действия на сайте. Не используй его для платежей, удаления данных или отправки сообщений без ручного подтверждения.

5. Supabase или Postgres — данные через агента

Нужен, если агент помогает читать схему, писать SQL, проверять таблицы или собирать backend-прототип.

Риск: база данных почти всегда чувствительная зона. Начинай с read-only пользователя или dev-проекта.

6. Notion или Google Drive — документы как контекст

Нужны, если у тебя уже есть рабочая база знаний в документах.

Риск: такие серверы могут открывать агенту больше личного контекста, чем кажется. Подключай отдельное workspace-пространство или ограниченный аккаунт.

7. Web search / crawl — поиск и чтение страниц

Нужны для ресёрча, мониторинга, сравнения инструментов и подготовки материалов.

Риск: свежие данные не всегда точны. Агент должен возвращать источники, а не просто уверенный пересказ.

8. Figma / 21st Magic — дизайн и UI

Нужны, если агент помогает проектировать компоненты, переносить дизайн в код или искать UI-паттерны.

Используй такие серверы как помощников по идеям и структуре, а не как источник истины. Итоговый UI всё равно нужно адаптировать под дизайн-систему проекта, проверить на mobile/desktop и прогнать через реальные сценарии.

Как выбирать сервер без хаоса

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

Если на эти вопросы нет ответа, сервер пока не ставь.

Минимальный набор для старта

Не начинай с 15 серверов сразу. Лучше собрать маленький набор под реальные задачи и расширять его только после проверки.

Такой набор закрывает разработку, проверку, контент и дизайн без лишней поверхности атаки.

Проверка после установки

Не считай MCP подключённым, пока не сделал маленький тест.

Примеры безопасных тестов:

Покажи список доступных tools от сервера, ничего не меняя.

Прочитай README репозитория, но не создавай issues и не открывай PR.

Открой локальную страницу и опиши видимые блоки, не отправляй формы.

Частые ошибки

• поставить сразу десять серверов и не понимать, какой из них что делает;
• давать write-токены там, где достаточно read-only;
• хранить ключи в JSON внутри репозитория;
• подключать файловый сервер ко всему домашнему каталогу;
• не проверять официальный источник пакета;
• забывать, что MCP-сервер — это код, который запускается на твоей машине или сервере.

Результат

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

Claude Code — важный клиент, но не единственный. Хороший MCP-набор должен помогать человеку собрать систему, которая работает с его реальными инструментами: Codex, Claude, Cursor, OpenCode, локальными файлами, браузером, репозиториями и базой знаний.