# 1. ЧТО ТАКОЕ MCP И ЗАЧЕМ

Model Context Protocol (MCP) — открытый протокол от Anthropic, который даёт LLM доступ к внешним инструментам и данным. Claude может читать файлы, искать в интернете, работать с GitHub и базами данных — всё через стандартизированный JSON-RPC интерфейс. MCP работает по архитектуре клиент-сервер: Claude Desktop — клиент, а ваши инструменты — MCP-серверы.

# Архитектура MCP
from mcp import Server

# Claude Desktop (клиент) ↔ JSON-RPC ↔ MCP-сервер (инструменты)
server = Server("my-tools")

@server.tool()
def read_file(path: str) -> str:
    """Читает содержимое файла"""
    with open(path) as f:
        return f.read()

# 2. УСТАНОВКА CLAUDE DESKTOP И MCP

Скачайте Claude Desktop с официального сайта Anthropic. Для работы MCP-серверов потребуется Node.js (рекомендуется версия 18+) и Python 3.10+. Установите всё необходимое одной командой.

# macOS — установка через Homebrew
brew install node python@3.11

# Ubuntu/Debian
sudo apt install nodejs npm python3 python3-pip -y

# Установка MCP CLI (опционально)
npm install -g @modelcontextprotocol/inspector

# Проверка версий
node --version  # должно быть ≥ 18
python3 --version  # должно быть ≥ 3.10

# 3. MCP-СЕРВЕР ДЛЯ ФАЙЛОВОЙ СИСТЕМЫ

Настройте официальный MCP-сервер filesystem — он даст Claude доступ к чтению и записи файлов в указанной директории. Конфигурация хранится в claude_desktop_config.json.

// claude_desktop_config.json — macOS: ~/Library/Application Support/Claude/
// Windows: %APPDATA%\Claude\
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Documents"
      ]
    }
  }
}

После добавления перезапустите Claude Desktop. В интерфейсе появится индикатор подключённых MCP-инструментов. Claude сможет читать файлы из ~/Documents, создавать заметки и искать по содержимому.

# 4. MCP-СЕРВЕР ДЛЯ GITHUB

GitHub MCP-сервер позволяет Claude управлять issues, pull requests, репозиториями и поиском кода. Потребуется GitHub Personal Access Token с нужными правами.

// claude_desktop_config.json — добавляем github сервер
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Токен создаётся в Settings → Developer Settings → Personal Access Tokens → Fine-grained tokens. Нужны права: Read access to issues, metadata, pull requests. Claude сможет: создавать issue, читать PR, искать репозитории, комментировать код.

# 5. MCP-СЕРВЕР ДЛЯ БРАУЗЕРА

Puppeteer MCP-сервер даёт Claude возможность открывать сайты, делать скриншоты, кликать по элементам и извлекать данные — как программируемый браузер.

// claude_desktop_config.json — добавляем puppeteer сервер
{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-puppeteer"
      ]
    }
  }
}

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

# 6. ПРОВЕРКА РАБОТЫ

Перезапустите Claude Desktop и проверьте, что MCP-серверы подключены. В интерфейсе появится значок инструментов в правом нижнем углу. Сделайте тестовый запрос.

# Тестовые запросы к Claude:

# 1. Файловая система
"Прочитай файл ~/Documents/notes.txt и покажи его содержимое"

# 2. GitHub
"Найди открытые issues в репозитории anthropics/anthropic-cookbook"

# 3. Браузер (Puppeteer)
"Открой news.ycombinator.com, сделай скриншот и покажи топ-5 заголовков"

# Если инструменты не отображаются — проверь логи:
tail -f "~/Library/Logs/Claude/mcp*.log"

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