Grafiki na stronę prosto z Cursora - podłączenie MCP Kadrarisa

Robisz stronę w Cursorze i brakuje ci obrazu hero, dwóch ilustracji do sekcji i tła pod formularz. Zamiast szukać w stockach, możesz poprosić agenta w edytorze, żeby je wygenerował przez serwer MCP Kadrarisa i od razu zapisał w public/. Agent, z którym piszesz kod, tylko zleca pracę - obraz tworzy osobny model graficzny, a podpięcie MCP nie zmienia modelu czatu w Cursorze.

Zanim zaczniesz: klucz i saldo

• W panelu, w zakładce Klucze API, zakładam klucz tylko dla Cursora, np. "cursor-projekt-sklep".
• Daję mu miesięczny limit. Jeśli agent wpadnie w pętlę, zatrzyma się na tym limicie, a nie na całym saldzie.
• Kopiuję klucz od razu, bo drugi raz go nie zobaczę. Do repozytorium i do czatu z agentem go nie wklejam.
• Podpięcie serwera jest darmowe. Płacisz dopiero za zlecone obrazy, a do tego potrzebne są środki na koncie.

Podłączenie: przycisk albo plik

Najpierw ustaw zmienną KADRARIS_API_KEY w systemie. W PowerShellu dla bieżącej sesji: $env:KADRARIS_API_KEY="sk-kd-...", na macOS i Linuksie: export KADRARIS_API_KEY="sk-kd-...". Cursor musi być uruchomiony z miejsca, gdzie ta zmienna istnieje, więc po jej ustawieniu zrestartuj edytor.

Potem jedna z dwóch dróg:

• Przycisk. Dodaj do Cursora - link otwiera Cursora i dodaje serwer, który czyta klucz ze zmiennej.
• Plik. W katalogu projektu tworzysz .cursor/mcp.json:

{
  "mcpServers": {
    "kadraris": {
      "url": "https://kadraris.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:KADRARIS_API_KEY}"
      }
    }
  }
}

Zapis ${env:KADRARIS_API_KEY} sprawia, że sam klucz nie trafia do pliku, więc .cursor/mcp.json możesz spokojnie zacommitować. W ustawieniach MCP w Cursorze serwer kadraris powinien pokazać listę narzędzi. Pozostałe sposoby instalacji są w dokumentacji MCP.

Prośba do agenta, która chroni budżet

Agentowi daję jasną kolejność: najpierw koszt, potem zgoda, na końcu generowanie.

Do strony głównej potrzebuję obrazu hero 16:9 i dwóch ilustracji do sekcji z ofertą. Przez Kadraris MCP dobierz model, sprawdź jego parametry, wyceń wszystkie trzy pliki (estimate_cost) i pokaż sumę. Czekaj na moje "tak", potem generuj z confirm_token. Zapisz wyniki w public/generated/, sprawdź format i wymiary, nie nadpisuj istniejących plików, niczego nie publikuj.

Jak to przebiega w praktyce:

1. Agent przegląda modele (search_models) i pobiera schemat wybranego (get_model), więc nie wymyśla nazw pól.
2. Każdy z trzech obrazów dostaje własne estimate_cost z pełnymi ustawieniami, a ty widzisz łączną kwotę.
3. Po twojej zgodzie generate dostaje confirm_token, a agent czeka na wynik przez wait_for_task lub get_task.
4. Gdy w międzyczasie zmienisz zdanie co do promptu, modelu albo rozdzielczości, agent musi wycenić jeszcze raz. Token wygasa po pewnym czasie.

Do grafik na stronę dobrze sprawdza się FLUX.2 [pro], którego stawka to od 0,403 zł za obraz. Pamiętaj, że to cena jednostkowa - zlecenie z trzema plikami albo kilkoma wariantami policz w kalkulatorze albo sprawdź w cenniku.

Po generowaniu: sprawdź, co wylądowało w public/

• Czekasz na succeeded. Status queued oznacza tylko miejsce w kolejce.
• Link z output wygasa po jakimś czasie, dlatego agent ma pobrać plik, a nie wkleić adres do <img src>.
• Otwórz każdy obraz, sprawdź wymiary i to, czy pasuje do layoutu, zanim podepniesz go w komponencie.
• Notuj model, prompt i ustawienia przy plikach - łatwiej dorobić kolejną grafikę w tym samym stylu.

Jeśli generacja się nie uda, nie płacisz. Za poprawny obraz płacisz także wtedy, gdy ostatecznie go nie użyjesz.

Kiedy coś nie gra

• Serwer czerwony w ustawieniach MCP. Sprawdź adres /mcp, czy klucz jest aktywny i czy Cursor widzi zmienną (restart po jej ustawieniu).
• Odmowa z powodu salda albo limitu. Panel pokaże, czy skończyły się środki, czy limit klucza.
• Błąd parametrów. Poproś agenta o ponowne get_model dla wybranego modelu zamiast kopiowania ustawień z innego.
• Agent zgubił wątek w trakcie. Niech odpyta zapisane id zadania. Ponowne zlecenie to druga płatna grafika.

Inne zastosowania agentów zebrałem na stronie o agentach AI. Do repozytorium możesz dołożyć AGENTS.md z zasadami korzystania z API.

Pytania

Czy grafiki z Cursora i ze Studio schodzą z tego samego salda?

Tak, to jedno konto i jedno saldo w Kadrarisie. Subskrypcję samego Cursora rozliczasz osobno, u nich.

Mogę commitować .cursor/mcp.json?

Możesz, jeśli w nagłówku jest ${env:KADRARIS_API_KEY}, a nie wklejony klucz. Każda osoba w zespole ustawia wtedy własną zmienną z własnym kluczem.

Agent wygenerował obraz w złym formacie. Co teraz?

Powiedz mu, jakie proporcje albo rozdzielczość są potrzebne, i poproś o nową wycenę. Pierwsza grafika była udana technicznie, więc jest płatna, druga przejdzie przez kosztorys od nowa.