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

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

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

Добавьте 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, файл в домашней папке, который никогда не попадает в репозиторий:

{
  "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 дней либо никогда, как вы выберете.

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

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

Вопросы

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