Установка MCP в Claude Code (CLI)
Как добавить MCP-сервер в Claude Code — терминальный AI-агент Anthropic. Команды claude mcp add, scope, env-переменные.
Обновлено:
Что такое Claude Code
Claude Code — официальный CLI-агент Anthropic для разработчиков. Работает в терминале, видит файловую систему, может править код. Включает MCP-поддержку из коробки.
Установка:
npm install -g @anthropic-ai/claude-code
# или
brew install --cask claude-code
Проверка: claude --version.
Добавление MCP
Пример ФНС с MCP_FNS_API_KEY требует клиента с поддержкой размещённого режима.
Проверьте версию и условия подключения;
ключ и квота общие для ваших клиентов.
В Claude Code MCP добавляются командой claude mcp add:
# Минимальный (без env-vars)
claude mcp add atomno-cbr-rates -- uvx atomno-mcp-cbr-rates
# С env-vars
claude mcp add atomno-fns-check \
-e MCP_FNS_API_KEY=YOUR_ATOMNO_API_KEY \
-- uvx atomno-mcp-fns-check
Синтаксис:
- Перед
--идут флаги командыmcp add(имя, env, scope). - После
--— реальная команда запуска MCP.
Scope
В Claude Code есть 3 уровня MCP-конфигов (флаг -s):
| Scope | Где хранится | Когда использовать |
|---|---|---|
local (default) | .claude.json рядом с pwd | Эксперимент в одной папке |
project | .mcp.json в корне проекта | Командная работа: коммитим в git |
user | ~/.claude/.claude.json | Глобально для всех проектов |
Пример:
# Глобально
claude mcp add -s user atomno-cbr-rates -- uvx atomno-mcp-cbr-rates
# Только в текущем проекте, для коммита в git
claude mcp add -s project atomno-zakupki \
-e MCP_ZAKUPKI_TOKEN=atl_xxx \
-- uvx atomno-mcp-zakupki
Важно: Project-scope коммитится в git. Никогда не передавайте через
-eсекреты в этом scope’е — используйте placeholder’ы и подсказку команде «достать из vault’а».
Управление
# Список всех MCP (с указанием scope и статуса)
claude mcp list
# Подробно про один MCP
claude mcp get atomno-cbr-rates
# Удалить
claude mcp remove atomno-cbr-rates -s user
Прямое редактирование .claude.json
Иногда удобнее править файл руками (например, копи-паст 5 MCP сразу):
# user-scope
nano ~/.claude/.claude.json
Структура:
{
"mcpServers": {
"atomno-cbr-rates": {
"command": "uvx",
"args": ["atomno-mcp-cbr-rates"]
},
"atomno-fns-check": {
"command": "uvx",
"args": ["atomno-mcp-fns-check"],
"env": { "MCP_FNS_API_KEY": "YOUR_ATOMNO_API_KEY" }
}
}
}
После правки файла перезапустите Claude Code.
Запуск с MCP
cd /path/to/project
claude
# Внутри:
> Привет. У тебя подключены MCP atomno-cbr-rates и atomno-fns-check?
Claude должен ответить «да» и кратко перечислить тулы.
Headless-режим (для CI/CD)
Claude Code умеет работать без интерактивного TUI:
claude -p "Проверь ИНН 7707083893 через atomno-fns-check, выдай JSON"
В CI-пайплайнах работает так же: MCP стартуют по требованию, после ответа выходят.
Что дальше
- Cline / Continue → — для VS Code.
- Безопасность → — особенно важно для project-scope.
- Troubleshooting →.
Частые вопросы
Что означает разделитель -- в команде claude mcp add?
До разделителя задаются параметры добавления сервера, например имя, переменные окружения и область настройки. После него указывается команда запуска MCP, например uvx с именем пакета.
Можно ли сохранять ключи в проектной конфигурации Claude Code?
Конфигурация project-scope может попасть в Git и к другим участникам команды. Не записывайте в неё действующие секреты: сохраняйте шаблон настройки и отдельно указывайте, откуда пользователь должен получить свои переменные окружения.
Как посмотреть состояние подключённого MCP в Claude Code?
В инструкции используются команды claude mcp list и claude mcp get для списка и сведений о сервере. Проверяйте выбранную область настройки: пользовательская и проектная конфигурации могут различаться.
Нужен ли Claude Code для обычной API-интеграции?
Нет. Если запросы выполняет ваш бэкенд, используйте REST-интерфейс выбранного продукта. Claude Code нужен для сценария, в котором агент сам вызывает MCP-инструмент.
Нужно ли вручную создавать JSON перед добавлением через CLI?
В инструкции показано добавление командой claude mcp add. Используйте её параметры и выбранный уровень настройки; ручное копирование конфигурации другого клиента для этого не требуется.
Какой пакет передавать после команды uvx?
Имя конкретного пакета из инструкции выбранного MCP. Имя сервера в настройках и имя пакета — разные части команды; не заменяйте пакет названием источника наугад.
Можно ли подключить тот же размещённый ключ в другом своём приложении?
Да, действующий ключ своей подписки можно использовать в нескольких своих клиентах по их инструкциям. Квота размещённого доступа остаётся общей, а имя переменной зависит от пакета.
