Resumo rápido
Para usar o Mage no Claude Code, adicione o servidor MCP do Mage (https://mcp.mage.space/mcp) e entre com sua conta do Mage. Assim, o Claude Code pode gerar imagens com o Mango 3, vídeos com o Cherry 2 Pro, áudio com o Seed Audio ou qualquer um dos 28 modelos do Mage que você indicar, com pagamento por geração em Gems.
16
Ferramentas MCP
28
Modelos de imagem, vídeo e áudio
5
Assistentes compatíveis
$0
Para conectar
Configuração
Como conectar o Mage ao Claude Code
É necessária uma conta Mage; uma sessão de visitante não pode conectar um app.
Adicione o servidor
Execute este comando no terminal.
claude mcp add --transport http mage https://mcp.mage.space/mcpAutentique-se
No Claude Code, execute /mcp, escolha mage e autentique-se. Uma página do navegador será aberta para você entrar no Mage e selecionar Conectar.
Ou use uma chave de API
Para pular o login pelo navegador, adicione o servidor com sua chave em um cabeçalho.
claude mcp add --transport http mage https://mcp.mage.space/mcp \ --header "Authorization: Bearer $MAGE_API_KEY"
Experimente
Exemplos de prompts para o Mage no Claude Code
- Gere uma imagem Open Graph de 1200×630 para este post do blog e salve em public/og.png.
- Crie ilustrações de destaque para as três seções da landing page nas cores da nossa marca.
- Envie assets/demo.mp4 e transforme em uma animação em aquarela.
- Crie um vídeo de fundo em loop de 5 segundos para a página inicial.
Ferramentas
16 ferramentas que seu assistente pode usar
| Ferramenta | O que faz |
|---|---|
| list_models | Lista os modelos recomendados com preços, para que cada um é mais indicado e suas limitações. |
| get_model | Descreve os campos, valores permitidos, padrões, regras e preço de um modelo. |
| estimate_cost | Calcula o preço de uma geração antes de começar. Nada é cobrado. |
| create_upload | Gera um link assinado para enviar um arquivo local, para assistentes que executam comandos. |
| generate | Inicia a geração de uma imagem, um vídeo ou um áudio. |
| get_request | Aguarda a conclusão de uma geração e devolve o link do resultado. |
| cancel_request | Interrompe uma geração em andamento. |
| get_account | Mostra a conta conectada e o saldo de Gems. |
| list_characters | Lista seus personagens salvos e seus @handles. |
| create_character | Salva um personagem privado a partir de uma imagem, opcionalmente com uma voz. |
| delete_character | Exclui um dos seus personagens. |
| list_references | Lista seus looks, poses, locais, objetos e clipes de voz salvos. |
| create_reference | Salva uma referência privada a partir de uma imagem ou de um link de áudio. |
| delete_reference | Exclui uma das suas referências. |
| list_history | Lista suas gerações dos últimos 30 dias, inclusive as feitas no app. |
| search_creations | Busca suas criações salvas pelo que mostram, pela coleção ou pela data. |
Mais assistentes
O Mage funciona nos principais assistentes de IA
Mage no Claude
Gere imagens, vídeos e áudios no Claude na web, no app para computador, nos apps para celular e no Cowork.
Mage no ChatGPT
Gere imagens, vídeos e áudios no ChatGPT como um app MCP pessoal.
Mage no Grok
Gere imagens, vídeos e áudios no Grok como um conector personalizado.
Mage no Cursor
Gere imagens, vídeos e áudios no modo Agent do Cursor.
Perguntas frequentes
Perguntas frequentes
O Claude Code consegue gerar imagens para o meu projeto?
Sim. Com o servidor MCP do Mage, o Claude Code pode gerar imagens, vídeos e áudio e baixar os resultados no seu repositório. Ele também pode enviar arquivos do seu projeto com create_upload, como um clipe para editar.
Devo usar OAuth ou chave de API com o Claude Code?
Qualquer um funciona. O OAuth faz o login pelo navegador e não exige nenhum segredo no seu shell. A chave de API serve para CI e máquinas sem interface; envie-a em um cabeçalho Authorization: Bearer.
O que é o servidor MCP do Mage?
Um servidor remoto do Model Context Protocol em https://mcp.mage.space/mcp que permite que assistentes de IA gerem imagens, vídeos e áudios na sua conta do Mage. Ele dá ao assistente 16 ferramentas para escolher um modelo, cotar o preço, gerar, aguardar o resultado e usar seus personagens, referências e histórico salvos.
Preciso de uma chave de API para usar o servidor MCP?
Não. Claude, ChatGPT, Grok, Cursor e Claude Code se conectam fazendo login no Mage via OAuth. A chave de API é opcional, para configurações sem interface, como CI.
Quanto custa?
Conectar é grátis. Cada geração que seu assistente inicia é paga em Gems da sua conta Mage, pelo preço listado do modelo, e seu assistente pode informar o preço com estimate_cost antes de começar.
Quais modelos meu assistente usa?
Se você não indicar um modelo, seu assistente cria imagens com Mango 3, vídeos com Cherry 2 Pro e áudio com Seed Audio. Você pode pedir qualquer outro modelo do Mage pelo nome.
É seguro conectar minha conta Mage?
O Mage mostra o nome do app, o site dele e para onde você volta antes de compartilhar qualquer coisa, e você aprova cada conexão. Desconecte qualquer app quando quiser em MCP → Apps conectados.
Comece a criar com o Mage
Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.