💭 в уме · писать не нужно
Представь: Claude Code — посольство твоей страны в чужом городе. Без посольства ты не можешь официально говорить с местной властью — есть барьер протокола.
Не представляй это как «технический вопрос». Представь молчаливый кордон между государствами: без посла и переводчика стороны смотрят друг на друга и не могут обменяться ни словом. Какой внешний «сосед» сейчас молча стоит у твоего кордона — GitHub, Notion, браузер, Telegram?
Удержи его в голове: что первым нарушит молчание?
💭 в уме · писать не нужно
MCP — это общий дипломатический язык: посольство уже знает, как говорить с любой страной через единый протокол.
Не думай об этом как о «подключении инструментов». Представь телеграфный кабель между двумя станциями: радиооператор с обеих сторон знает азбуку Морзе — и не важно, кто там на другом конце, сигнал пройдёт. Один протокол вместо тысячи двусторонних договоров.
Прокрути в голове: если MCP — это общая азбука, какую первую «телеграмму» ты бы отправил?
| Примитив | Управляется | Что это |
|---|---|---|
| Tools | Моделью | Функции, которые агент вызывает: API-промпты, запись файлов |
| Resources | Приложением | Источники данных (как GET-промпты): файлы, записи БД |
| Prompts | Пользователем | Шаблоны для оптимального использования |
Проще всего — командой в терминале, из папки проекта. Например, официальный сервер поиска Brave:
claude mcp add --scope project brave-search -- npx -y @brave/brave-search-mcp-server
Серверу нужен API-ключ Brave — как его передать, написано в README пакета.
Для других серверов имя пакета бери из их README: имена меняются, актуальное всегда там же. Там же написано, как передать токен. Официальный сервер GitHub — github/github-mcp-server: у него есть удалённый адрес https://api.githubcopilot.com/mcp/ и образ Docker, способ подключения описан в его README. Старые пакеты @modelcontextprotocol/server-github и @modelcontextprotocol/server-brave-search заархивированы и больше не обновляются.
С --scope project Claude Code запишет сервер в файл .mcp.json в корне проекта — он общий для команды и лежит в git. Его можно править и руками: