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: Dodatek MCP w płatnym planie: 30 € za członka lub 200 € za całą przestrzeń roboczą, miesięcznie
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.

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 to dodatek do płatnego planu (Pro, Studio lub Enterprise): 30 € za członka miesięcznie albo 200 € miesięcznie za całą przestrzeń roboczą.

Właściciel przestrzeni roboczej włącza go w panelu Administracja. Jeśli właściciel nie ma jeszcze dostępu, przyznanie go członkowi daje stanowisko także właścicielowi. Członek bez dostępu może o niego poprosić w swoim profilu, a właściciel dostaje powiadomienie.

Cennik

Co może zrobić agent

Liczba narzędzi: 82. 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

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
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

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.
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ć.
Jeśli wywołanie narzędzia informuje, że wymagany jest dodatek MCP, właściciel jeszcze go dla Ciebie nie włączył.
Jeśli klient nie może dokończyć logowania, podłącz go za pomocą klucza API.