Wideo, obrazy i muzyka z terminala - Claude Code z MCP Kadrarisa od zera

Model językowy sam z siebie pisze tekst. Nie zrobi klipu, okładki ani dżingla. Claude Code dostaje te możliwości dopiero wtedy, gdy podłączysz mu zewnętrzne narzędzia, i właśnie do tego służy serwer MCP Kadrarisa. Po jednej komendzie w terminalu możesz napisać "przygotuj 5-sekundową pionową rolkę o porannej kawie", a agent dobierze model, pokaże koszt i po twojej zgodzie zleci film. Przy Seedance 2.5 stawka wynosi od 1,51 zł za sekundę, a generacja, która się nie uda, kosztuje 0 zł.

Poniżej przechodzę przez całość: do czego to się przydaje, jak ustawić klucz z limitem, komendy na Windows i macOS, pierwszy klip, zapis plików i najczęstsze błędy.

MCP w dwóch zdaniach

MCP (Model Context Protocol) to otwarty standard, przez który agent dostaje narzędzia z zewnątrz. Rejestrujesz serwer raz, Claude Code czyta listę narzędzi z opisami i parametrami, a gdy uzna, że któreś pomoże w zadaniu, pyta cię o zgodę i je wywołuje.

Kod nadal pisze Claude. Kadraris dokłada mu to, czego model językowy nie potrafi: tworzenie mediów i wiedzę o cenach.

Co agent dostaje do ręki

Serwer Kadrarisa udostępnia kilkanaście narzędzi. Te, których Claude Code używa najczęściej:

Pełną listę (razem z list_tasks, cancel_task i search_docs) opisuje dokumentacja serwera MCP.

Komu to się opłaca

• Budujesz strony i aplikacje. Agent stawia landing i od razu robi do niego tło hero, ikony albo krótki film do sekcji z opisem produktu.
• Robisz rolki, ale wolisz terminal od przeglądarki. Scenariusz leży w pliku, agent generuje ujęcia po kolei i odkłada je do folderu.
• Prototypujesz grę albo prezentację. Grafiki zastępcze powstają w kilka minut, bez przełączania okien.
• Piszesz automatyzację. Claude Code najpierw testuje parametry przez MCP, a potem pisze skrypt wołający REST API.

Jeśli wolisz klikać, ten sam efekt dostaniesz w przeglądarce w Kadraris Studio. MCP ma sens, gdy i tak większość dnia spędzasz w terminalu.

Klucz z limitem: od tego zaczynam

1. Załóż konto i potwierdź e-mail.
2. W panelu doładuj saldo - od 40 zł, BLIK-iem albo kartą. Fakturę VAT zaznaczasz przy doładowaniu. Saldo nie wygasa.
3. Otwórz zakładkę Klucze API.
4. Nazwij klucz, np. claude-code-media.
5. W Limicie miesięcznym wpisz kwotę, której agent nie może przekroczyć, na przykład 50.
6. Kliknij Utwórz klucz i skopiuj sk-kd-.... Panel pokazuje go tylko raz.

Limit to dla mnie najważniejsze ustawienie w całym procesie. Agent z dostępem do wideo przy niejasnym poleceniu może zamówić kilka klipów jeden po drugim. Gdy klucz dojdzie do limitu, API odpowiada 403 i z salda nic już nie schodzi.

Rejestracja serwera w Claude Code

Claude Code jeszcze nie masz? Instalację opisałem w tekście ile kosztuje Claude Code i jak go uruchomić.

Komenda wygląda tak samo w PowerShellu, w Terminalu na macOS i w Linuksie. Otwórz terminal w folderze projektu i podmień klucz:

claude mcp add --transport http kadraris \
  https://kadraris.com/mcp \
  --header "Authorization: Bearer sk-kd-..."

Tak dodany serwer działa tylko w tym jednym projekcie. Jeśli chcesz go we wszystkich, dodaj --scope user:

claude mcp add --transport http kadraris \
  https://kadraris.com/mcp --scope user \
  --header "Authorization: Bearer sk-kd-..."

Sprawdzenie:

claude mcp list

Przy kadraris powinno być Connected. W samym Claude Code komenda /mcp pokaże serwer i jego narzędzia. Na koniec test, który nic nie kosztuje:

Użyj get_balance z serwera kadraris i powiedz, ile mam środków.

Jeśli w odpowiedzi pojawi się kwota w złotówkach, połączenie działa.

Pierwszy klip krok po kroku

Wklej do Claude Code:

Pionowa rolka 9:16, Seedance 2.5, 5 sekund, 720p: barista
nalewa mleko do espresso, para nad filiżanką, ciepłe światło
z okna. Najpierw wycena przez estimate_cost i czekaj na moje ok.

Kolejność zdarzeń:

1. Agent woła get_model dla seedance-2.5 i sprawdza nazwy parametrów.
2. Woła estimate_cost i podaje kwotę. Ta wycena jest bezpłatna.
3. Czeka na twoje "ok", a potem prosi o zgodę na generate - widzisz dokładny prompt i parametry, które wyśle.
4. generate czeka na wynik do 240 sekund. Wideo zwykle trwa od 1 do 4 minut, więc jeśli nie zdąży, agent dostaje id zadania i dokańcza przez wait_for_task.
5. Przy statusie succeeded dostajesz link do pliku MP4 i rzeczywisty koszt.

Gdyby agent zapomniał o sprawdzeniu zadania, napisz po prostu "sprawdź zadanie". Jeśli generacja się wysypie, zablokowane środki wracają na saldo w całości.

Plik do projektu, zanim link wygaśnie

Adresy wyników działają ograniczony czas. Każdy wynik ma gotowe polecenie curl -o, więc wystarczy dopisać:

Zapisz ten klip w media/ jako barista-916.mp4.

Claude Code użyje curl albo Invoke-WebRequest i odłoży plik obok kodu.

Polecenia, które warto wypróbować

• "Postaw prostą stronę piekarni w index.html i wygeneruj do niej tło 16:9 w Nano Banana Pro. Koszt najpierw."
• "Znajdź pięć najtańszych modeli wideo z 1080p i podaj cenę za sekundę."
• "Zrób trzy warianty ikony aplikacji 1:1 w GPT Image 2.5 i zapisz je w assets/icons/."
• "Przeczytaj scenariusz.md, z każdej sceny zrób osobny klip 9:16 po 5 sekund i podaj łączny koszt przed startem."
• "Napisz zwrotkę o porannym bieganiu i zrób z niej piosenkę w Mureka V9."
• "Zapytaj Gemini 3.6 Flash narzędziem chat, co sądzi o tym komponencie."

Stawki modeli z listy:

Ile wychodzi kompletna rolka, policzyłem w tekście ile kosztuje rolka AI.

Model do kodu i media z jednego konta?

MCP nie wymaga, żeby sam Claude Code liczył tokeny przez Kadraris. Możesz mieć plan Anthropic do kodu i Kadraris wyłącznie do mediów.

Możesz też przełączyć Claude Code na tokeny z salda Kadrarisa, w złotówkach i z fakturą VAT. Konfigurację pokazuję w dokumentacji Claude Code i w tekście o Claude Code dla zespołu. Wtedy proponuję dwa osobne klucze, jeden na tokeny i drugi na MCP. W panelu od razu widać, ile poszło na kod, a ile na wideo.

Stałe reguły w AGENTS.md

Żeby nie dopisywać do każdego polecenia "najpierw koszt", pobierz do projektu opis API i dodaj pod nim swoje zasady:

curl -fsSL https://kadraris.com/agents.md -o AGENTS.md
echo "@AGENTS.md" >> CLAUDE.md

PowerShell:

Invoke-WebRequest -Uri "https://kadraris.com/agents.md" -OutFile "AGENTS.md"
Add-Content -Path "CLAUDE.md" -Value "@AGENTS.md"

Pod spodem dopisz np. "Przed każdym filmem podaj koszt i czekaj na zgodę. Pliki zapisuj w media/". Więcej w opisie pliku AGENTS.md.

Pieniądze i bezpieczeństwo

• generate zawsze z pytaniem. Claude Code prosi o zgodę przed każdym wywołaniem i niech tak zostanie. Stałą zgodę możesz dać narzędziom bezpłatnym: search_models, get_model, estimate_cost, get_task, wait_for_task, get_balance.
• Klucz poza gitem. Przy --scope project konfiguracja trafia do .mcp.json w repozytorium, a razem z nią klucz. Zostań przy zakresie domyślnym albo --scope user.
• Limit na kluczu zatrzyma wydatki niezależnie od pomysłów agenta.
• Porażka = 0 zł. Jeśli model odrzuci prompt albo zwróci błąd, środki wracają.

Gdy coś nie działa

Pytania

Czy agent może ożywić zdjęcie z mojego dysku?

Tak. Narzędzie upload_file zamienia lokalny plik na adres, który agent wstawia jako image_url w modelu obsługującym zdjęcie na wejściu. Potem idzie zwykła ścieżka: wycena, zgoda, generowanie.

Ile kosztuje sama rozmowa z agentem, poza filmem?

Tokeny Claude'a za rozmowę rozliczasz tam, gdzie masz Claude Code - w planie Anthropic albo z salda. Ile to wyjdzie, zależy od długości rozmowy i wybranego modelu, a kwotę za samo wideo przed startem pokaże estimate_cost.

Czy ten serwer zadziała w innym programie niż Claude Code?

Tak, w Codex CLI, Cursorze, VS Code, Cline i Claude Desktop. Konfiguracje są w dokumentacji MCP, a Codexa opisuję w tekście Codex i MCP Kadrarisa.

Gdzie znajdę wyniki, gdy zgubię link?

Historia generacji zostaje na koncie, a ostatnie zadania agent pokaże narzędziem list_tasks. Plik i tak najlepiej pobrać od razu, bo linki wygasają.