Połącz Claude Code z Nodary

Zanim zaczniesz

• Claude Code zalogowany kontem Pro, Max, Team, Enterprise lub Console albo używany przez dostawcę chmury, takiego jak Amazon Bedrock. Darmowy plan claude.ai nie obejmuje Claude Code.
• 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. Claude Code nie zużywa komet: korzysta z własnego modelu.

Dodaj Nodary

1. Uruchom to polecenie w terminalu:

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

   Kopiuj
2. Aby używać Nodary w każdym projekcie, dodaj go do zakresu użytkownika:

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

   Kopiuj
3. W Claude Code wpisz /mcp, wybierz nodary i zaloguj się: strona zgody Nodary otworzy się w przeglądarce. Jeśli się nie otworzy, skopiuj adres pokazany przez Claude Code albo uruchom:

   claude mcp login nodary

   Kopiuj

Zakresy: local, domyślny, zostawia Nodary tylko dla ciebie w tym projekcie; user, dla ciebie we wszystkich projektach; project zapisuje .mcp.json w katalogu głównym projektu, żeby cały zespół go współdzielił.

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 Claude Code 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 Claude Code 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 Claude Code.

Claude Code 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 Claude Code odnawia go sam.

Używaj Nodary w terminalu

Pytaj własnymi słowami. Claude Code wywołuje narzędzia Nodary, gdy prośba ich wymaga, i pyta przed ich użyciem, chyba że na nie zezwolisz. 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

Wyślij klucz w nagłówku:

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

Aby udostępnić serwer w .mcp.json bez udostępniania klucza, odczytuj klucz ze zmiennej środowiskowej: Claude Code podstawia ${NODARY_API_KEY} w nagłówkach serwera.

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

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

• claude mcp add nie sprawdza klucza: błędny klucz pojawi się w /mcp jako serwer, który nie działa.
• Aby zalogować się ponownie, wybierz Clear authentication w menu /mcp albo uruchom claude mcp logout nodary, a potem się zaloguj.
• Długi dokument wraca ucięty: Claude Code ostrzega powyżej 10 000 tokenów wyniku narzędzia i domyślnie zatrzymuje się na 25 000. Podnieś limit zmienną środowiskową MAX_MCP_OUTPUT_TOKENS albo poproś o jedną sekcję.
• Logowanie się nie kończy: połącz się kluczem API, jak opisano wyżej.
• 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