Połącz VS Code z Nodary

Zanim zaczniesz

• VS Code z GitHub Copilot. W Copilot Free, Pro, Pro+ i Max żadna zasada organizacji nie reguluje serwerów MCP.
• W Copilot Business i Enterprise zasada organizacji MCP servers in Copilot musi być włączona; domyślnie jest wyłączona. Lista dozwolonych serwerów firmy może też ograniczać, co możesz dodać.
• Konto Nodary. Serwer MCP jest w każdym planie; w planie Free, dopóki przestrzeń mieści się w jego limitach: 1 projekt, 10 dokumentów i folderów, 2 członków. Copilot nie zużywa komet: korzysta z własnego modelu.

Dodaj Nodary

1. Otwórz paletę poleceń (Ctrl+Shift+P albo Cmd+Shift+P na Macu) i uruchom MCP: Add Server.
2. Wybierz HTTP (HTTP or Server-Sent Events) i wpisz adres serwera:

   https://nodary.ai/api/mcp

   Kopiuj
3. Wpisz nodary jako identyfikator serwera.
4. Wybierz Global, potem Copilot Global, aby używać Nodary we wszystkich przestrzeniach roboczych. VS Code zapisze go w ~/.copilot/mcp-config.json:

   {
     "mcpServers": {
       "nodary": {
         "type": "http",
         "url": "https://nodary.ai/api/mcp",
         "tools": [
           "*"
         ]
       }
     }
   }

   Kopiuj
5. Gdy serwer się uruchomi, zaakceptuj prośby o zaufanie i zalogowanie: strona zgody Nodary otworzy się w przeglądarce.

Starsze konfiguracje: VS Code wciąż odczytuje .vscode/mcp.json i mcp.json z profilu użytkownika, które używają servers zamiast mcpServers, i oznacza je jako przestarzałe.

Zaloguj się i wybierz przestrzenie

Strona zgody Nodary podaje aplikację, która prosi o dostęp, i adres, na który zostanie odesłana. Zaloguj się, jeśli trzeba, i wybierz przestrzenie robocze, do których Copilot będzie mieć dostęp: gdy masz jedną, wybierasz ją; gdy masz kilka, żadna nie jest zaznaczona z góry, więc zaznacz każdą, z której Copilot może korzystać. Jeśli od logowania minęło ponad 10 minut, Nodary ponownie poprosi o hasło. Zatwierdź, a przeglądarka wróci do Copilot.

Copilot działa wtedy w twoim imieniu: widzi i zmienia tylko to, na co pozwala twoja rola, w zaznaczonych przestrzeniach. Jego dostęp trwa za każdym razem 60 minut i Copilot odnawia go sam.

Używaj Nodary w Copilot Chat

W Copilot Chat sprawdź, czy narzędzia Nodary są włączone (Configure Tools albo Chat: Open Customizations, potem Tools), a następnie pytaj własnymi słowami. Kilka próśb na początek:

• Przeczytaj w Nodary dokument projektu API i sprawdź ten endpoint pod jego kątem.
• Napisz zapis decyzji o przejściu na Postgres, umieść go w folderze Architektura i połącz ze specyfikacją.
• Które dokumenty w projekcie Backend to wciąż szkice i kto za nie odpowiada?

Zamiast tego z kluczem API

Dodaj nagłówek do ~/.copilot/mcp-config.json, pliku w folderze domowym, którego nigdy nie zapisujesz w repozytorium:

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

Jawnym tekstem: VS Code nie odczytuje z tego pliku zmiennych, o które pyta użytkownika, więc klucz jest w nim zapisany wprost. Ustaw mu ważność 30 lub 90 dni i unieważnij go w Nodary, jeśli zgubisz komputer.

Utwórz klucz w Nodary, w sekcji Profil, Klucze API i MCP. Zaczyna się od gdc_, jest pokazywany tylko raz, działa z twoimi uprawnieniami, można go ograniczyć do jednego projektu i wygasa po 30, 90 lub 365 dniach albo nigdy, jak wybierzesz.

Jeśli coś nie działa

• VS Code informuje, że ograniczenie firmy blokuje serwer: zapytaj administratora o zasadę MCP servers in Copilot i listę dozwolonych serwerów firmy.
• Nie pojawia się logowanie: uruchom MCP: List Servers, zrestartuj nodary i zaakceptuj prośby. Jeśli logowanie nadal się nie kończy, użyj klucza API.
• Pierwsze żądanie z odpowiedzią 401 jest normalne: mówi klientowi, gdzie się zalogować.
• quota_locked: przestrzeń przekracza plan Free po okresie próbnym i jest zablokowana, dopóki właściciel nie wykupi subskrypcji. Potem od razu znów działa.
• billing_locked: płatność się nie powiodła, więc przestrzeń jest zablokowana, dopóki właściciel jej nie ureguluje w rozliczeniach przestrzeni. Działa znów, gdy tylko płatność przejdzie.
• workspace_suspended: Nodary zawiesiło przestrzeń i nic do niej nie dociera, także agenci. Właściciel może napisać na support@nodary.ai.
• workspace_required: połączenie obejmuje kilka przestrzeni, więc wskaż tę, w której agent ma pracować, albo połącz się ponownie i zaznacz tylko jedną.

Pytania

Czytaj dalej