Przejdź do treści
NodePlan
Dołącz do bety

NodePlan

Dla deweloperów

Jak plan z NodePlan trafia do agenta: połączenie MCP, polecenie „Zrealizuj”, pliki, typy projektów, tokeny, eksport i bezpieczeństwo.

MCP

Połączenie MCP

Zdalny endpoint MCP https://nodeplan.pro/api/mcp i osobisty token: nic nie trzeba instalować. Działa z Claude Code, Codex i Cursorem; konfiguracja Cursora pasuje też do Windsurf i Gemini CLI.

Claude Code Polecenie w terminalu

claude mcp add --transport http -s user nodeplan https://nodeplan.pro/api/mcp --header 'Authorization: Bearer np_…'

Codex ~/.codex/config.toml

# 1) ~/.zshrc / ~/.bashrc (or your secret manager):
export NODEPLAN_TOKEN='np_…'

# 2) ~/.codex/config.toml:
[mcp_servers.nodeplan]
url = "https://nodeplan.pro/api/mcp"
bearer_token_env_var = "NODEPLAN_TOKEN"

Cursor ~/.cursor/mcp.json

{
  "mcpServers": {
    "nodeplan": {
      "url": "https://nodeplan.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer np_…"
      }
    }
  }
}

Token tworzysz w NodePlan: ustawienia projektu, „Podłącz agenta AI”. Pokazuje się jeden raz. Nie wkładaj go do repozytorium: trzymaj konfigurację na poziomie użytkownika.

Co może zrobić agent

nodeplan_get_context
brief i CLAUDE.md projektu: od tego zaczyna agent
nodeplan_get_tasks · nodeplan_set_status
zadania w kolejności realizacji; status „w trakcie”, „gotowe”, „zablokowane” z notatką
nodeplan_ask_question · nodeplan_get_open_questions
pytanie do zespołu zamiast zgadywania i odpowiedzi na nie
nodeplan_propose_changes · nodeplan_get_proposals
propozycja zmiany w specyfikacji; zatwierdzasz ją w NodePlan
nodeplan_get_readiness · nodeplan_get_doc · nodeplan_search
gotowość planu, wygenerowane pliki, wyszukiwanie węzłów

Istniejące repozytorium: podłącz NodePlan do agenta w tym repozytorium, a agent pobierze kontekst i zadania, zgłosi postęp i zada pytania. NodePlan nie zmienia Twoich plików: wygenerowany CLAUDE.md możesz pobrać i trzymać obok swojego albo połączyć z nim ręcznie.

Polecenie

„Zrealizuj”: jedno polecenie, nowe repozytorium

Przycisk „Zrealizuj” w NodePlan daje polecenie: tworzy folder, pobiera aktualny plan przez sekretny link do BUILD-PROMPT.md i uruchamia Claude Code albo Codex. Dla innych agentów jest prompt do wklejenia.

mkdir -p clinic && \
  cd clinic && \
  curl -fsSL 'https://nodeplan.pro/api/build/npb_…' -o BUILD-PROMPT.md && \
  claude 'Read BUILD-PROMPT.md fully and follow it step by step.'
  1. Agent zakłada repozytorium i zapisuje w nim pliki planu.
  2. Używa stosu z briefu; jeśli go tam nie ma, wybiera popularny i zapisuje powód w DECISIONS.md.
  3. Realizuje TASKS.md od góry do dołu: po każdym zadaniu build, testy i commit.
  4. Ma polecenie pytać przed decyzjami, których nie da się łatwo cofnąć.

Pliki

Pliki dla agenta

Pliki powstają z planu deterministycznie, bez AI. Ten sam plan zawsze daje te same pliki. Inne typy projektów dodają własne: docs/FLOWS.md, docs/INTEGRATIONS.md, agents/*.md, STRATEGY.md i inne.

CLAUDE.md · AGENTS.md
zwięzły kontekst na start: najpierw brief, potem mapa zakresu i zasady pracy
TASKS.md
zadania w kolejności realizacji, z kryteriami akceptacji z planu
README.md
opis projektu do repozytorium
docs/PRODUCT.md
produkt: dla kogo, po co, cele
docs/REQUIREMENTS.md
wymagania z priorytetem i kryteriami akceptacji
docs/SCREENS.md
ekrany i bloki na nich
docs/OPEN-QUESTIONS.md
otwarte pytania, na które agent nie może odpowiadać sam
docs/DESIGN.md
styl, gdy w planie jest węzeł designu

Rodzaje projektów

Od strony z rezerwacją po agenta AI.

Każdy typ projektu ma własny zestaw bloków, własne reguły kompletności i własny komplet plików dla agenta. Jeśli nie wiesz, który wybrać, opisz pomysł, a AI zaproponuje typ. Najlepiej dopracowane są dziś strona, aplikacja webowa i agent AI; pozostałe oznaczamy jako wczesną wersję.

Budujesz z agentem AI

Claude Code · Codex · Cursor

Planujesz bez kodu

Tablica z analizą i dokumentem na koniec — wczesna wersja

Strona internetowa

Przykład: Klinika UśmiechClaude Code · Codex · Cursornajlepiej dopracowane

Strony z gotowych sekcji, cel i odbiorcy witryny, analityka, RODO i styl — agent buduje stronę, która prowadzi do rezerwacji.

Cel
50% wizyt online
Aktor
Pacjenci z okolicy
Ekran
Strona główna
Ekran
Usługi i cennik
Ekran
Kontakt i rezerwacja
Wymaganie
Rezerwacja 24/7 bez telefonu
Integracja
Google Analytics 4
Design
Jasny, medyczny styl
W palecie
Strona głównaO nasUsługiKontaktBlogLanding pagePolityka prywatnościStrona 404Pusta stronaCel witrynyOdbiorcyAnalityka (GA4 / GTM)i 29 innych bloków w palecie
Agent dostanie
CLAUDE.mdAGENTS.mdTASKS.mdREADME.mddocs/PRODUCT.mddocs/REQUIREMENTS.mddocs/OPEN-QUESTIONS.mddocs/SCREENS.mddocs/DESIGN.md

A także Inne — cokolwiek — opisz własnymi słowami · Nie wiem — AI rozpozna typ na podstawie opisu.

Dostęp

Tokeny

  • Dostęp: tylko odczyt albo odczyt i zapis (statusy, komentarze, pytania).
  • Każdy token zawsze wygasa: po 30 dniach, 90 dniach albo roku.
  • Token można ograniczyć do jednego projektu.
  • Unieważnisz go jednym kliknięciem na stronie konta; przechowujemy tylko skróty.
  • Notatki zespołu (prywatne) nigdy nie trafiają do eksportu, tokenów ani MCP.

Eksport

Eksport bez blokady

Plan pobierzesz w każdej chwili: pojedynczy plik, ZIP, Markdown z linkami Obsidian albo pełny JSON. Konto usuniesz w ustawieniach.

Bezpieczeństwo

Bezpieczeństwo

  • Tylko na zaproszenie

    Nie ma otwartej rejestracji: konto zakładasz z zaproszenia.

  • Hasła pod ochroną

    argon2id, sprawdzanie w bazach wycieków i blokada konta po serii nieudanych logowań.

  • Ograniczone tokeny agentów

    Zakres, wygasanie, jeden projekt, unieważnienie: patrz wyżej.

  • AI tylko na Twoje polecenie

    Fragment planu trafia do dostawcy modelu (OpenRouter, Groq) tylko wtedy, gdy uruchomisz funkcję AI, i tylko przez serwer NodePlan. Dane mogą być przetwarzane poza EOG.

  • Kod zostaje u Ciebie

    NodePlan przechowuje plan, nie kod. Przez MCP agent przesyła tylko statusy zadań, pytania, komentarze i propozycje zmian.

  • Eksport i usunięcie

    Plan pobierzesz w każdej chwili, a konto usuniesz w ustawieniach.

  • Statystyki tylko za zgodą

    Google Analytics na stronie włącza się dopiero po Twojej zgodzie. Bez reklam i profilowania, a w aplikacji statystyk nie ma.

Polityka prywatności · hello@nodeplan.pro

Porównanie

NodePlan obok prompta i CLAUDE.md

NodePlan nie zastępuje agenta ani jego trybu planowania. Wchodzi wcześniej, przed pierwszą linijką kodu.

  • Długi prompt

    Kiedy wystarczy: Mała, jednorazowa zmiana

    Co dokłada NodePlan: Plan, który sprawdzisz, zwersjonujesz i przekażesz kolejny raz bez przepisywania

  • CLAUDE.md pisany ręcznie

    Kiedy wystarczy: Wiesz dokładnie, co napisać, i sam pilnujesz aktualności

    Co dokłada NodePlan: Pokazuje, czego brakuje, i za każdym razem generuje pliki z aktualnego planu

  • Tryb planowania w agencie

    Kiedy wystarczy: Jedno zadanie w istniejącym repozytorium

    Co dokłada NodePlan: Plan całego produktu przed pierwszym commitem, widoczny dla zespołu i klienta, z pytaniami agenta w jednym miejscu

  • Narzędzia spec-driven w terminalu

    Kiedy wystarczy: Pracujesz w pojedynkę, w plikach tekstowych

    Co dokłada NodePlan: Graf zamiast plików, czytelny także dla osób, które nie piszą kodu, i reguły kompletności dla 9 typów projektów

Wypróbuj na swoim projekcie.

Dołącz do bety