MCP в Claude Code: подключение серверов, области действия, удалённый MCP и реальные примеры

Добавление сервера

# local server over stdio (runs the command, talks over its stdin/stdout)
claude mcp add playwright -- npx @playwright/mcp@latest

# remote server over HTTP
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# with a header (API-key style auth)
claude mcp add --transport http posthog https://mcp.posthog.com/mcp \
  --header "Authorization: Bearer $POSTHOG_API_KEY"

claude mcp list      # what is configured
claude mcp remove playwright

Серверы stdio — это программы, которые Claude Code запускает за вас; большинство серверов сообщества представляют собой пакеты npm или Python, запускаемые таким способом. Удалённые серверы задаются URL; они используют аутентификацию через OAuth (выполните /mcp в сеансе и пройдите процедуру в браузере) или через заголовок, который вы передаёте при добавлении, как в примере с PostHog. Актуальный URL ищите в документации поставщика: адреса удалённых серверов меняются.

Области действия и .mcp.json

• local (по умолчанию) — сохраняется в ваших пользовательских настройках и действует только для этого проекта. Личные, приватные серверы.
• project (--scope project) — записывается в .mcp.json в корне репозитория и доступно всем, кто его клонирует. При первом обращении Claude Code запрашивает разрешение доверять серверам проекта.
• user (--scope user) — доступно во всех проектах на вашем компьютере.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "${DATABASE_URL}"]
    }
  }
}

.mcp.json поддерживает подстановку переменных окружения, поэтому определение сервера можно включить в репозиторий, а каждый разработчик укажет собственные учётные данные.

Использование сервера в сеансе

После подключения инструменты сервера сразу становятся доступны: попросите «ошибки из PostHog за последние 24 часов», и Claude Code вызовет инструмент. На ресурсы, предоставляемые сервером, можно ссылаться через @-упоминания (@github:issue://123), чтобы добавлять их в контекст по запросу. Промпты, определённые сервером, отображаются как команды с косой чертой в /mcp__<server>__<prompt>. /mcp показывает состояние подключения, позволяет переподключиться или пройти аутентификацию и выводит все инструменты с их описаниями.

Примеры, которые стоит использовать

• PostHog MCP — продуктовая аналитика прямо из агента: «каким флагом функции управляется этот код и как идёт её развёртывание?» PostHog предоставляет удалённый MCP-сервер; добавьте его с помощью --transport http и своего персонального ключа API в заголовке Bearer.
• GitHub — задачи и запросы на слияние в качестве контекста; используйте вместе с Action из руководства по GitHub для цикла проверки.
• Playwright — настоящий браузер для сквозных тестов и проверки интерфейса, который вы только что изменили; см. руководство по автоматизации QA.
• Postgres / SQLite — запросы и миграции с учётом схемы; используйте учётную запись с доступом только для чтения, если не намерены вносить изменения.
• Файловая система за пределами репозитория — --add-dir проще использовать для дополнительных каталогов; MCP предназначен для того, что не является файлами.

Стоимость и контекст

Каждый результат инструмента, возвращаемый MCP-сервером, попадает в разговор и затем повторно отправляется на каждом следующем шаге. Сервер, возвращающий 5,000 строк, резко раздувает контекст. Предпочитайте инструменты с ограничениями, запрашивайте краткие сводки и выполняйте /compact после объёмного запроса. Серверы работают локально или обращаются к поставщику; их запросы не проходят через эндпоинт модели, поэтому ANTHROPIC_BASE_URL=https://aiprimetech.io не затрагивается — оплачиваются только токены, занимаемые результатами.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Часто задаваемые вопросы

AI Prime Tech — независимый API-шлюз, который не связан с Anthropic, не одобрен и не спонсируется этой компанией. «Claude» и «Claude Code» — товарные знаки Anthropic. Описанные здесь возможности Claude Code соответствуют публичной документации Anthropic на момент написания и часто меняются; цены и списки моделей на этой странице берутся из текущих настроек шлюза.