Как подключить ИИ-агента для программирования к вашим собственным инструментам с помощью MCP

Если вы уже поработали с ИИ-агентом для программирования, вы, скорее всего, натыкались на стену, когда он говорит что-то вроде «Я не вижу вашу базу данных» или «вставьте сюда детали задачи». Агент умён, но он заперт в коробке — он знает только то, что есть в ваших файлах, и то, что вы вводите. Model Context Protocol (MCP) — это то, как вы сносите эту стену и позволяете агенту дотянуться до ваших реальных инструментов: базы данных, GitHub, панели мониторинга, файла с дизайном.

Это руководство объясняет, что такое MCP, и на практике показывает, как подключить ваш первый сервер к Claude Code, причём те же идеи применимы к Cursor и Copilot.

Что такое MCP на самом деле

MCP — это открытый стандарт. Считайте его универсальным переходником между ИИ-агентами и системами, которыми вы уже пользуетесь. Вместо того чтобы каждый инструмент изобретал собственный способ общения с каждым агентом, инструмент поставляет один MCP-сервер, и любой агент с поддержкой MCP (Claude, Cursor, Copilot) может к нему подключиться. Вот почему в 2026 году вы видите «MCP» повсюду: это те самые «трубы», которые позволяют агентам делать реальную работу, а не просто говорить о ней.

Хорошее эмпирическое правило: подключайте сервер всякий раз, когда ловите себя на том, что копируете данные в чат из другого инструмента. Если вы постоянно вставляете логи ошибок из Sentry или детали тикетов из Jira — это сигнал, что MCP-сервер избавит вас от лишних хождений.

Два вида серверов

Вы встретите два варианта:

• Удалённые (HTTP) серверы работают в облаке, и вы подключаетесь к ним по сети — Notion, GitHub и большинство SaaS-инструментов работают именно так. Это рекомендуемый вариант по умолчанию.
• Локальные (stdio) серверы запускаются как процесс на вашей собственной машине — полезны для того, что требует прямого доступа к системе, например, драйвера локальной базы данных.

Добавляем ваш первый сервер

Основная команда — claude mcp add. Вот базовый вид для удалённого HTTP-сервера:

claude mcp add --transport http <name> <url>

Конкретный пример — подключаем Notion, чтобы ваш агент мог читать и обновлять страницы:

claude mcp add --transport http notion https://mcp.notion.com/mcp

Если серверу нужна аутентификация, передайте токен в виде заголовка:

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

Для локального сервера всё, что идёт после --, — это команда, которая его запускает:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Эти -- важны: они отделяют собственные флаги Claude от команды, запускающей сервер, чтобы --port, предназначенный для сервера, не был воспринят как опция Claude.

После добавления проверьте, что вы подключили:

claude mcp list        # see all servers and their status
claude mcp get notion  # details for one server

Внутри сессии Claude Code команда /mcp показывает актуальный статус подключения, а для серверов, использующих OAuth, позволяет войти в аккаунт.

Выберите правильную область видимости

Когда вы добавляете сервер, решите, кто должен его видеть, с помощью флага --scope:

• local (по умолчанию) — только вы, только этот проект.
• project — общий для всей вашей команды через закоммиченный файл .mcp.json. Отлично подходит для онбординга: новый коллега клонирует репозиторий, и агент уже знает об инструментах команды.
• user — доступен вам во всех проектах на вашей машине.

Для командной базы данных или трекера задач обычно нужна область project. Для личного API-ключа оставьте local или user, чтобы он никогда не попал в репозиторий.

Делайте это безопасно

MCP мощен именно потому, что даёт агенту реальный охват, — поэтому немного осторожности не помешает:

• Доверяйте серверу, прежде чем подключать его. Сервер, который загружает внешний контент, может подвергнуть вас риску prompt-инъекции, когда вредоносный текст в загруженных данных пытается направить вашего агента в нужную злоумышленнику сторону. Придерживайтесь официальных серверов от известных вам поставщиков.
• Жёстко ограничивайте права доступа для учётных данных. Дайте серверу ключ только для чтения или с минимально необходимыми правами, когда задача требует лишь чтения. Именно этот принцип Microsoft заложила в свой корпоративный плагин Dataverse — агент всегда видит только то, что разрешает выданная ему роль.
• Держите секреты вне общей конфигурации. Помещайте токены в переменные окружения или в область local, но никогда — в закоммиченный файл .mcp.json с областью project.
• Проверяйте, что он может делать. После подключения откройте /mcp и просмотрите инструменты, которые предоставляет сервер, чтобы не было сюрпризов.

Выгода

Как только сервер подключён, изменение в том, как вы работаете, ощущается сразу. Вместо «вот схема, которую я вставил» вы можете попросить: «Найди 10 самых недавних регистраций в нашей базе данных Postgres и составь для каждой приглашение на сессию обратной связи». Агент делает запрос к базе, читает результаты и составляет письма — всё в одном потоке, потому что он наконец-то может дотянуться до систем, в которых на самом деле живёт ваша работа.

Начните с одного сервера для того инструмента, из которого вы вставляете чаще всего. Одно это подключение обычно делает ценность очевидной быстрее, чем любое количество чтения об этом.