раздел 07

MCP - подключение Claude к внешним инструментам

MCP (Model Context Protocol) - открытый протокол от Anthropic, который позволяет Claude разговаривать с внешними сервисами через единый интерфейс. GitHub, браузер, Postgres, Slack, Linear, Notion, Figma - всё подключается одной командой claude mcp add.

Зачем

До MCP: чтобы Claude мог работать с GitHub, надо было либо копипастить туда-сюда issues, либо писать кастомный скрипт. С MCP: установили github MCP-сервер - и Claude умеет:

  • читать pull request'ы, оставлять комментарии, делать review
  • открывать issues, искать по ним
  • читать релизы, теги, ветки
  • мерджить PR (если есть права)

То же самое с десятками других сервисов. Один протокол, разные провайдеры.

Минимальная установка

# Добавить MCP-сервер для GitHub
claude mcp add github --transport stdio -- npx -y @modelcontextprotocol/server-github

# Добавить MCP-сервер для управления браузером через Playwright
claude mcp add playwright -- npx -y @playwright/mcp@latest

# Добавить Context7 - актуальная документация по библиотекам
claude mcp add context7 -- npx -y @upstash/context7-mcp

# Проверить, что подключилось
claude mcp list

После этого в любом чате Claude видит доступные tools от этих серверов. Можно сказать "проверь, есть ли в react-router 7.x новый API для дата-роутинга" - и Claude через Context7 сам дёрнет актуальную документацию.

Виды MCP-серверов

По транспорту:

  • stdio - локальный процесс, общение через stdin/stdout. Самый частый случай.
  • http - удалённый сервер по HTTP. Удобно для shared-инструментов.

По области видимости (scope):

  • user - доступен везде, лежит в ~/.claude.json
  • project - доступен только в этом проекте, лежит в .mcp.json в репо (можно коммитить)
  • local - только для текущей сессии

Топ-10 MCP-серверов, которые стоит подключить сразу

1.  github          - GitHub API (PR, issues, releases)
2.  playwright      - управление браузером для тестов и скрапинга
3.  context7        - актуальная документация по любым библиотекам
4.  filesystem      - расширенный доступ к файлам вне рабочей директории
5.  postgres        - SQL-запросы к Postgres из Claude
6.  slack           - чтение/отправка сообщений в Slack
7.  sentry          - чтение ошибок из Sentry
8.  linear          - issues, проекты, циклы в Linear
9.  notion          - чтение и обновление страниц в Notion
10. figma           - чтение дизайнов из Figma (для перевода в код)

Что в этом разделе

01
Установка MCP-серверов
claude mcp add, stdio vs http, scope (project/user/local).
02
Где живёт конфиг
~/.claude.json, .mcp.json в проекте, переменные окружения.
03
Топ-10 MCP-серверов
github, playwright, context7, filesystem, postgres, slack, sentry, linear, notion, figma.
04
Свой MCP-сервер
Минимальный пример на Python и TypeScript - 50 строк кода.

Полезные ссылки