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

Агент GitHub Copilot в VS Code может читать спецификации и решения вашей команды в Nodary и записывать в них, с вашими правами.

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

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

- VS Code с GitHub Copilot. На Copilot Free, Pro, Pro+ и Max никакая политика организации не регулирует MCP-серверы.
- На Copilot Business и Enterprise политика организации MCP servers in Copilot должна быть включена; по умолчанию она выключена. Список разрешённых серверов компании также может ограничить, что вы добавляете.
- Аккаунт Nodary. MCP-сервер входит во все тарифы; на Free, пока рабочее пространство укладывается в лимиты тарифа: 1 проект, 10 документов и папок, 2 участника. Copilot не тратит Кометы: он работает на своей модели.

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

## Добавьте Nodary

1. Откройте палитру команд (Ctrl+Shift+P или Cmd+Shift+P на Mac) и выполните MCP: Add Server.
2. Выберите HTTP (HTTP or Server-Sent Events) и введите адрес сервера:

   ```
   https://nodary.ai/api/mcp
   ```
3. Введите nodary как идентификатор сервера.
4. Выберите Global, затем Copilot Global, чтобы использовать Nodary во всех рабочих областях. VS Code запишет его в ~/.copilot/mcp-config.json:

   ```
   {
     "mcpServers": {
       "nodary": {
         "type": "http",
         "url": "https://nodary.ai/api/mcp",
         "tools": [
           "*"
         ]
       }
     }
   }
   ```
5. Когда сервер запустится, примите запросы доверия и входа: страница согласия Nodary откроется в браузере.

**Старые конфигурации:** VS Code по-прежнему читает .vscode/mcp.json и mcp.json пользовательского профиля, где используется servers вместо mcpServers, и помечает их как устаревшие.

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

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

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

## Используйте Nodary в Copilot Chat

В Copilot Chat проверьте, что инструменты Nodary включены (Configure Tools или Chat: Open Customizations, затем Tools), и просите своими словами. Несколько запросов для начала:

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

## С ключом API

Добавьте заголовок в ~/.copilot/mcp-config.json, файл в домашней папке, который никогда не попадает в репозиторий:

```json
{
  "mcpServers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer gdc_..."
      },
      "tools": [
        "*"
      ]
    }
  }
}
```

**Открытым текстом:** VS Code не читает из этого файла переменные, которые запрашивает у пользователя, поэтому ключ хранится в нём как есть. Задайте ключу срок действия 30 или 90 дней и отзовите его в Nodary, если компьютер потерян.

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

![Раздел «Ключи API и MCP» в профиле Nodary: адрес MCP-сервера для вставки в ИИ-клиент и ключ агента с его областью действия.](https://nodary.ai/marketing/mcp-connect.webp)

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

- VS Code сообщает, что сервер заблокирован ограничением компании: спросите администратора о политике MCP servers in Copilot и списке разрешённых серверов.
- Запрос входа не появляется: выполните MCP: List Servers, перезапустите nodary и примите запросы. Если вход всё равно не завершается, используйте ключ API.
- Ответ 401 на первый запрос нормален: так клиент узнаёт, где войти.
- quota_locked: после пробного периода пространство превышает тариф Free и заблокировано, пока владелец не оформит подписку. После этого всё сразу снова работает.
- billing_locked: платёж не прошёл, поэтому пространство заблокировано, пока владелец не оплатит его в разделе оплаты пространства. Всё снова работает, как только платёж пройдёт.
- workspace_suspended: Nodary приостановил пространство, и к нему ничего не может обратиться, включая агентов. Владелец может написать на support@nodary.ai.
- workspace_required: подключение охватывает несколько пространств, поэтому укажите, в каком работать, или подключитесь заново и отметьте только одно.

## Вопросы

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

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

### Copilot Business сообщает, что MCP-серверы отключены. Что делать?

Администратор организации или компании включает политику MCP servers in Copilot, по умолчанию выключенную. Copilot Free, Pro, Pro+ и Max от неё не зависят.

### Нужно ли устанавливать Node.js или что-то ещё?

Нет. Nodary работает как удалённый сервер: VS Code обращается к нему по HTTPS, и на вашем компьютере ничего не запускается.

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

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

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

В Nodary откройте «Профиль», «Безопасность», «Подключённые приложения» и отключите его: доступ прекратится сразу. В VS Code удалите nodary из ~/.copilot/mcp-config.json или остановите его через MCP: List Servers. Ключ отзывается в разделе «Профиль», «Ключи API и MCP», а владельцы и администраторы могут отозвать любой ключ пространства в его настройках, в разделе MCP.

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

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

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

- [Подключить Cursor к Nodary](https://nodary.ai/ru/docs/mcp/cursor): Добавьте Nodary в mcp.json Cursor и войдите из Cursor.
- [Подключить Claude Code к Nodary](https://nodary.ai/ru/docs/mcp/claude-code): Одна команда добавляет Nodary в Claude Code, а /mcp выполняет вход.
- [MCP-сервер Nodary](https://nodary.ai/ru/docs/mcp): Сервер, вход, 98 инструмента, безопасность и все клиенты на одной странице.
- [MCP (Model Context Protocol)](https://nodary.ai/glossary/model-context-protocol) (на английском): The Model Context Protocol (MCP) is an open standard that connects AI applications to outside tools and data through one common interface.
- [OAuth](https://nodary.ai/glossary/oauth) (на английском): OAuth is a standard that lets an app act for you in another service, with access you approve, without ever seeing your password.

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