Po co podpinać Claude Code do UiPath
Zespoły, które rozwijają automatyzacje w UiPath Studio, stają dziś przed dwoma równoległymi presjami. Z jednej strony rośnie liczba artefaktów do utrzymania - workflow XAML, project.json, Config.xlsx, PDD, SDD, TDD, raporty z testów. Z drugiej - klienci oczekują, że nowy proces zostanie zaprojektowany, udokumentowany i przekazany do produkcji w tempie, którego nie da się utrzymać siłą ręcznej pracy analityka i developera.
Claude Code w połączeniu z UiPath - dostępnym przez Model Context Protocol (MCP) oraz oficjalne UiPath CLI - pozwala obciążyć agenta AI pracą, w której halucynacja jest najmniej groźna: czytaniem, walidacją, generowaniem dokumentacji i raportów. Nie zastępuje developera Studio. Stoi obok niego jako recenzent i archiwista, który zna kontekst projektu i standardy automatyzacji procesów w SNOK.
Poniżej dokładny setup, którego używamy wewnętrznie - od pierwszej komendy w terminalu po działający workflow claude + uip w katalogu projektu.
Co to jest Claude Code, MCP i UiPath CLI
Claude Code to oficjalny CLI Anthropic - interaktywny agent uruchamiany w terminalu, który czyta pliki, edytuje kod i wywołuje narzędzia w katalogu projektu. Plik CLAUDE.md w korzeniu repozytorium staje się dla niego kontekstem startowym - zna stack technologiczny, konwencje nazewnicze i obowiązujące standardy zanim zacznie pracę.
Model Context Protocol (MCP) to otwarty standard, w którym Claude komunikuje się z zewnętrznymi systemami - bazami danych, narzędziami SaaS, API platform automatyzacji. Każdy MCP server eksponuje zestaw narzędzi (tools) i zasobów (resources), z których Claude korzysta tak, jakby były wbudowane. Dla zespołu RPA oznacza to, że agent może odczytać listę procesów w UiPath Orchestrator, sprawdzić status zadania albo pobrać definicję workflow - bez przechodzenia przez przeglądarkę.
UiPath CLI (uip) to oficjalne narzędzie wiersza poleceń do skryptowej obsługi UiPath Studio i Orchestratora - publikacja paczek, zarządzanie kolejkami, uruchamianie procesów, eksport logów. Razem z Claude Code daje deweloperowi środowisko, w którym jeden agent rozumie kontekst projektu, drugi (CLI) faktycznie wykonuje operacje na platformie.
Krok 1 - Instalacja Claude Code
Wymagania bazowe: Node.js 18 lub nowszy oraz aktywny npm lub npx. Jeśli ich nie macie, na macOS używamy brew install node, na Windows oficjalnego instalatora z nodejs.org, na Linuxie pakietu z dystrybucji lub nvm.
macOS i Linux:
npm install -g @anthropic-ai/claude-code
claude --versionWindows (PowerShell jako administrator):
npm install -g @anthropic-ai/claude-code
claude --versionPo instalacji uruchamiamy claude w katalogu projektu. Pierwsze uruchomienie poprosi o zalogowanie - dla zespołu enterprise zalecamy konto Claude Pro lub Max z subskrypcją SNOK, nie klucz API (łatwiejsza rotacja dostępu i centralna kontrola).
Uwaga ISO: dostęp do Claude Code jest objęty procedurą onboarding/offboarding zgodnie z normą ISO 27001:2023. Każdy nowy użytkownik wpisywany jest do rejestru dostępów, a wylogowanie wymuszane przy zakończeniu współpracy.
Krok 2 - Plik CLAUDE.md w projekcie UiPath
Zanim Claude Code zobaczy jakikolwiek workflow, powinien wiedzieć, w jakim projekcie pracuje. Plik CLAUDE.md w korzeniu repozytorium UiPath ładuje się automatycznie na początku każdej sesji. W SNOK używamy ujednoliconego szablonu:
# Projekt: {Nazwa procesu}
## Stack
- UiPath Studio 24.10 (Windows, VB.NET)
- REFramework (Dispatcher + Performer)
- Orchestrator: cloud.uipath.com / tenant: DefaultTenant
- .NET Framework 4.6.1
## Aplikacje docelowe
- SAP GUI 7.70 (moduł FI-AP)
- Outlook desktop
- Internal portal X (Chrome via UiAutomation.Activities)
## Standard SNOK
- Naming: PascalCase dla workflow, camelCase dla argumentów
- Logging: poziom Info dla kroków biznesowych, Trace dla diagnostyki
- Wyjątki: BusinessRuleException -> retry 0, SystemException -> retry 3
- Hard-coded values: zabronione poza Config.xlsx
## Co Claude robi w tym projekcie
- Walidacja PDD i generowanie draftu SDD/TDD
- Review XAML w trybie QA z raportem RAG (czerwony/żółty/zielony)
- Aktualizacja Config.xlsx zgodnie z mapping table z PDD
- Generowanie raportu z testów regresyjnych
## Czego Claude NIE robi
- Nie generuje surowego XAML od zera - ryzyko halucynacji aktywności
- Nie modyfikuje plików .nupkg
- Nie wysyła nic do Orchestratora bez explicit potwierdzeniaOstatnie dwie sekcje - “Co Claude robi” i “Czego Claude NIE robi” - są krytyczne. Bez nich agent próbuje generować XAML z aktywnościami, których nie ma w paczce projektu, a developer traci czas na demontaż niedziałającego kodu.
Krok 3 - Instalacja i autoryzacja UiPath CLI
UiPath publikuje oficjalny CLI jako paczkę npm:
npm install -g @uipath/cli
uip --versionKonfiguracja połączenia z Orchestratorem wykorzystuje zmienne środowiskowe lub plik .env w katalogu projektu:
UIPATH_URL = https://cloud.uipath.com
UIPATH_ORGANIZATION_NAME = snok
UIPATH_TENANT_NAME = DefaultTenant
UIPATH_CLIENT_ID = {service account client id}
UIPATH_CLIENT_SECRET = {service account secret - secret manager, nie git}Autoryzację realizujemy przez Personal Access Token (developer) lub External Application (service account dla CI/CD). W projektach produkcyjnych obowiązuje druga opcja - PAT przypisany do osoby fizycznej trafia do rejestru ryzyk i wymaga rotacji co 90 dni.
Po konfiguracji weryfikujemy połączenie:
uip cloud orchestrator list-folders
uip cloud orchestrator list-processes --folder SharedJeśli komendy zwracają listy zasobów - środowisko jest gotowe.
Krok 4 - Podpięcie UiPath przez MCP
MCP daje Claude’owi możliwość zapytania o stan platformy bez wychodzenia z sesji. Konfiguracja serwera MCP zależy od wybranego klienta - dla Claude Code w katalogu projektu używamy pliku .mcp.json:
{
"mcpServers": {
"uipath": {
"command": "npx",
"args": ["-y", "@uipath/mcp-server"],
"env": {
"UIPATH_URL": "https://cloud.uipath.com",
"UIPATH_ORGANIZATION_NAME": "snok",
"UIPATH_TENANT_NAME": "DefaultTenant",
"UIPATH_CLIENT_ID": "${UIPATH_CLIENT_ID}",
"UIPATH_CLIENT_SECRET": "${UIPATH_CLIENT_SECRET}"
}
}
}
}Po restarcie sesji claude wykrywa serwer automatycznie. W terminalu zadaje się pytania w języku naturalnym - “wymień procesy w folderze Shared”, “pokaż ostatnie 10 nieudanych jobów”, “podaj listę kolejek wraz z liczbą oczekujących elementów” - a agent woła odpowiednie narzędzia MCP w tle.
Uwaga bezpieczeństwa AI Act i NIS2: każdy MCP server musi przejść w SNOK przegląd AI Security przed dopuszczeniem do projektu klienckiego. Sprawdzamy zakres uprawnień service account (zasada minimum), logujemy wszystkie wywołania narzędzi i nigdy nie podpinamy serwera z uprawnieniami pisania do produkcyjnego Orchestratora bez bramki Human-in-the-Loop.
Pełna lista oficjalnych pakietów MCP dla UiPath rozwija się dynamicznie - aktualne adresy paczek warto każdorazowo sprawdzić w UiPath Marketplace i dokumentacji agentic AI przed instalacją na środowisku klienta.
Krok 5 - Praktyczny workflow w projekcie
Po wykonaniu kroków 1-4 katalog projektu UiPath wygląda następująco:
Invoice-Processing/
├── .claude/
│ ├── qa-gates.md <- definicja bram QA (RAG)
│ └── allowed-activities.md <- whitelist aktywności + NuGet
├── .mcp.json <- konfiguracja MCP UiPath
├── CLAUDE.md <- kontekst projektu
├── Main.xaml
├── Framework/
├── Workflows/
├── project.json
├── Data/
│ └── Config.xlsx
└── Documentation/
├── PDD-Invoice-Processing.docx
└── SDD-Invoice-Processing.docxW codziennej pracy developera sesja zaczyna się od claude w katalogu projektu. Typowe komendy w sesji:
- “Przeczytaj PDD i wskaż braki w specyfikacji wyjątków biznesowych” - Claude porównuje treść PDD z szablonem SNOK i listuje brakujące sekcje.
- “Wygeneruj draft SDD na podstawie PDD i mojego CLAUDE.md” - agent tworzy strukturę dokumentu z mapowaniem na REFramework, decyzjami architektonicznymi i sekcją Configuration.
- “Wykonaj QA workflow Process.xaml” - Claude czyta XAML jako XML i raportuje naruszenia konwencji nazewniczych, brakujące try/catch, hard-coded values.
- “Pokaż status procesu Invoice-Processing w Orchestratorze” - przez MCP Claude woła UiPath i odpowiada na podstawie aktualnych danych.
- “Zaproponuj rozszerzenie Config.xlsx o klucze potrzebne dla obsługi waluty EUR” - agent czyta istniejący Excel, sprawdza spójność z workflow i proponuje wpisy.
QA Gates - jak nie wpuścić halucynacji do produkcji
W SNOK przyjęliśmy zasadę, że Claude Code w projektach UiPath działa jako recenzent i dokumentalista, nie generator XAML. Powód jest prosty: składnia aktywności UiPath bywa zaskakująca, a model jezykowy chętnie zaproponuje aktywność, która nie istnieje w wybranym pakiecie. Plik .claude/qa-gates.md definiuje bramki, które muszą przejść każdy artefakt zanim trafi do klienta:
- Pass 1 - Crash check. Czy XAML się otwiera w Studio? Czy nie ma odwołań do enumów spoza zaimportowanych pakietów?
- Pass 2 - Architecture check. Czy modularyzacja zgodna z REFramework? Czy nazewnictwo i kierunki argumentów (In/Out/InOut) zgodne ze standardem SNOK?
- Pass 3 - Security check. Czy w workflow nie ma hard-coded credentials, ścieżek, URL produkcyjnych?
- Pass 4 - Documentation completeness. Czy PDD, SDD, TDD i Config.xlsx są spójne? Czy każdy klucz w Config.xlsx jest faktycznie używany?
Każdy pass kończy się raportem w jednym z trzech stanów: czerwony (blokuje przekazanie), żółty (wymaga uzasadnienia od developera), zielony (zgoda na handoff). Claude wypełnia raport, człowiek - Tech Lead lub Test Manager - akceptuje wynik. To ten sam wzorzec, którego używamy w testach automatycznych w UiPath Test Cloud.
Co dalej
Setup, który tu opisaliśmy, to fundament. Następne dwa kroki, które warto wykonać po pierwszym tygodniu pracy z Claude Code w projekcie UiPath:
- Pre-commit hooks Git - automatyczne uruchamianie QA review przed każdym commitem. Czerwony status blokuje wpisanie zmian do repozytorium.
- Skill
snok-uipath- katalog reguł SNOK dla projektów UiPath (REFramework, agentic AI, AI Trust Layer, governance), ładowany przez Claude’a do każdej sesji w naszym tooling. Skill jest dostępny dla zespołu SNOK i partnerów - obejmuje również procedury AI Security wymagane przy projektach agentowych dla klientów objętych NIS2 i DORA.
Kierunek jest jeden: agent kodujący wchodzi do enterprise nie jako gadżet developerski, lecz jako element procesu z bramkami, audytem i odpowiedzialnością. Im wcześniej zespół ustawi sobie standardy, tym mniej będzie sprzątał za AI, gdy obowiązki regulacyjne staną się surowsze.
Chcesz zobaczyć to w praktyce lub omówić wdrożenie w swojej firmie? Napisz do nas - odpowiemy w ciągu 48 h.