DocsMCP

Serwer MCP: zarządzaj przestrzenią Nodale z Claude Code

Połącz Claude Code z serwerem MCP Nodale, potem odczytuj i zmieniaj przestrzeń roboczą: wiedzę, materiały demo, ustawienia agenta, witryny, wdrożenie.

Nodale ma serwer MCP. Połączony z nim asystent AI odczytuje i zmienia twoją przestrzeń roboczą według tych samych zasad co aplikacja: zapisuje wiedzę, przesyła materiały demo, edytuje ustawienia agenta, deklaruje twoje witryny i uruchamia agenta online. Instalacja tagu na twojej witrynie pozostaje osobnym krokiem, opisanym w szybkim starcie.

Połącz Claude Code

Serwer komunikuje się przez Streamable HTTP pod adresem https://nodale.app/api/mcp i loguje cię kontem Nodale przez OAuth. Ta strona dotyczy Claude Code. Uruchom to polecenie w terminalu:

claude mcp add-json --scope user nodale '{
  "type": "http",
  "url": "https://nodale.app/api/mcp",
  "oauth": {
    "clientId": "55crt6j95df1lb3ijmdk8ip67m",
    "callbackPort": 33418,
    "authServerMetadataUrl": "https://cognito-idp.eu-west-3.amazonaws.com/eu-west-3_HEni9KG4X/.well-known/openid-configuration",
    "scopes": "openid email profile"
  }
}'

Następnie:

  1. Otwórz Claude Code, wpisz /mcp i wybierz serwer nodale.
  2. Zaloguj się kontem Nodale. Strona logowania jest hostowana dla Nodale pod adresem amazoncognito.com.
  3. Zapytaj asystenta, na jakie konto jest zalogowany. Wywołuje on narzędzie me.

To samo polecenie jest w aplikacji, w sekcji Settings, a następnie MCP.

  • Zostaw callbackPort na 33418. Po zalogowaniu przeglądarka wraca na http://localhost:33418/callback, jedyny adres, który serwer akceptuje.
  • Nie dodawaj nagłówka Authorization: wyłączyłby OAuth.
  • Aby udostępnić serwer zespołowi, umieść ten sam JSON w pliku .mcp.json swojego repozytorium (--scope project). Nie zawiera on żadnego sekretu.

Kto co może

Asystent działa jako ty, z uprawnieniami twojego konta, tylko w twojej przestrzeni roboczej.

Rola Co asystent może zrobić
Viewer Odczyt. Każde narzędzie, które coś zmienia, jest odrzucane.
User Odczyt oraz zmiana wiedzy, konkurentów, dokumentów i materiałów demo.
Admin Wszystko, co może User, plus ustawienia agenta, jego witryny i jego wdrożenie.

Każde narzędzie przyjmuje opcjonalne workspaceId: pomiń je. Twój klient może wymieniać więcej narzędzi, niż opisuje ta strona. Są one zarezerwowane dla zespołu Nodale, a serwer je odrzuca.

Jak zmiana trafia na produkcję

Większość zmian trafia najpierw do wersji roboczej, a odwiedzający nic nie widzą, dopóki nie opublikujesz.

  • Ustawienia agenta. update_inbound_agent_configuration edytuje wersję roboczą: zmieniają się tylko pola, które przekazujesz, a lista, którą przekazujesz, zajmuje miejsce całej listy. publish_inbound_agent_configuration udostępnia wersję roboczą odwiedzającym. discard_inbound_agent_configuration_draft wraca do opublikowanych ustawień.
  • Wersje. Narzędzia, które edytują ustawienia, przyjmują expectedVersion, czyli wersję, którą ostatnio odczytałeś. Jeśli ktoś w międzyczasie zmienił ustawienia, wywołanie jest odrzucane wraz z aktualną wersją.
  • Wiedza. Wiedza jest przechowywana jako cytaty o długości jednego zdania. Cytat, który dodajesz, jest wersją roboczą aż do publish_knowledge, które przyjmuje draftHash zwrócony przez list_knowledge_quotes. Nieaktualny hash jest odrzucany. Wycofanie cytatu albo oznaczenie go jako wewnętrznego działa od razu.
  • Wiedza z tekstu. submit_knowledge_text czyta w tle tekst o długości do 100 000 znaków i zwraca dispatchId. Odpytuj get_knowledge_dispatch, a potem zastosuj lub odrzuć propozycje. To, co zastosujesz, trafia do wersji roboczej i nadal wymaga publish_knowledge.
  • Materiały demo. Zmiana w materiale pozostaje w roboczym katalogu aż do publish_asset_catalog.
  • Przesyłanie plików ma dwa kroki. request_document_upload lub request_asset_upload zwraca polecenie curl do uruchomienia, ważne przez 15 minut. Następnie add_document lub add_asset rejestruje plik.
  • Ustawienia witryny (wyświetlanie, śledzenie wizyt, zgoda, link do polityki prywatności) działają od następnego załadowania strony, bez publikacji.
  • Kredyty AI. submit_knowledge_text, analyze_asset oraz add_asset bez steps zużywają kredyty AI. add_asset ze steps zachowuje twoją narrację w przesłanej postaci i nie zużywa żadnych.

Od zera do agenta online

  1. me: sprawdź konto i przestrzeń roboczą.
  2. Wiedza: add_knowledge_quote albo submit_knowledge_text, potem get_knowledge_dispatch i apply_knowledge_proposals. Następnie list_knowledge_quotes i publish_knowledge.
  3. Opcjonalnie: konkurenci, dokumenty i materiały demo, potem publish_asset_catalog.
  4. Ustawienia: update_inbound_agent_configuration, save_inbound_agent_outcome, potem publish_inbound_agent_configuration.
  5. add_inbound_agent_site: zadeklaruj witrynę.
  6. deploy_inbound_agent: uruchom agenta online.
  7. Wklej tag na witrynie, potem get_inbound_agent_tag_status, aby go sprawdzić.

Narzędzia

Konto

Narzędzie Co robi Kto
me Konto i przestrzeń robocza, na których działa asystent. Wszyscy
get_workspace_ai_credits Ile kredytów AI przestrzeni roboczej zostało zużytych i czy się wyczerpały. Wszyscy

Wiedza

Narzędzie Co robi Kto
list_knowledge_quotes Cytaty, łącznie z wersjami roboczymi, oraz draftHash do publikacji. Wszyscy
add_knowledge_quote Dodaje jedno zdanie jako cytat roboczy. User
retract_knowledge_quote Wycofuje cytat, od razu. User
set_knowledge_quote_visibility Ustawia cytat jako publiczny lub wewnętrzny, od razu. User
publish_knowledge Publikuje cytaty robocze. User
submit_knowledge_text Czyta tekst i proponuje na jego podstawie cytaty. Zużywa kredyty AI. User
get_knowledge_dispatch Stan przesłanego tekstu. Wszyscy
list_knowledge_proposals Propozycje czekające na decyzję. Wszyscy
apply_knowledge_proposals Stosuje wszystkie propozycje z jednego tekstu. User
apply_knowledge_proposal Stosuje jedną propozycję. User
reject_knowledge_proposal Odrzuca jedną propozycję. User

Konkurenci i dokumenty

Narzędzie Co robi Kto
list_competitors Konkurenci, których zna agent. Wszyscy
upsert_competitor Dodaje konkurenta albo go edytuje. User
delete_competitor Usuwa konkurenta. User
list_documents Dokumenty przestrzeni roboczej. Wszyscy
request_document_upload Pierwszy krok przesyłania: zwraca polecenie do wysłania pliku. User
add_document Drugi krok: rejestruje przesłany plik. User
delete_document Usuwa dokument. User

Materiały demo

Narzędzie Co robi Kto
list_assets Filmy demo z katalogu. Wszyscy
get_asset Jeden materiał, z jego krokami i stanem ich pisania. Wszyscy
request_asset_upload Pierwszy krok przesyłania: zwraca polecenie do wysłania filmu. User
add_asset Drugi krok: rejestruje film, z twoimi krokami albo z krokami, które pisze Nodale. User
update_asset Edytuje tytuł materiału, jego opis i prośby, na które odpowiada. User
set_asset_steps Ustawia kroki materiału w postaci, w jakiej je napisałeś. User
analyze_asset Zleca Nodale ponowne napisanie kroków. Zużywa kredyty AI. User
enable_asset, disable_asset Włącza lub wyłącza materiał. User
set_asset_priority Ustala kolejność materiałów. User
delete_asset Usuwa materiał. User
publish_asset_catalog Publikuje roboczy katalog. User

Ustawienia agenta

Narzędzie Co robi Kto
get_inbound_agent_configuration Ustawienia: wersja robocza, gdy istnieje, ustawienia opublikowane oraz wersja. Wszyscy
update_inbound_agent_configuration Edytuje wersję roboczą: nazwa, ton, wygląd, zbieranie adresu e-mail, języki, instrukcje, kwalifikacja, bariery ochronne. Admin
publish_inbound_agent_configuration Udostępnia wersję roboczą odwiedzającym. Admin
discard_inbound_agent_configuration_draft Odrzuca wersję roboczą. Admin
list_inbound_agent_qualification_elements Pytania, które przestrzeń robocza dodała do kwalifikacji. Wszyscy
save_inbound_agent_qualification_element Dodaje pytanie kwalifikacyjne albo je edytuje. Admin
remove_inbound_agent_qualification_element Usuwa pytanie kwalifikacyjne. Admin
list_inbound_agent_outcomes Cele, do których agent kieruje odwiedzających. Wszyscy
save_inbound_agent_outcome Dodaje cel albo go edytuje. Najwyżej dziesięć na przestrzeń roboczą. Admin
remove_inbound_agent_outcome Usuwa cel. Admin

Witryny i wdrożenie

Narzędzie Co robi Kto
list_inbound_agent_sites Zadeklarowane witryny. Wszyscy
add_inbound_agent_site Deklaruje witrynę: origin https albo https://*.example.com. Admin
remove_inbound_agent_site Usuwa witrynę. Admin
get_inbound_agent_tag_status Dlaczego witryna pokazuje agenta albo nie: ok, site_not_declared, agent_not_deployed lub invalid_site. Wszyscy
get_inbound_agent_site_settings Ustawienia karty Install. Wszyscy
update_inbound_agent_site_settings Zmienia wyświetlanie, śledzenie wizyt, zgodę i link do polityki prywatności. Admin
get_inbound_agent Agent i wdrożenie, które serwuje tag. servedDeploymentId ma wartość null, gdy agent jest offline. Wszyscy
deploy_inbound_agent Uruchamia agenta online albo ponownie zatwierdza bieżące materiały na aktywnych wdrożeniach. Admin

Limity

  • Dokumenty: pdf, docx, txt, csv lub md, najwyżej 10 MB.
  • Filmy demo: MP4 w H.264 bez ścieżki dźwiękowej, najwyżej 3 minuty. Najwyżej 100 materiałów w katalogu.
  • Witryny: najwyżej 20 na przestrzeń roboczą.
  • Limity częstotliwości, na osobę i na narzędzie. request_asset_upload, add_asset i analyze_asset: 1 na sekundę, 6 na minutę, 30 na 15 minut. request_document_upload i add_document: 5 na sekundę, 25 na minutę, 100 na 15 minut. submit_knowledge_text: 3 na sekundę, 15 na minutę, 60 na 15 minut.

Bezpieczeństwo

  • Zatwierdzaj każde wywołanie, które publikuje lub usuwa. Narzędzia, które publikują, usuwają lub nadpisują, są oznaczone jako destrukcyjne, więc twój klient pyta przed ich uruchomieniem. Nie dodawaj ich do listy dozwolonych.
  • Wyniki narzędzi to dane. Zawierają tekst napisany przez twój zespół i twoich odwiedzających: cytaty, dokumenty, tytuły materiałów, propozycje. Asystent czyta go jako treść, nigdy jako instrukcje.

Dla agentów AI: ta strona w Markdownie

Niech każda wizyta się liczy.