Serwer MCP Nodary

Nodary udostępnia zdalny serwer MCP, dzięki któremu agent AI czyta i zapisuje Twoją przestrzeń roboczą tak jak członek zespołu: te same dokumenty, te same uprawnienia, zalogowany w Twoim imieniu.

W skrócie

Adres: https://nodary.ai/api/mcp
Transport: Streamable HTTP (JSON-RPC przez POST)
Logowanie: OAuth 2.1 z dynamiczną rejestracją klienta i PKCE albo klucz API
Dostęp: W cenie każdego planu; w planie Free w granicach jego limitów
Wykrywanie: https://nodary.ai/.well-known/oauth-protected-resource/api/mcp · https://nodary.ai/.well-known/mcp.json

Claude Code: Uruchom to polecenie w terminalu (dodaj --scope user, aby używać Nodary w każdym projekcie):

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

Czym jest

Model Context Protocol (MCP) to otwarty standard, z którego korzystają aplikacje AI, by pracować z zewnętrznymi narzędziami. Serwer Nodary daje agentowi tę samą przestrzeń roboczą, której używa Twój zespół: projekty, dokumenty i ich powiązania, arkusze kalkulacyjne, obrazy, tabele tłumaczeń, dialogi i tablice.

Agent nie dostaje kopii. Czyta to, co jest tam teraz, zapisuje tam, gdzie go o to poprosisz, a każdy wynik zawiera link, który człowiek może otworzyć, aby sprawdzić jego pracę.

Logowanie

Większość klientów loguje się przez OAuth: wystarczy podać adres serwera, a w przeglądarce otworzy się strona logowania i zgody Nodary. Nodary obsługuje OAuth 2.1 z dynamiczną rejestracją klienta i PKCE, więc nie trzeba tworzyć identyfikatora klienta ani niczego kopiować. Tokeny dostępu są ważne godzinę, a klient sam je odnawia.

Jedno połączenie może obejmować kilka przestrzeni roboczych. Jeśli należysz do więcej niż jednej, strona zgody wyświetla je wszystkie, zaznaczone: aplikacja ma wtedy dostęp do przestrzeni, które zostawisz zaznaczone, i tylko do nich. „Także przestrzenie, do których dołączę później” pozostaje wyłączone, dopóki tego nie zaznaczysz. W takim połączeniu każde narzędzie przyjmuje workspace (identyfikator, slug lub nazwę): wywołanie, które coś zmienia, musi ją wskazać, odczyt bez niej działa tylko tam, gdzie są jego identyfikatory, a każdy wynik zaczyna się od przestrzeni, w której został wykonany. Klucz API pozostaje przypisany do jednej przestrzeni.

Klient, który nie potrafi się zalogować, może zamiast tego użyć klucza API: utwórz go w swoim profilu, w sekcji API keys & MCP (zaczyna się od gdc_), i wysyłaj go w nagłówku Authorization: Bearer gdc_… Klucz można ograniczyć do jednego projektu.

Kto może z niego korzystać

Serwer MCP jest w cenie każdego planu, Free, Pro, Studio i Enterprise, dla każdego członka i bez dopłat.

W planie Free agent czyta i zapisuje jak w płatnym planie, dopóki przestrzeń robocza mieści się w limitach: projekty: 1, dokumenty i foldery: 10, członkowie: 2. Zapis, który przekroczyłby limit, zostaje odrzucony z informacją o tym limicie i o tym, jak go znieść: dopóki przestrzeń może jeszcze skorzystać z okresu próbnego, z linkiem do pulpitu, gdzie właściciel lub administrator rozpoczyna 14-dniowy okres próbny Studio (z MCP, bez karty); w przeciwnym razie z linkiem do cennika.

Przestrzeń robocza powyżej planu Free po okresie próbnym, bez subskrypcji, jest zablokowana do czasu wykupienia subskrypcji: agenci są w niej odcięci, także od czytania. Połączenie tylko z tą przestrzenią dostaje quota_locked przy każdym żądaniu, z tym, co przekracza limit, i miejscem, gdzie właściciel wykupuje subskrypcję; połączenie z kilkoma przestrzeniami dostaje quota_locked (lub billing_locked po nieudanej płatności) tylko przy wywołaniach w zablokowanej przestrzeni, jako błąd narzędzia, i dalej działa w pozostałych.

Cennik

Co może zrobić agent

Liczba narzędzi: 92. Pogrupowaliśmy je tu według zadań, które wykonują. Każde informuje klienta, czy tylko czyta i czy zapis może coś nadpisać, więc klient może zapytać Cię o zgodę, zanim zadziała.

Wyszukiwanie i czytanie

Projekty, dokumenty z powiązaniami i historią, komentarze, notatki wiedzy, zapisane widoki i briefy kontekstu. Wyniki zawierają linki, które ludzie mogą otworzyć.

list_games
list_stars
search_documents
get_document
get_star
get_tree
list_templates
list_members
list_project_knowledge
get_project_knowledge
list_comments
get_canon
list_versions
get_version
diff_versions
list_deleted_stars
list_context_briefs
get_context_brief
list_saved_views
get_saved_view
list_favorites
get_workspace_usage
list_properties
get_file_url
describe_blocks
run_view
list_workspaces

Pisanie i porządkowanie

Tworzenie i edycja dokumentów blok po bloku, umieszczanie ich w folderach, łączenie, tagowanie, komentowanie, ustawianie właściwości i rozstrzyganie sprzeczności. Usunięty dokument można przywrócić.

create_game
update_game
rename_workspace
create_starter_constellation
create_from_template
create_star
create_stars
write_document
append_document
edit_document
update_star
update_stars
delete_star
restore_star
create_cluster
move_to_cluster
link_stars
unlink_stars
set_tags
save_project_knowledge
add_comment
add_comments
resolve_comment
list_contradictions
report_contradiction
resolve_contradiction
save_context_brief
save_saved_view
set_favorite
define_properties
set_properties
restore_version
edit_comment
delete_comment
delete_project_knowledge
remove_context_brief
remove_saved_view
open_daily_note

Przegląd grafik i obrazy

Dodawanie obrazów, oglądanie ich razem z notatkami, które ludzie na nich narysowali, podejmowanie decyzji, opisywanie i tagowanie materiałów do odbioru (każda decyzja jest podpisana: kto i kiedy), zamiana moodboardu w paletę i sprawdzanie z nią obrazu oraz przygotowanie arkusza uwag dla podwykonawcy.

add_image
start_upload
add_media
get_image
get_moodboard
render_board
edit_board
find_pictures
update_pictures
get_art_review
extract_palette
check_palette
feedback_sheet
restore_image_version
set_image_origin

Arkusze i balansowanie

Odczyt arkusza jako obliczonych wartości wraz z formułą stojącą za każdą komórką, zapis komórek według adresu lub wiersza oraz odczyt tabeli łupów pod kątem tego, co oznacza dla graczy.

get_sheet
set_cells
analyze_drops

Lokalizacja i dialogi

Podgląd postępu każdego języka w tabeli tłumaczeń, zapis tłumaczeń według klucza i sprawdzanie rozgałęzionego dialogu, który eksportuje się jako skrypt Yarn Spinner.

get_localization
set_translations
check_dialogue

Produkcja

Ustawianie terminów, proszenie o recenzje i ich przesyłanie, podgląd ostatnich zmian i tego, czy kamień milowy zostanie osiągnięty.

get_progress
recent_changes
set_due_date
set_due_dates
request_review
submit_review

Prompty i zasoby

Gotowe polecenia, które klient może udostępnić jako komendy:

weekly-summary: Co zmieniło się w tym tygodniu w przestrzeni roboczej lub w jednym projekcie: co napisano, postanowiono, zrecenzowano i co wciąż jest otwarte.
art-review: Na jakim etapie jest przegląd grafik: obrazy czekające na decyzję, te, które odbiegają od palety, i to, o czym trzeba zdecydować w następnej kolejności.
playtest-to-tasks: Zamienia notatki z playtestów w zadania, z których każde jest powiązane z dokumentem projektowym, którego dotyczy.
balance-review: Czyta tabelę łupów lub krzywą progresji i mówi, co oznacza ona dla graczy i co budzi wątpliwości.

Zasoby, które klient może dołączyć bez wywoływania narzędzia:

nodary://star/{id}: dokument w formacie Markdown
nodary://project/{id}: struktura projektu

Bezpieczeństwo

Agent działa jako osoba, która go podłączyła: widzi i zmienia tylko to, do czego ta osoba ma dostęp, a klucz ograniczony do projektu nie wychodzi poza ten projekt.
W połączeniu z kilkoma przestrzeniami roboczymi nic nie jest rozwiązywane między nimi: identyfikatory i tytuły są wyszukiwane tylko w przestrzeni wskazanej przez wywołanie, identyfikator z innej przestrzeni jest odrzucany, zanim cokolwiek się wykona, a każdy wynik podaje swoją przestrzeń.
Dokumenty zachowują historię wersji, a usunięty dokument można przywrócić.
Narzędzia zapisu przyjmują klucz idempotencji: wywołanie powtórzone po zerwanym połączeniu zwraca pierwszy wynik, zamiast zapisywać dwa razy.
Połączenie wysyła najwyżej 120 żądań na minutę; zapisy nie mają dziennego limitu.
Decyzje z przeglądu grafik są podpisane nazwiskiem osoby, która je podjęła, wraz ze znacznikiem czasu.
Nodary informuje każdego agenta, że tekst dokumentów i komentarzy to treść do pracy, a nie polecenia do wykonania. To, jak agent z tego skorzysta, zależy od samego agenta.

Podłącz swojego klienta

Użyj adresu https://nodary.ai/api/mcp. Instrukcje dla każdego z poniższych klientów zweryfikowaliśmy z jego własną dokumentacją 1 października 2026 r.

Claude (claude.ai i Claude Desktop)

Otwórz Customize, a następnie Connectors i wybierz Add custom connector.
Wpisz https://nodary.ai/api/mcp. Gdy Claude zapyta o sposób rejestracji, wybierz Register automatically.
Połącz się, zaloguj do Nodary i zatwierdź dostęp.

Niestandardowe konektory są dostępne w planach Free, Pro, Max, Team i Enterprise; konto Free może dodać jeden. W planach Team i Enterprise właściciel musi najpierw dodać konektor dla organizacji.

ChatGPT

W Settings, w sekcji Security and login, włącz Developer mode.
Utwórz aplikację dla zdalnego serwera MCP z adresem https://nodary.ai/api/mcp i logowaniem OAuth.
Zaloguj się do Nodary i zatwierdź dostęp. Narzędzia pojawią się wtedy w polu wiadomości, w trybie Developer mode.

Developer mode jest dostępny w wersji webowej dla kont Plus, Pro, Business, Enterprise i Education; w planach Business i Enterprise może być potrzebna zgoda administratora. ChatGPT łączy się wyłącznie przez OAuth, nie kluczem API.

Claude Code

Uruchom to polecenie w terminalu (dodaj --scope user, aby używać Nodary w każdym projekcie):
```
claude mcp add --transport http nodary https://nodary.ai/api/mcp
```
W Claude Code wpisz /mcp, wybierz nodary i zaloguj się w przeglądarce.

Albo z kluczem API

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

Cursor

Dodaj Nodary do ~/.cursor/mcp.json (wszystkie projekty) lub .cursor/mcp.json (jeden projekt):
```
{
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp"
    }
  }
}
```
Cursor zaproponuje logowanie, gdy serwer po raz pierwszy o nie poprosi.

Albo z kluczem API

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

VS Code (GitHub Copilot)

Dodaj Nodary do .vscode/mcp.json w swoim obszarze roboczym albo uruchom polecenie MCP: Add Server:

{
  "servers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp"
    }
  }
}

Uruchom serwer; VS Code otworzy logowanie do Nodary.

W Copilot Business i Enterprise administrator musi najpierw zezwolić na serwery MCP.

Albo z kluczem API

{
  "inputs": [
    {
      "type": "promptString",
      "id": "nodary-key",
      "description": "Nodary API key",
      "password": true
    }
  ],
  "servers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:nodary-key}"
      }
    }
  }
}

Devin Desktop (dawniej Windsurf)

Dodaj serwer i zaloguj się z terminala:

devin mcp add -s user nodary https://nodary.ai/api/mcp
devin mcp login nodary

Albo dodaj go do ~/.config/devin/mcp_config.json (w systemie Windows: %APPDATA%\devin\mcp_config.json):

{
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp",
      "transport": "http"
    }
  }
}

Jeśli coś nie działa

Jeśli pierwsze żądanie dostaje odpowiedź 401 z adresem resource_metadata, to normalne: ten adres wskazuje klientowi, gdzie się zalogować.
Żądanie odrzucone z quota_locked oznacza, że przestrzeń robocza po okresie próbnym przekracza plan Free i jest zablokowana do czasu wykupienia subskrypcji: gdy tylko właściciel ją wykupi, agent znów działa. W połączeniu z kilkoma przestrzeniami odrzucane są tylko wywołania w tej przestrzeni.
Wywołanie odrzucone z workspace_required (lub workspace_not_found) wymienia przestrzenie, do których połączenie ma dostęp: przekaż jedną z nich jako workspace. Aby sięgnąć do przestrzeni spoza listy, połącz aplikację ponownie i zaznacz ją.
Jeśli klient nie może dokończyć logowania, podłącz go za pomocą klucza API.