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

Перед началом

• Claude Code со входом в аккаунт Pro, Max, Team, Enterprise или Console либо через облачного провайдера, например Amazon Bedrock. Бесплатный тариф claude.ai не включает Claude Code.
• Аккаунт Nodary. MCP-сервер входит во все тарифы; на Free, пока рабочее пространство укладывается в лимиты тарифа: 1 проект, 10 документов и папок, 2 участника. Claude Code не тратит Кометы: он работает на своей модели.

Добавьте Nodary

1. Выполните эту команду в терминале:

   claude mcp add --transport http nodary https://nodary.ai/api/mcp

   Копировать
2. Чтобы использовать Nodary во всех проектах, добавьте его в пользовательскую область:

   claude mcp add --transport http --scope user nodary https://nodary.ai/api/mcp

   Копировать
3. В Claude Code введите /mcp, выберите nodary и войдите: страница согласия Nodary откроется в браузере. Если она не открылась, скопируйте адрес, который показывает Claude Code, или выполните:

   claude mcp login nodary

   Копировать

Области: local, по умолчанию, оставляет Nodary только вам в этом проекте; user оставляет его вам во всех проектах; project записывает .mcp.json в корень проекта, чтобы им пользовалась вся команда.

Вход и выбор пространств

Страница согласия Nodary показывает, какое приложение просит доступ и по какому адресу оно будет возвращено. Войдите, если нужно, и выберите рабочие пространства, к которым Claude Code получит доступ: если пространство одно, выберите его; если их несколько, ни одно не отмечено заранее, поэтому отметьте каждое, которым Claude Code может пользоваться. Если вы вошли больше 10 минут назад, Nodary снова попросит пароль. Подтвердите, и браузер вернёт вас в Claude Code.

После этого Claude Code действует от вашего имени: видит и меняет только то, что позволяет ваша роль, в отмеченных пространствах. Доступ действует 60 минут за раз, и Claude Code продлевает его сам.

Используйте Nodary в терминале

Просите своими словами. Claude Code вызывает инструменты Nodary, когда это нужно для запроса, и спрашивает перед их использованием, если вы их не разрешили. Несколько запросов для начала:

• Прочитай документ с дизайном API в Nodary и проверь по нему этот эндпоинт.
• Напиши запись о решении перейти на Postgres, помести её в папку «Архитектура» и свяжи со спецификацией.
• Какие документы в проекте Backend всё ещё черновики и кто за них отвечает?

С ключом API

Передайте ключ в заголовке:

claude mcp add --transport http nodary https://nodary.ai/api/mcp \
  --header "Authorization: Bearer gdc_..."

Чтобы поделиться сервером в .mcp.json, не раскрывая ключ, читайте ключ из переменной окружения: Claude Code подставляет ${NODARY_API_KEY} в заголовки сервера.

{
  "mcpServers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${NODARY_API_KEY}"
      }
    }
  }
}

Создайте ключ в Nodary в разделе «Профиль», «Ключи API и MCP». Он начинается с gdc_, показывается один раз, действует с вашими правами, может быть ограничен одним проектом и истекает через 30, 90 или 365 дней либо никогда, как вы выберете.

Если что-то не работает

• claude mcp add не проверяет ключ: неверный ключ проявится в /mcp как сервер с ошибкой.
• Чтобы войти заново, выберите Clear authentication в меню /mcp или выполните claude mcp logout nodary, а затем войдите.
• Длинный документ приходит обрезанным: Claude Code предупреждает, когда вывод инструмента превышает 10 000 токенов, и по умолчанию останавливается на 25 000. Увеличьте лимит переменной окружения MAX_MCP_OUTPUT_TOKENS или попросите один раздел.
• Вход не завершается: подключитесь с ключом API, как описано выше.
• Ответ 401 на первый запрос нормален: так клиент узнаёт, где войти.
• quota_locked: после пробного периода пространство превышает тариф Free и заблокировано, пока владелец не оформит подписку. После этого всё сразу снова работает.
• billing_locked: платёж не прошёл, поэтому пространство заблокировано, пока владелец не оплатит его в разделе оплаты пространства. Всё снова работает, как только платёж пройдёт.
• workspace_suspended: Nodary приостановил пространство, и к нему ничего не может обратиться, включая агентов. Владелец может написать на support@nodary.ai.
• workspace_required: подключение охватывает несколько пространств, поэтому укажите, в каком работать, или подключитесь заново и отметьте только одно.

Вопросы

Читать дальше