Plan Budowlany w Claude Desktop — zarządzaj budową przez AI

Wyobraź sobie, że zamiast klikać po aplikacji — po prostu pytasz. „Jaki mam budżet?" „Co jest opóźnione?" „Dodaj zadanie na przyszły tydzień." I dostajesz odpowiedź z żywymi danymi z projektu.

To nie jest demo. Od dziś jest to możliwe — opublikowaliśmy planbudowlany-mcp — serwer MCP na npm, który łączy Claude Desktop z Twoim projektem budowlanym.

Czym jest MCP?

Model Context Protocol to standard, który pozwala agentom AI (jak Claude) korzystać z zewnętrznych narzędzi. Zamiast ręcznie kopiować dane — agent sam odpyta Twój projekt i odpowie w naturalnym języku.

Konfiguracja — 5 minut

1. W aplikacji wejdź w Ustawienia workspace → Klucze API i wygeneruj klucz (pb_...).

2. Dodaj do pliku konfiguracyjnego Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "planbudowlany": {
      "command": "npx",
      "args": ["planbudowlany-mcp"],
      "env": {
        "PB_API_KEY": "pb_twoj_klucz"
      }
    }
  }
}

3. Zrestartuj Claude Desktop — gotowe.

Przykłady rozmów

Sprawdzenie budżetu:

<code> Ty: Jaki jest aktualny stan budżetu na moim projekcie?

Claude: Twój projekt ma budżet 580 000 PLN. Dotychczas wydano 312 450 PLN (53,9%). Pozostało 267 550 PLN. Ostatnie duże pozycje: wylewka fundamentów 48 000 PLN, stolarka okienna 62 000 PLN. </code>

Tworzenie zadania:

<code> Ty: Dodaj zadanie "Tynkowanie ścian wewnętrznych" z terminem 15 lipca.

Claude: Gotowe — zadanie zostało dodane z terminem 15 lipca 2026, status: do zrobienia. </code>

Koszt przypisany do zadania:

<code> Ty: Dodaj koszt 8200 zł za cement.

Claude: Do którego zadania przypisać ten koszt? W toku masz m.in.: "Wylewka fundamentów", "Tynkowanie ścian wewnętrznych", "Instalacja elektryczna"...

Ty: Do tynkowania.

Claude: Koszt 8 200 PLN za cement przypisano do zadania "Tynkowanie ścian wewnętrznych". </code>

Harmonogram i zależności:

<code> Ty: Co jest zaplanowane na lipiec i co od czego zależy?

Claude: W lipcu masz 3 zadania: • Tynkowanie ścian (1–15 lipca) • Malowanie (16–31 lipca) — zależy od tynkowania • Montaż drzwi wewnętrznych (od 20 lipca) — zależy od malowania

Uwaga: opóźnienie tynkowania przesunie cały ten łańcuch. </code>

Co potrafią narzędzia

Pytanie	Narzędzie
Stan projektu i budżet	get_workspace_info + get_cost_summary
Lista zadań (filtr: opóźnione, moje)	list_tasks
Nowe zadanie lub podzadanie	create_task / create_subtask
Zmiana statusu	update_task_status
Dodanie kosztu	create_cost (zawsze przypisany do zadania)
Usterki na budowie	list_issues / get_issue
Dziennik aktywności	list_activity
Harmonogram Gantta	get_timeline

Bezpieczeństwo

Klucz API działa tylko dla jednego projektu (workspace). Pełny klucz jest wyświetlany raz — potem w bazie przechowujemy wyłącznie hash. Token JWT, który serwer MCP używa do API, wygasa co 5 minut i jest odświeżany automatycznie w tle.

---

Instalacja: npx planbudowlany-mcp (Node ≥ 20) lub przez Claude Desktop config powyżej.

Kod źródłowy: github.com/LifeLike-Szymon-Motyka/planbudowlany-mcp