Представьте: вы работаете в Claude Desktop и хотите напрямую управлять активной сессией Claude Code в терминале — передавать задачи, получать результаты, не переключаясь между окнами. Именно это и реализовал разработчик, создавший MCP-сервер-мост между двумя продуктами Anthropic. Разбираемся, как это работает, зачем нужно и как поднять у себя.

Что такое MCP и почему это важно

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

ℹ Справка
MCP был представлен Anthropic в ноябре 2024 года. С тех пор экосистема серверов выросла до сотен реализаций — от интеграций с GitHub и Postgres до управления браузером через Playwright.

Claude Desktop — десктопный клиент с поддержкой MCP. Claude Code — консольный агент-кодировщик, работающий прямо в терминале разработчика. Оба продукта от Anthropic, но по умолчанию они изолированы друг от друга. MCP-сервер-мост устраняет этот разрыв.

Архитектура решения

Принцип работы прост, но элегантен. MCP-сервер запускается как локальный процесс и выступает посредником:


graph LR
    A[Claude Desktop] -->|MCP-запрос| B[MCP Bridge Server]
    B -->|stdin/stdout| C[Claude Code сессия]
    C -->|результат| B
    B -->|ответ| A
    D[Терминал разработчика] --- C
  1. Claude Desktop отправляет команду через MCP-протокол.
  2. MCP-сервер принимает её и транслирует в активную сессию Claude Code.
  3. Claude Code выполняет задачу — пишет код, запускает тесты, работает с файлами.
  4. Результат возвращается обратно в Desktop.

Взаимодействие строится поверх стандартных потоков ввода-вывода (stdin/stdout), что делает решение кроссплатформенным и не требующим дополнительных зависимостей.

Суть идеи — превратить Claude Code из «чёрного ящика в терминале» в управляемый инструмент, доступный из любого MCP-совместимого клиента.

Установка и настройка

Шаг 1. Клонирование репозитория

git clone https://github.com/example/claude-code-mcp-bridge
cd claude-code-mcp-bridge
npm install

Шаг 2. Конфигурация Claude Desktop

Откройте файл конфигурации Claude Desktop. На macOS он находится по пути:

~/Library/Application Support/Claude/claude_desktop_config.json

Добавьте секцию для нового MCP-сервера:

{
  "mcpServers": {
    "claude-code-bridge": {
      "command": "node",
      "args": ["/path/to/claude-code-mcp-bridge/index.js"],
      "env": {
        "CLAUDE_CODE_SESSION_DIR": "/tmp/claude-code-sessions"
      }
    }
  }
}

Шаг 3. Запуск Claude Code с поддержкой сессий

claude --session-id my-project --session-dir /tmp/claude-code-sessions

После этого Claude Desktop увидит активную сессию и сможет отправлять в неё задачи.

⚠ Важно
Сессионная директория должна быть доступна обоим процессам одновременно. При работе в Docker или remote-окружении потребуется настройка общих томов или SSH-туннелей.

Практические сценарии использования

Сценарий 1: Оркестрация сложных задач

Вы описываете задачу в естественном языке в Claude Desktop — «Отрефактори модуль авторизации, добавь тесты, обнови документацию». Desktop разбивает её на подзадачи и последовательно направляет в Claude Code, который работает непосредственно с вашим репозиторием.

Сценарий 2: Параллельные агенты

Можно запустить несколько сессий Claude Code с разными session-id и управлять ими как командой: один агент пишет бэкенд, другой — фронтенд, третий — тесты. Claude Desktop координирует работу.

Сценарий 3: Аудит и объяснение кода

Claude Code выполняет изменения, а Claude Desktop получает результаты и объясняет их нетехническому менеджеру или формирует PR-описание автоматически.

📝 Пример промпта

В Claude Desktop: «Попроси claude-code проверить, нет ли SQL-инъекций в файлах в папке /src/api, и выведи список уязвимых мест с объяснением».

Desktop транслирует задачу в Code, получает отчёт и форматирует его для вас.

Сравнение подходов к интеграции Claude Code

ПодходСложность настройкиИнтерактивностьМультисессионностьПодходит для
Прямой CLIНизкаяВысокаяНетРучная работа в терминале
MCP-мост (данное решение)СредняяВысокаяДаАвтоматизация из Desktop
REST API обёрткаВысокаяСредняяДаСерверные пайплайны
Встроенный IDE-плагинНизкаяСредняяНетРабота в редакторе

MCP-мост выигрывает там, где нужна интерактивность и управление несколькими агентами одновременно без написания собственного API.

Ограничения и что стоит учесть

Безопасность. Claude Code работает с реальной файловой системой и может выполнять команды. Убедитесь, что сессионная директория не доступна извне, а в промптах не передаются секреты.

Стабильность сессий. Если Claude Code-процесс упадёт, мост потеряет соединение. В текущей реализации нет автоматического переподключения — это ручная работа.

Контекстные окна. Длинные сессии Claude Code накапливают контекст. При передаче задач через мост следите за тем, чтобы суммарный контекст не превышал лимиты модели.

💡 Совет
Для продакшн-сценариев добавьте watchdog-процесс, который перезапускает Claude Code при сбое и уведомляет Desktop через MCP об изменении статуса сессии.

Заключение

MCP-сервер-мост между Claude Desktop и Claude Code — это практичное решение для разработчиков, которые хотят использовать лучшее из двух инструментов: удобный чат-интерфейс Desktop и мощный агент-кодировщик Code. Архитектура простая, установка занимает 10–15 минут, а сценарии применения ограничены только фантазией.

Главный вывод: MCP превращает изолированные AI-инструменты в компонуемую систему. Сегодня вы связываете два продукта Anthropic, завтра — добавляете в цепочку базу знаний, CI/CD-систему и таск-трекер. Именно в этой компонуемости и есть настоящая ценность протокола.

Будущее AI-разработки — не один умный агент, а оркестр специализированных агентов, управляемых через единый протокол.