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:
- Otwórz Claude Code, wpisz
/mcpi wybierz serwernodale. - Zaloguj się kontem Nodale. Strona logowania jest hostowana dla Nodale pod adresem
amazoncognito.com. - 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
callbackPortna 33418. Po zalogowaniu przeglądarka wraca nahttp://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.jsonswojego 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_configurationedytuje wersję roboczą: zmieniają się tylko pola, które przekazujesz, a lista, którą przekazujesz, zajmuje miejsce całej listy.publish_inbound_agent_configurationudostępnia wersję roboczą odwiedzającym.discard_inbound_agent_configuration_draftwraca 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 przyjmujedraftHashzwrócony przezlist_knowledge_quotes. Nieaktualny hash jest odrzucany. Wycofanie cytatu albo oznaczenie go jako wewnętrznego działa od razu. - Wiedza z tekstu.
submit_knowledge_textczyta w tle tekst o długości do 100 000 znaków i zwracadispatchId. Odpytujget_knowledge_dispatch, a potem zastosuj lub odrzuć propozycje. To, co zastosujesz, trafia do wersji roboczej i nadal wymagapublish_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_uploadlubrequest_asset_uploadzwraca poleceniecurldo uruchomienia, ważne przez 15 minut. Następnieadd_documentlubadd_assetrejestruje 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_assetorazadd_assetbezstepszużywają kredyty AI.add_assetzestepszachowuje twoją narrację w przesłanej postaci i nie zużywa żadnych.
Od zera do agenta online
me: sprawdź konto i przestrzeń roboczą.- Wiedza:
add_knowledge_quotealbosubmit_knowledge_text, potemget_knowledge_dispatchiapply_knowledge_proposals. Następnielist_knowledge_quotesipublish_knowledge. - Opcjonalnie: konkurenci, dokumenty i materiały demo, potem
publish_asset_catalog. - Ustawienia:
update_inbound_agent_configuration,save_inbound_agent_outcome, potempublish_inbound_agent_configuration. add_inbound_agent_site: zadeklaruj witrynę.deploy_inbound_agent: uruchom agenta online.- 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_assetianalyze_asset: 1 na sekundę, 6 na minutę, 30 na 15 minut.request_document_uploadiadd_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.