Перейти до змісту
NodePlan
Долучитися до бети

NodePlan

Для розробників

Як план із NodePlan потрапляє до агента: MCP-підключення, команда «Реалізувати», файли, типи проєктів, токени, експорт і безпека.

MCP

Підключення MCP

Віддалений MCP-ендпоінт https://nodeplan.pro/api/mcp і персональний токен: нічого встановлювати не треба. Працює з Claude Code, Codex і Cursor; конфігурацію Cursor підхоплять також Windsurf і Gemini CLI.

Claude Code Команда в терміналі

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_…"
      }
    }
  }
}

Токен створюєш у NodePlan: налаштування проєкту, «Підключити AI-агента». Він показується один раз. Не клади його в репозиторій: тримай конфігурацію на рівні користувача.

Що агент може робити

nodeplan_get_context
бриф і CLAUDE.md проєкту: з цього починає агент
nodeplan_get_tasks · nodeplan_set_status
задачі в порядку виконання; статус «у роботі», «готово», «заблоковано» з нотаткою
nodeplan_ask_question · nodeplan_get_open_questions
питання до команди замість здогадок і відповіді на них
nodeplan_propose_changes · nodeplan_get_proposals
пропозиція змін у специфікації; ти погоджуєш у NodePlan
nodeplan_get_readiness · nodeplan_get_doc · nodeplan_search
готовність плану, згенеровані файли, пошук вузлів

Наявний репозиторій: підключи NodePlan до агента в ньому, і агент бере контекст та задачі, позначає прогрес і ставить питання. Твої файли NodePlan не змінює: згенерований CLAUDE.md можна завантажити й тримати поруч зі своїм або злити вручну.

Команда

«Реалізувати»: одна команда, новий репозиторій

Кнопка «Реалізувати» в NodePlan дає команду: вона створює теку, завантажує актуальний план за секретним посиланням у BUILD-PROMPT.md і запускає Claude Code або Codex. Для інших агентів є промпт, який досить вставити.

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. Агент створює репозиторій і зберігає в ньому файли плану.
  2. Бере стек із брифу; якщо його там немає, обирає поширений і записує причину в DECISIONS.md.
  3. Виконує TASKS.md згори донизу: після кожної задачі збірка, тести й коміт.
  4. Має інструкцію питати перед рішеннями, які важко скасувати.

Файли

Файли для агента

Файли збираються з плану детерміновано, без AI. Той самий план завжди дає ті самі файли. Інші типи проєктів додають свої: docs/FLOWS.md, docs/INTEGRATIONS.md, agents/*.md, STRATEGY.md та інші.

CLAUDE.md · AGENTS.md
стислий контекст на старт: спершу бриф, далі карта обсягу й правила роботи
TASKS.md
задачі в порядку виконання, з критеріями приймання з плану
README.md
опис проєкту для репозиторію
docs/PRODUCT.md
продукт: для кого, навіщо, цілі
docs/REQUIREMENTS.md
вимоги з пріоритетом і критеріями приймання
docs/SCREENS.md
екрани й блоки на них
docs/OPEN-QUESTIONS.md
відкриті питання, на які агент не має відповідати сам
docs/DESIGN.md
стиль, коли в плані є вузол дизайну

Види проєктів

Від сайту із записом до AI-агента.

Кожен тип проєкту має свій набір блоків, свої правила повноти і свій комплект файлів для агента. Якщо не знаєш, який обрати, опиши ідею, і AI запропонує тип. Найкраще сьогодні відпрацьовані сайт, веб-застосунок і AI-агент; решту позначено як ранню версію.

Будуєш з AI-агентом

Claude Code · Codex · Cursor

Плануєш без коду

Дошка з аналізом і документом наприкінці — рання версія

Сайт

Приклад: Стоматологія Smile ClinicClaude Code · Codex · Cursorнайкраще відпрацьовано

Сторінки з готових секцій, ціль і аудиторія сайту, аналітика, GDPR і стиль — агент збирає сайт, що веде до запису.

Ціль
50% візитів — онлайн
Актор
Пацієнти поблизу
Екран
Головна
Екран
Послуги й ціни
Екран
Контакти й запис
Вимога
Запис 24/7 без дзвінка
Інтеграція
Google Analytics 4
Дизайн
Світлий медичний стиль
У палітрі
ГоловнаПро насПослугиКонтактиБлогЛендингПолітика конфіденційностіСторінка 404Порожня сторінкаЦіль сайтуАудиторіяАналітика (GA4 / GTM)і ще 29 блоків у палітрі
Агент отримає
CLAUDE.mdAGENTS.mdTASKS.mdREADME.mddocs/PRODUCT.mddocs/REQUIREMENTS.mddocs/OPEN-QUESTIONS.mddocs/SCREENS.mddocs/DESIGN.md

А ще Інше — будь-що — опиши словами · Не знаю — AI визначить з опису.

Доступ

Токени

  • Доступ: лише читання або читання й запис (статуси, коментарі, питання).
  • Кожен токен завжди має термін дії: 30 днів, 90 днів або 1 рік.
  • Токен можна обмежити одним проєктом.
  • Відкликається одним кліком на сторінці акаунта; зберігаємо лише хеші.
  • Нотатки команди (приватні) не потрапляють ні в експорт, ні до токенів і MCP.

Експорт

Експорт без прив'язки

План можна завантажити будь-коли: окремий файл, ZIP, Markdown із посиланнями Obsidian або повний JSON. Акаунт видаляється в налаштуваннях.

Безпека

Безпека

  • Лише за запрошенням

    Відкритої реєстрації немає: акаунт створюєш із запрошення.

  • Захищені паролі

    argon2id, перевірка за базами витоків і блокування акаунта після серії невдалих входів.

  • Обмежені токени агентів

    Права, термін дії, один проєкт, відкликання: див. вище.

  • AI лише коли ти просиш

    Фрагмент плану йде до постачальника моделі (OpenRouter, Groq), лише коли ти запускаєш AI-функцію, і тільки через сервер NodePlan. Дані можуть оброблятися поза ЄЕЗ.

  • Код лишається в тебе

    NodePlan зберігає план, а не код. Через MCP агент надсилає лише статуси задач, питання, коментарі й пропозиції змін.

  • Експорт і видалення

    План можна завантажити будь-коли, а акаунт видалити в налаштуваннях.

  • Статистика лише за згодою

    Google Analytics на сайті вмикається лише після твоєї згоди. Без реклами й профілювання, у застосунку статистики немає.

Політика конфіденційності · hello@nodeplan.pro

Порівняння

NodePlan поруч із промптом і CLAUDE.md

NodePlan не замінює агента чи його режим планування. Він потрібен раніше, до першого рядка коду.

  • Довгий промпт

    Коли цього досить: Невелика разова зміна

    Що додає NodePlan: План, який можна перевірити, версіонувати й передати ще раз без переписування

  • CLAUDE.md, написаний руками

    Коли цього досить: Ти точно знаєш, що писати, і сам стежиш за актуальністю

    Що додає NodePlan: Показує, чого бракує, і щоразу генерує файли з актуального плану

  • Режим планування в агенті

    Коли цього досить: Одна задача в наявному репозиторії

    Що додає NodePlan: План усього продукту до першого коміту, видимий команді й клієнту, з питаннями агента в одному місці

  • Spec-driven інструменти в терміналі

    Коли цього досить: Працюєш сам, у текстових файлах

    Що додає NodePlan: Граф замість файлів, зрозумілий і тим, хто не пише код, і правила повноти для 9 типів проєктів

Спробуй на своєму проєкті.

Долучитися до бети