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

Claude Code читает из терминала документацию, которую ваша команда хранит в Nodary, и записывает туда решения и заметки, с вашими правами.

Сверено с документацией каждого поставщика 22 октября 2026 г..

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

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

Ещё нет пространства? Создайте его и вернитесь, чтобы подключиться. [Создать бесплатное пространство](https://nodary.ai/sign-up)

## Добавьте 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

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

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

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

```json
{
  "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: подключение охватывает несколько пространств, поэтому укажите, в каком работать, или подключитесь заново и отметьте только одно.

## Вопросы

### Подключение Claude Code стоит денег?

Не со стороны Nodary. MCP-сервер входит во все тарифы, включая Free в его лимитах, а Claude Code не тратит Кометы: Кометами считается только Studio AI. Можно ли добавить сервер, решает ваш тариф Claude Code.

### Это то же подключение, что у Claude в браузере?

Может быть: если вы входите в Claude Code с аккаунтом claude.ai, коннекторы, добавленные в claude.ai, включая Nodary, появляются в Claude Code. Со входом по ключу Console или через облачного провайдера добавьте Nodary командой выше.

### Может ли команда делиться настройкой?

Да: добавьте Nodary с --scope project и поместите .mcp.json в репозиторий. Claude Code спрашивает каждого, прежде чем использовать серверы проекта, и каждый входит своим аккаунтом Nodary.

### Может ли Claude Code удалить или перезаписать мои документы?

Только там, где это позволяет ваша роль, и любое изменение можно вернуть назад: каждый сеанс правки длиной до десяти минут образует одну версию, как и каждая запись агента. Документ хранит 50 последних версий, сделанных людьми, и 50 последних, сделанных агентами (версии агентов никогда не вытесняют версии людей); их можно сравнить и восстановить, а удалённый документ можно вернуть в течение 30 дней. Ссылки для общего доступа, доступы, участники, роли, ключи, оплата и удаление проекта остаются решениями людей: ни один агент не может их принять.

### Как его отключить?

В Nodary откройте «Профиль», «Безопасность», «Подключённые приложения» и отключите его: доступ прекратится сразу. В Claude Code команда claude mcp remove nodary удаляет сервер и сохранённый вход. Ключ отзывается в разделе «Профиль», «Ключи API и MCP», а владельцы и администраторы могут отозвать любой ключ пространства в его настройках, в разделе MCP.

### Использует ли Nodary мои документы для обучения ИИ?

Нет. Nodary не использует содержимое рабочих пространств для обучения моделей ИИ. Что Claude Code делает с прочитанным, определяют условия его разработчика.

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

- [Подключить Claude к Nodary](https://nodary.ai/ru/docs/mcp/claude): Добавьте Nodary в claude.ai и Claude Desktop как пользовательский коннектор со входом через OAuth.
- [Подключить Cursor к Nodary](https://nodary.ai/ru/docs/mcp/cursor): Добавьте Nodary в mcp.json Cursor и войдите из Cursor.
- [MCP-сервер Nodary](https://nodary.ai/ru/docs/mcp): Сервер, вход, 98 инструмента, безопасность и все клиенты на одной странице.
- [MCP server](https://nodary.ai/glossary/mcp-server) (на английском): An MCP server is a program that offers tools, resources and prompts to AI applications over the Model Context Protocol.
- [Context window](https://nodary.ai/glossary/context-window) (на английском): A context window is how much text, counted in tokens, a language model takes into account at once, instructions and documents included.

https://nodary.ai/ru/docs/mcp/claude-code