Подключить к Claude Code

CLI-агент. Одна команда для регистрации сервера, затем авторизация из интерактивного REPL.

Предварительно: CLI claude (Claude Code) и Google-аккаунт для входа. OAuth callback кратковременно занимает локальный порт 3118 — не блокируйте его.

1. Добавьте сервер

claude mcp add -s user --transport http planner https://planner.monopoly-gold.com/_mcp

ожидаемый вывод

Added HTTP MCP server planner with URL: https://planner.monopoly-gold.com/_mcp to user config
File modified: ~/.claude.json

-s user делает planner доступным во всех проектах. Уберите, чтобы ограничить текущей директорией.

2. Авторизуйтесь

Запустите claude (интерактивный REPL), введите команду /mcp, затем выберите planner → Authenticate. /mcp — команда REPL, не shell-команда — вне claude она не работает. Откроется вкладка браузера с OAuth-флоу.

Войдите через Google. Вкладка перенаправит на localhost:3118/callback, и CLI автоматически получит токен.

3. Проверьте

claude mcp list

ожидаемый вывод

planner: https://planner.monopoly-gold.com/_mcp (HTTP) - ✔ Connected

До авторизации строка показывает ! Needs authentication — это сигнал запустить /mcp.

Проверьте из чата — попросите Claude показать ваши проекты:

в чате

> покажи мои проекты в planner
  → planner:list-projects  возвращает ваши проекты (пустой массив на свежем аккаунте)

Устранение неполадок

Симптом	Причина / решение
! Needs authentication	Токен отсутствует или истёк. Запустите `/mcp` → Authenticate.
Ошибка страницы redirect	Если вкладка `localhost:3118` не подключается, скопируйте полный URL из адресной строки обратно в клиент.
Зависло после смены токена	Переподключите: `claude mcp remove planner -s user`, затем команда добавления заново.