W skrócie
Aby używać Mage w Claude Code, dodaj serwer MCP Mage (https://mcp.mage.space/mcp) i zaloguj się na konto Mage. Claude Code wygeneruje wtedy obrazy w Mango 3, wideo w Cherry 2 Pro, audio w Seed Audio lub w dowolnym z 28 modeli Mage, które wskażesz. Płacisz za każde generowanie w Gems.
16
Narzędzia MCP
28
Modele obrazu, wideo i dźwięku
5
Obsługiwani asystenci
$0
Do połączenia
Konfiguracja
Jak połączyć Mage z Claude Code
Potrzebne jest konto Mage; sesja gościa nie może połączyć aplikacji.
Dodaj serwer
Uruchom to polecenie w terminalu.
claude mcp add --transport http mage https://mcp.mage.space/mcpUwierzytelnij się
W Claude Code uruchom /mcp, wybierz mage i uwierzytelnij się. Otworzy się strona w przeglądarce, na której zalogujesz się do Mage i wybierzesz Connect.
Albo użyj klucza API
Aby pominąć logowanie w przeglądarce, dodaj serwer, podając klucz w nagłówku.
claude mcp add --transport http mage https://mcp.mage.space/mcp \ --header "Authorization: Bearer $MAGE_API_KEY"
Wypróbuj
Przykładowe prompty dla Mage w Claude Code
- Wygeneruj obraz Open Graph 1200×630 do tego wpisu na blogu i zapisz go w public/og.png.
- Zrób ilustracje hero do trzech sekcji strony docelowej w kolorach naszej marki.
- Wgraj assets/demo.mp4 i przestyluj go na animację w stylu akwareli.
- Stwórz zapętlone, 5-sekundowe wideo w tle na stronę główną.
Narzędzia
16 narzędzi, które może wywołać Twój asystent
| Narzędzie | Co robi |
|---|---|
| list_models | Wyświetla polecane modele wraz z cenami, zastosowaniami i kompromisami. |
| get_model | Opisuje pola modelu, dozwolone wartości, ustawienia domyślne, zasady i cenę. |
| estimate_cost | Wycenia generację przed jej startem. Nic nie jest pobierane. |
| create_upload | Zwraca podpisany link do przesłania lokalnego pliku, dla asystentów, które mogą uruchamiać polecenia. |
| generate | Rozpoczyna generowanie obrazu, wideo lub dźwięku. |
| get_request | Czeka na zakończenie generacji i zwraca link do wyniku. |
| cancel_request | Zatrzymuje trwającą generację. |
| get_account | Pokazuje połączone konto i saldo Gemów. |
| list_characters | Wyświetla Twoje zapisane postacie i ich @uchwyty. |
| create_character | Zapisuje prywatną postać na podstawie obrazu, opcjonalnie z głosem. |
| delete_character | Usuwa jedną z Twoich postaci. |
| list_references | Wyświetla Twoje zapisane stroje, pozy, lokacje, obiekty i próbki głosu. |
| create_reference | Zapisuje prywatną referencję na podstawie obrazu lub linku do audio. |
| delete_reference | Usuwa jedną z Twoich referencji. |
| list_history | Wyświetla Twoje generacje z ostatnich 30 dni, także te z aplikacji. |
| search_creations | Przeszukuje Twoje zapisane prace według tego, co przedstawiają, kolekcji lub daty. |
Więcej asystentów
Mage działa we wszystkich głównych asystentach AI
Mage w Claude
Generuj obrazy, wideo i audio w Claude w przeglądarce, aplikacji desktopowej, aplikacjach mobilnych i w Cowork.
Mage w ChatGPT
Generuj obrazy, wideo i audio w ChatGPT jako osobista aplikacja MCP.
Mage w Grok
Generuj obrazy, wideo i audio w Grok jako niestandardowy konektor.
Mage w Cursor
Generuj obrazy, wideo i audio w trybie Agent w Cursor.
FAQ
Najczęściej zadawane pytania
Czy Claude Code może generować obrazy do mojego projektu?
Tak. Dzięki serwerowi MCP Mage Claude Code może generować obrazy, wideo i audio, a potem pobierać wyniki do Twojego repozytorium. Może też wgrywać pliki z projektu przez create_upload, na przykład klip do edycji.
Czy w Claude Code lepiej użyć OAuth, czy klucza API?
Działa jedno i drugie. OAuth loguje przez przeglądarkę i nie wymaga trzymania sekretu w powłoce. Klucz API sprawdza się w CI i na maszynach bez interfejsu graficznego; przekaż go w nagłówku Authorization: Bearer.
Czym jest serwer MCP Mage?
To zdalny serwer Model Context Protocol pod adresem https://mcp.mage.space/mcp, dzięki któremu asystenci AI mogą generować obrazy, wideo i audio na Twoim koncie Mage. Daje asystentowi 16 narzędzi do wyboru modelu, wyceny, generowania, oczekiwania na wynik oraz korzystania z Twoich zapisanych postaci, referencji i historii.
Czy potrzebuję klucza API, żeby korzystać z serwera MCP?
Nie. Claude, ChatGPT, Grok, Cursor i Claude Code łączą się po zalogowaniu do Mage przez OAuth. Klucz API jest opcjonalny i przydaje się w konfiguracjach bez interfejsu, np. w CI.
Ile to kosztuje?
Połączenie jest bezpłatne. Każde generowanie, które uruchomi Twój asystent, jest opłacane w Gems z Twojego konta Mage według ceny modelu podanej na liście, a asystent może podać cenę za pomocą estimate_cost, zanim zacznie.
Z jakich modeli korzysta mój asystent?
Jeśli nie wskażesz modelu, asystent tworzy obrazy w Mango 3, wideo w Cherry 2 Pro, a dźwięk w Seed Audio. Możesz poprosić o dowolny inny model Mage, podając jego nazwę.
Czy podłączanie konta Mage jest bezpieczne?
Zanim cokolwiek zostanie udostępnione, Mage pokazuje nazwę aplikacji, jej stronę i adres, do którego wrócisz, a każde połączenie zatwierdzasz Ty. Dowolną aplikację możesz odłączyć w każdej chwili w sekcji MCP → Połączone aplikacje.
Zacznij tworzyć z Mage
Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.