Раздел 02 из 08

Триада: Claude CLI vs MCP vs ACP

Три похожих по звучанию слова, которые постоянно путают: Claude CLI, MCP, ACP. Разведи их один раз — и дальше всё встаёт на места. Логика такая: есть исполнитель (agent), у него есть доступы к данным и системам (MCP), и есть место, откуда ты им управляешь — терминал или редактор через ACP. Три разные сущности, каждая про своё.

Зачем это знать

Цель — не «AI вместо Google», а исполнитель с руками и доступом к твоим данным: PayEm-выгрузка, Excel, база. Триада отвечает на три вопроса: кто работает, через что дотягивается до данных, откуда ты отдаёшь команды.

1. Claude CLI (Claude Code) — сам исполнитель

Что это

Claude Code — это и есть agent целиком, а не «доступ к нему»: модель Claude, которая думает, плюс инструменты — читать и писать файлы, запускать команды, работать с git. Запускаешь в терминале командой claude из рабочей папки и общаешься обычным текстом.

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

мозг Модель читает задачу, строит план, проверяет себя.

руки Инструменты: открыть PayEm-выгрузку, посчитать суммы, записать результат в новый файл, выполнить команду.

Запуск — две строки:

# зашла в папку, где лежит выгрузка за месяц
cd ~\Documents\AI\payem-june

# позвала сотрудника
claude

Дальше обычный диалог: «прочитай payem-june.csv, раздели операции по категориям по ключевым словам в описании и выпиши отдельным файлом всё, что выбивается из обычной картины». Перед тем как что-то записать или выполнить, он показывает, что собирается сделать, и спрашивает разрешение. Систему permission разбираем в соседней секции — здесь достаточно: CLI = сам исполнитель.

Главное про CLI

Это не канал связи и не протокол, а работник. claude в терминале = «на месте, жду задачу». Остальное в триаде — про то, к чему он подключён и откуда ты им рулишь.

2. MCP — доступ к твоим данным и инструментам

Что это

MCP (Model Context Protocol) — стандарт, по которому agent подключается к внешним системам: папки с файлами, база данных, Excel/Google Sheets, Gmail, API твоего ERP. Внутри своей папки агент работает с файлами сам. А чтобы дотянуться наружу — в базу, в почту, в чужую систему — он идёт через MCP. Думай о нём как о связке ключей: «доступ к базе проводок», «доступ к папке выписок», «пропуск, чтобы скачать страницу с курсами валют». Каждый ключ — отдельный MCP server.

MCP server — это программа-переходник. Она знает, как разговаривать с конкретной системой (SQLite, Postgres, файловая система), и даёт агенту понятный набор действий: прочитать, найти, записать. Подключаешь один раз — дальше агент ею пользуется.

MCP serverК чему даёт доступГде пригодится Рене
filesystemК указанной папке с файламиВыгрузки PayEm, экспорт-файлы для חשבשבת/ERP, архив за прошлые месяцы
БД-коннектор (SQLite / Postgres)К базе данных (читать и запрашивать)Своя база проводок или зеркало данных из SAP B1, чтобы агент сверял суммы и искал аномалии
fetchСкачать страницу/данные по URLКурсы валют, справочные данные, публичные API

Подключение — одна команда, программировать ничего не надо:

# дать сотруднику ключ от папки с выгрузками
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~\Documents\AI

# посмотреть, какие ключи уже выданы
claude mcp list
Сколько MCP нужно на старте

Не подключай всё сразу. Для начала хватит одного-двух: filesystem и, когда дойдёшь до сверок по базе, — sqlite или postgres. Остальное добавишь, когда упрёшься в конкретную задачу.

3. ACP — связь между редактором и исполнителем

Что это

ACP (Agent Client Protocol) — стандарт, по которому редактор кода (например, Zed или Neovim) разговаривает с агентом, чтобы запускать его прямо внутри редактора, с нормальным графическим интерфейсом, а не только в чёрном окне терминала. ACP отвечает на вопрос «откуда ты управляешь исполнителем», а не «к чему он подключён».

Agent один и тот же. Меняется только твоё рабочее место: либо узкое окно терминала, либо редактор с UI, где видно диффы, файлы и историю. Доступы те же — другое только удобство.

MCP — это не ACP

MCP смотрит «вниз», в данные: к чему agent подключён (базы, файлы, внешние системы).

ACP смотрит «вверх», к тебе: откуда ты управляешь агентом (терминал или редактор с UI).

Разные провода, взаимозаменяемыми не бывают.

Нужен ли ACP сейчас

Нет. На старте достаточно терминала и команды claude для всех трёх твоих задач. ACP/Zed — это «потом», когда захочется более наглядного интерфейса.

Как это собирается вместе

   ТЫ                          СОТРУДНИК                    ДАННЫЕ И СИСТЕМЫ
┌──────────────┐            ┌─────────────────┐          ┌──────────────────────┐
│ Терминал     │            │  Агент Claude   │          │  файлы (PayEm-экспорт)│
│   или Zed    │──CLI/ACP──▶│  мозг + руки    │───MCP───▶│  база проводок (SQL)  │
│ (рабочее     │            │  (Claude Code)  │          │  SAP B1 / חשבשבת      │
│  место)      │            │                 │          │  курсы валют (fetch)  │
└──────────────┘            └─────────────────┘          └──────────────────────┘
   откуда                       кто                          к чему подключён
  управляешь                 работает
ЧтоЧто этоЧто соединяетМетафораНужно на старте?
Claude CLIСам агент: мозг + руки— (это сам работник)Новый сотрудник за столом✅ Да, обязательно
MCPСтандарт подключения к данным/инструментамАгент ⟷ внешние системыUSB-розетка / связка ключей✅ Да, 1–2 server'а
ACPСтандарт связи редактора с агентомРедактор ⟷ агентПереговорный стол с экраном⚠️ Опционально, потом

Мини-глоссарий

Claude CLI

Сам agent Claude Code, запускается в терминале командой claude. Мозг (модель) + руки (файлы, команды).

MCP server

Программа-переходник, дающая агенту доступ к одной внешней системе (папка, база, URL). Подключается через claude mcp add.

ACP

Протокол, которым редактор (Zed, Neovim) запускает agent у себя с графическим интерфейсом. Для тебя — позже.

Если запомнить только одно

Исполнитель (CLI) дотягивается до данных через MCP, а ты командуешь им из терминала (или позже из редактора через ACP). Три провода, три роли.