Obrazy do repozytorium z Codexa - MCP Kadrarisa w praktyce

Potrzebujesz ilustracji do README, landingu albo dokumentacji i nie chcesz przełączać się do innej aplikacji? Codex po podpięciu serwera MCP Kadrarisa zleci obraz, poczeka na wynik i zapisze plik w folderze projektu. Jedna rzecz na start: model, z którym rozmawiasz w Codexie, i model, który rysuje obraz, to dwa różne modele. Dodanie MCP nie podmienia modelu rozmowy.

Krok 1. Klucz tylko dla Codexa

Zanim cokolwiek skonfigurujesz, robię osobny klucz:

• w panelu otwieram zakładkę Klucze API i tworzę nowy klucz z nazwą typu "codex-laptop",
• ustawiam mu miesięczny limit wydatków, żeby agent nie przekroczył budżetu nawet przy pomyłce,
• kopiuję go od razu, bo panel pokazuje go tylko raz,
• nie wklejam klucza do repozytorium ani do treści polecenia dla agenta.

Sama konfiguracja MCP nic nie kosztuje. Płatne jest dopiero zlecenie, a do niego potrzebujesz środków na saldzie.

Krok 2. Rejestracja serwera w Codexie

Codex czyta klucz ze zmiennej środowiskowej. Na macOS i Linuksie:

export KADRARIS_API_KEY="sk-kd-..."
codex mcp add kadraris --url https://kadraris.com/mcp \
  --bearer-token-env-var KADRARIS_API_KEY
codex mcp list

W PowerShellu na Windows:

$env:KADRARIS_API_KEY="sk-kd-..."
codex mcp add kadraris --url https://kadraris.com/mcp --bearer-token-env-var KADRARIS_API_KEY

W miejsce sk-kd-... wstaw swój klucz. Zmienna musi być widoczna w procesie, z którego startuje Codex - jeśli ustawisz ją w innym oknie terminala, Codex jej nie zobaczy. Po zmianie zrestartuj aplikację. codex mcp list powinno pokazać serwer kadraris. Inne warianty instalacji opisuje dokumentacja MCP, a ustawienia samego Codexa dokumentacja Codexa.

Krok 3. Polecenie, które najpierw liczy

Najważniejsze jest to, żeby agent pokazał koszt przed wysłaniem zlecenia. Moje polecenie wygląda tak:

Potrzebuję trzech ilustracji do sekcji "Jak to działa" w README. Użyj Kadraris MCP: znajdź model do ilustracji, sprawdź jego pola, wyceń każdy plik przez estimate_cost i pokaż mi sumę. Generuj dopiero po mojej zgodzie, z confirm_token. Zapisz pliki w docs/img/, sprawdź format i wymiary, nie nadpisuj niczego, co już tam jest.

Co się dzieje po drodze:

• Wybór modelu. Agent woła search_models, a potem get_model, więc zna prawdziwe nazwy parametrów zamiast je zgadywać.
• Wycena. Dla każdej z trzech ilustracji osobne estimate_cost z kompletem ustawień. Suma ma obejmować wszystkie pliki, nie tylko pierwszy.
• Zgoda. Mówisz "tak", agent przekazuje confirm_token do generate i śledzi zadanie przez wait_for_task albo get_task.
• Zmiana planu. Inny prompt, model czy rozdzielczość oznaczają nową wycenę. Token jest też ważny tylko przez ograniczony czas.

Na start polecam GPT Image 2.5 - aktualna stawka to 0,293 zł za obraz. To stawka za jednostkę, a nie wycena całego zlecenia. Kilka wariantów i rozdzielczości przeliczysz w kalkulatorze, resztę modeli znajdziesz w cenniku.

Krok 4. Plik na dysku, nie link w kodzie

• Gotowość oznacza status succeeded. queued to dopiero kolejka.
• Adres z output jest ważny ograniczony czas. Agent ma pobrać plik do projektu, a nie wstawić link do HTML czy Markdowna.
• Otwórz zapisany obraz i sprawdź wymiary, zanim zrobisz commit.
• Zapisz gdzieś model, prompt, ustawienia i koszt - przyda się, gdy za miesiąc będziesz chciał ten sam styl.

Nieudana generacja nie kosztuje nic. Udany obraz, którego ostatecznie nie użyjesz, jest płatny jak każdy inny.

Typowe zacięcia

• Codex nie widzi serwera. Sprawdź adres /mcp, to czy klucz jest aktywny i czy zmienna istnieje w procesie Codexa.
• Brak środków albo odmowa. Zajrzyj do salda i limitu klucza w panelu.
• Model odrzuca parametry. Niech agent jeszcze raz pobierze get_model. Ustawienia jednego modelu nie pasują do drugiego.
• Odczyt się urwał. Najpierw odpytaj zapisane id zadania. Nowe zlecenie to nowa opłata.

Więcej scenariuszy dla agentów jest na stronie o agentach AI. Plik AGENTS.md możesz wrzucić do repozytorium - Codex przeczyta z niego zasady korzystania z API.

Pytania

Codex rozliczam osobno, a obrazy z Kadrarisa osobno?

Tak. Obrazy schodzą z salda Kadrarisa (tego samego, z którego korzystasz w Studio). Model rozmowy w Codexie rozliczasz tak jak dotąd, u siebie.

Czy mogę zabronić agentowi generowania bez pytania?

Napisz to w poleceniu albo w AGENTS.md i ustaw niski limit na kluczu. Limit działa po stronie serwera, więc zadziała nawet wtedy, gdy agent zignoruje instrukcję.

Który model wybrać do ikon i prostych grafik?

Zacznij od jednego modelu i jednego pliku testowego. Agent może przez search_models pokazać kilka kandydatów z ceną za jednostkę, a ty wybierasz po pierwszym wyniku.

Oficjalny opis MCP w Codexie: developers.openai.com/codex/mcp.