3 сентября 20267 мин чтения

Подключаем внешние инструменты к Claude Code c помощью MCP

MCP (Model Context Protocol) — способ научить Claude Code работать с внешними сервисами: Google Sheets, Notion, Confluence, Jira и сотнями других.

Кураторы Школы Вани Замесина

Автор гайда

Подключаем

внешние инструменты к Claude Code c помощью MCP

Зачем: MCP (Model Context Protocol) — это способ научить Claude Code работать с внешними сервисами: Google Sheets, Notion, Confluence, базами данных и сотнями других. Вместо того чтобы переключаться между окнами, вы можете попросить Claude прямо из терминала: создать PR, найти сообщения в Telegram, добавить задачу в Jira. МСP – это мост между Claude Code и внешним миром.

Требуется: Claude Code (macOS
| Windows)

---

Что можно делать с MCP

После подключения MCP-серверов вы можете попросить Claude:

«Создай тикет в Jira: баг с оплатой на iOS, приоритет высокий»
«Добавь заметку в Notion: проверить дизайн главной страницы»
«Покажи все открытые тикеты в Linear со статусом “В работе”»
«Добавь строку в Google Sheets с результатами A/B теста»
«Найди в Confluence документ про онбординг»
«Покажи комментарии к макету главной страницы в Figma»

Claude сам поймёт, какой сервер использовать, и выполнит запрос.

---

Как добавить MCP-сервер

Есть два типа серверов:

Удалённый — сервер работает в интернете, мы просто

подключаемся к нему. Как заказать еду: готовят где-то там, вам привозят результат.

Локальный — сервер запускается на вашем компьютере.

Как готовить дома: всё происходит у вас.

Удалённый сервер

Подключается к облачному сервису по URL:

claude mcp add --transport http название https://url-сервера

Пример для Notion:

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

название — это просто идентификатор, который вы сами
выбираете. Может быть любым: notion, my-notes,
work-tool.

Локальный сервер

Запускается на вашем компьютере через команду:

claude mcp add название -- npx имя-пакета

Если npx не найден — установите Node.js

или:

claude mcp add название -- uvx имя-пакета

Если uvx не найден — установите:
curl -LsSf https://astral.sh/uv/install.sh | sh

Пример – MCP-сервер для управления временем (конвертация часовых поясов, вычисление дат):

claude mcp add time -- uvx mcp-server-time

Совет: Иногда в инструкциях по установке MCP-сервера вы найдёте только JSON-конфигурацию, например:

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

Не переживайте! Просто попросите Claude в чате:

«Преобразуй этот JSON в команду claude mcp add»

И Claude сгенерирует готовую команду:

claude mcp add everything -- npx -y @modelcontextprotocol/server-everything

Это основные способы установить MCP-сервер. Способы установки
некоторых серверов могут выглядеть иначе. Команды и шаги для установки
конкретного сервера всегда можно найти в инструкции по установке.
Попросите Claude помочь с установкой MCP-сервера, дав ему URL инструкции
по установке или скопировав текст инструкции.

По умолчанию сервер добавляется только для текущего проекта (папки). Если вы откроете другой проект — сервер там не будет доступен.

Чтобы сервер был доступен во всех ваших проектах, добавьте --scope user:

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

---

Управление MCP-серверами

Список всех установленных серверов:

claude mcp list

Детали конкретного сервера:

claude mcp get github

Удалить сервер:

claude mcp remove github

Внутри Claude Code — статус серверов и авторизация:

/mcp

---

Авторизация в сервисах

Многие сервисы требуют авторизации через браузер. Вот как это сделать:

Шаги:

Добавьте сервер командой claude mcp add
Запустите Claude Code (claude)
Введите /mcp
Выберите сервер и нажмите «Authenticate»
Откроется браузер — войдите в свой аккаунт и разрешите доступ
Вернитесь в терминал — авторизация завершена

Подсказка: Если браузер не открылся автоматически,
скопируйте ссылку из терминала и откройте вручную.

Авторизация через токен

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

claude mcp add --transport http github https://api.githubcopilot.com/mcp --header "Authorization: Bearer YOUR_GITHUB_PAT"

В данном случае токен авторизации передаётся через флаг --header (или -H).

При локальной установке токен передаётся через --env (или -e):

claude mcp add firecrawl --env FIRECRAWL_API_KEY=ваш-ключ -- npx -y firecrawl-mcp

Токен обычно можно получить в настройках сервиса. Также могут использоваться специфичные для MCP-сервера флаги для передачи токена (например, –api-token).

Если в инструкции указан только JSON без команды установки — попросите Claude преобразовать его в команду claude mcp add. Например:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": ""
      }
    }
  }
}

Преобразуется в:

claude mcp add bright-data -e API_TOKEN=ваш-токен -- npx @brightdata/mcp

Важно: Некоторые MCP-серверы могут требовать иные
команды и флаги при подключении. Подробности установки стоит искать в
инструкции к конкретному серверу. Попросите Claude помочь с установкой
MCP-сервера, дав ему URL инструкции по установке или скопировав текст
инструкции.

---

Практический

пример: простой сервер без авторизации

Начнём с самого простого — сервер Time показывает текущее время и конвертирует часовые пояса. Никаких API-ключей и авторизации не нужно.

1. Добавляем сервер Time

claude mcp add time -- uvx mcp-server-time

2. Запускаем Claude Code

claude

3. Используем

Сколько времени пройдёт между 10:00 по Москве и 15:00 по Нью-Йорку?

Готово! Сlaude Code будет использовать MCP-сервер
для точной работы со временем. Это самый быстрый способ попробовать
MCP.

---

Практический

пример: сервер с авторизацией (Atlassian)

Atlassian (Jira + Confluence) требует авторизации через браузер, чтобы Claude Code мог работать с вашими задачами и документами.

1. Добавляем Atlassian

claude mcp add --transport http atlassian https://mcp.atlassian.com/v1/mcp

2. Запускаем Claude Code

claude

3. Пишем команду /mcp

/mcp

В списке выбираем Atlassian → Authenticate → перенаправляет в браузер

4. В браузере нажимаем Approve, после чего вводим свои учетные данные для входа

5. После ввода учетных данных проверяем подключение в терминале и видим, что Atlassian подключён

6. Используем

Покажи все мои открытые задачи в Jira

---

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

MCP-серверы могут предоставлять ресурсы, на которые можно ссылаться через @ — так же, как вы ссылаетесь на файлы.

Как это работает:

Напишите @ в своём запросе — появится меню с доступными

ресурсами

Выберите нужный ресурс или напишите путь вручную

Формат: @сервер:тип://путь

Примеры:

Проанализируй @jira:issue://PROD-123 и предложи план действий

Найди в @confluence:page://onboarding информацию про первые шаги

Сравни @notion:page://roadmap-q1 с @notion:page://roadmap-q2