Atomno labs

Установка 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

В 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_CHECK_TOKEN=atl_xxxxx \
  -- 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_CHECK_TOKEN": "atl_xxxxx" }
    }
  }
}

После правки файла перезапустите 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 стартуют по требованию, после ответа выходят.

Что дальше