Mage

npx add-mcp 'https://mcp.mage.space/mcp'

Use o Mage no Claude, ChatGPT, Grok e Cursor

Conecte o Claude, ChatGPT, Claude Code, Grok ou Cursor à sua conta Mage por meio do servidor MCP do Mage e, em seguida, peça ao seu assistente para gerar imagens, vídeos e áudio, pagos em Gems.

O servidor MCP do Mage conecta assistentes de IA à sua conta Mage. Depois de conectado, você pode pedir ao Claude, ChatGPT, Claude Code, Grok ou Cursor para escolher um modelo, cotar o preço, gerar uma imagem, um vídeo ou um clipe de áudio e trazer o resultado de volta. Ele também lê seu histórico de gerações e criações salvas, e usa seus personagens e referências salvos.

https://mcp.mage.space/mcp

[!WARNING]

Toda geração que seu assistente iniciar é paga em Gems da sua conta. Seu assistente pode verificar o preço primeiro, e você pode desconectá-lo a qualquer momento.

Conecte seu assistente

Claude

Funciona no Claude na web, no aplicativo para desktop, nos aplicativos móveis e no Cowork.

1. Abra Conectar o Mage ao Claude. O nome e a URL do conector já vêm preenchidos. Selecione Add.
2. Selecione Connect. Uma página do Mage é aberta e pede que você entre, caso ainda não esteja conectado.
3. Verifique se a página informa o aplicativo que você está conectando e selecione Connect. Você retorna ao Claude.
4. Em um chat, ative o conector Mage no menu +, em Connectors, e peça o que você quer criar.

Em um plano Team ou Enterprise, um proprietário primeiro adiciona o conector em Organization settings → Connectors. O plano Free permite um conector personalizado.

ChatGPT

Adicione o Mage como um plugin pessoal na página Plugins do ChatGPT.

1. Abra ChatGPT Plugins.
2. Clique em Add e escolha Create MCP App.
3. Insira Mage em Name, https://mcp.mage.space/mcp em Server URL e selecione OAuth em Authentication. Deixe Advanced OAuth settings em branco; nenhum client ID ou client secret é necessário. O ícone e a descrição são opcionais.
4. Revise o aviso, marque I understand and want to continue e clique em Create.
5. Entre no Mage na página que abrir, verifique o nome do aplicativo e selecione Connect.
6. Instale o Mage nos seus plugins Personal, inicie um chat Work e mencione @Mage.

[!NOTE]

Se Create MCP App não aparecer, ative o Developer mode em Settings → Security and login do ChatGPT e volte para Plugins. Consulte o guia de configuração do ChatGPT para mais detalhes.

Claude Code

Adicione o servidor e depois entre pelo Claude Code:

claude mcp add --transport http mage https://mcp.mage.space/mcp

Execute /mcp no Claude Code, escolha mage e autentique-se. Uma página do navegador é aberta para você entrar no Mage e selecionar Connect.

Para usar uma chave de API em vez de entrar:

claude mcp add --transport http mage https://mcp.mage.space/mcp \
  --header "Authorization: Bearer $MAGE_API_KEY"

Grok

Adicione o Mage como um conector MCP personalizado.

1. Abra Conectores do Grok, selecione New Connector e escolha Custom.
2. Insira https://mcp.mage.space/mcp e conclua as solicitações de autenticação para conectar sua conta Mage.
3. Inicie uma conversa e peça ao Grok para usar o Mage para criar uma imagem, um vídeo ou um áudio.

No Grok Business ou Enterprise, um administrador da equipe precisa primeiro provisionar o conector no console da nuvem.

Cursor

O botão instala o Mage com seu client ID OAuth público; entre no Mage quando solicitado. Se o Mage já estiver instalado, substitua a configuração existente pela do link. Se o botão não fizer nada, abra o link de instalação web: ele abre o Cursor a partir do navegador e mostra a mesma configuração para adicionar manualmente.

Para configuração manual, adicione esta entrada em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mage": {
      "url": "https://mcp.mage.space/mcp",
      "auth": {
        "CLIENT_ID": "https://cursor.com/mcp",
        "scopes": [
          "mage",
          "offline_access"
        ]
      }
    }
  }
}

O client ID é público e não exige client secret. O Cursor usa configuração OAuth estática para abrir a página de consentimento do Mage.

Você também pode conectar com uma chave de API:

{
  "mcpServers": {
    "mage": {
      "url": "https://mcp.mage.space/mcp",
      "headers": { "Authorization": "Bearer ${env:MAGE_API_KEY}" }
    }
  }
}

Quando um aplicativo se conecta entrando na conta, o Mage mostra quem está pedindo antes de compartilhar qualquer coisa: o nome do aplicativo, o site de onde ele vem e para onde você retorna depois. Uma sessão de convidado não pode conectar um aplicativo; entre primeiro com sua conta Mage.

O que seu assistente pode fazer

Ferramenta	O que ela faz
list_models	Lista os modelos recomendados com seus preços, para que cada um é melhor e suas desvantagens; os demais sob solicitação.
get_model	Descreve um modelo: seus campos, valores permitidos, padrões, regras e preço.
estimate_cost	Calcula o preço de uma geração antes de iniciá-la. Nada é cobrado.
create_upload	Obtém um link assinado para enviar um arquivo do seu computador, para assistentes que conseguem executar comandos.
generate	Inicia uma geração, paga em Gems.
get_request	Aguarda a conclusão de uma geração e retorna o link do resultado.
cancel_request	Interrompe uma geração em andamento. Os Gems não são reembolsados.
get_account	Mostra a conta conectada e seu saldo de Gems.
list_characters	Lista seus personagens e seus @handles.
create_character	Salva um personagem privado a partir de um link de imagem, opcionalmente com um clipe de voz.
delete_character	Exclui um dos seus personagens.
list_references	Lista seus figurinos, poses, locais, objetos e clipes de voz, todos ou de um tipo.
create_reference	Salva uma referência privada a partir de um link de imagem ou áudio.
delete_reference	Exclui uma das suas referências.
list_history	Lista suas gerações dos últimos 30 dias, incluindo as que você mesmo fez no Mage.
search_creations	Pesquisa as criações que você salvou, pelo que elas mostram, por coleção ou por data.

Mencione um personagem ou referência salvo em uma solicitação com seu handle, por exemplo "Faça um retrato de @ana usando @red-coat", e seu assistente o repassa ao modelo.

Skills

As skills do Mage ensinam ao seu assistente trabalhos completos com base nessas ferramentas: ensaios fotográficos de produtos, anúncios em marketplaces, variações de anúncios, vídeos UGC e sem rosto, miniaturas do YouTube e os aplicativos do Mage, de trocas de rosto e reiluminação a edições de vídeo e sincronia labial. Adicione-as com npx skills add mage-space/skills, ou explore-as com exemplos em mage.space/skills.

Qual modelo seu assistente usa

A menos que você indique um modelo, seu assistente cria imagens com o Mango 3, vídeos com o Cherry 2 Pro e áudio com o Seed Audio. Ele informa o modelo e o preço antes de começar e, após um resultado, pode sugerir uma alternativa quando a desvantagem dela se encaixa no que você está fazendo.

	Imagens	Vídeo
Padrão	Mango 3	Cherry 2 Pro
Mesma família	Mango 3S (mais barato, até 3K), Mango 2 (até 4K), Mango	Cherry Pro (4K), Cherry, Cherry Mini (o Cherry mais barato)
Também recomendados	Guava 2 Pro e Guava 2 (fotorrealistas), GPT Image 2.5 Flare (texto e edições precisas)	Lemon (primeiro e último quadros, clipes de até 30 segundos)

Todos os outros modelos só são executados quando você os solicita pelo nome, por exemplo "faça com o Melon" ou "use o Nano Banana 2". Seu assistente pode sugerir um quando ele se adequar melhor a uma solicitação, como um modelo de anime para um clipe de anime, e aguarda sua resposta. Qual modelo devo usar? compara todos eles.

O Cherry 2 Pro é o modelo de vídeo mais capaz e mais caro do Mage, e seu preço sobe acentuadamente com a resolução e a duração. Peça o Cherry Mini ou o Lemon enquanto estiver rascunhando.

Como funcionam as gerações

1. Seu assistente escolhe um modelo com list_models, como acima, e lê seus campos com get_model.
2. Ele verifica o preço com estimate_cost, que também detecta uma solicitação que o modelo recusaria. O preço de um vídeo depende da sua duração: o Mage mede um vídeo que já está no Mage, como um arquivo enviado ou um resultado anterior, ao cotar o preço, e um vídeo vinculado de outro site apenas quando a geração começa.
3. Ele inicia a geração com generate, que cobra seus Gems. Cada geração carrega uma chave criada pelo seu assistente, de modo que uma nova tentativa após uma conexão interrompida retorna a mesma geração em vez de pagar duas vezes.
4. Ele aguarda com get_request até o resultado estar pronto e fornece o link a você.

Os resultados ficam disponíveis por 30 dias: baixe o que quiser manter ou salve no Mage. Um resultado sinalizado pela moderação como NSFW é marcado como tal. Consulte Requests para os estados pelos quais uma geração passa e Billing para saber como os Gems são cobrados.

Imagens e arquivos

Entradas de mídia, como um primeiro quadro, uma imagem de referência ou um vídeo a editar, são links: um link público https para o próprio arquivo, ou uma data URL de até cerca de 3 MB.

• Claude Code, Cursor e outros assistentes que executam comandos podem enviar um arquivo do seu computador: eles obtêm um link de upload assinado com create_upload, enviam o arquivo para ele e usam o novo link do arquivo como qualquer outro. Um arquivo pode ter até 100 MB e é excluído após 30 dias. Cada upload contém um arquivo: um arquivo corrigido sobe como um novo upload, já que o link antigo pode continuar mostrando o primeiro arquivo por até 4 horas.
• Chats do Claude, ChatGPT e Grok não conseguem repassar ao Mage um arquivo que você anexa ao chat. Compartilhe um link direto para o arquivo, ou use uma criação que já está no Mage.
• Um link para uma página da web, como um vídeo do YouTube ou do TikTok, não é um arquivo e é recusado.

Gerenciar aplicativos conectados

Todo aplicativo que você conectou aparece em MCP → Connected apps, com quando você o conectou e quando ele foi usado pela última vez. Selecione Disconnect para interromper um aplicativo imediatamente; ele não poderá mais usar sua conta nem gastar seus Gems até que você o conecte novamente. Abra MCP na navegação flutuante e selecione Connected apps.

Limites

• Até 20 gerações podem ser executadas ao mesmo tempo na sua conta, como na API.
• Um aplicativo pode fazer até 120 chamadas de ferramenta por minuto.
• get_request aguarda até 2 minutos por chamada; seu assistente a chama novamente para gerações mais longas.

Solução de problemas

• O Cursor diz "Incompatible auth server: does not support dynamic client registration": atualize a entrada existente do Mage em ~/.cursor/mcp.json para incluir o bloco auth da configuração do Cursor acima e reconecte. Apenas a URL do servidor não inclui o client ID do Cursor pré-registrado do Mage.

• "Couldn't reach the MCP server": verifique se a URL é exatamente https://mcp.mage.space/mcp e depois remova o conector e adicione-o novamente.

• A conexão pede que você entre novamente: a conexão dura até 180 dias, após os quais o aplicativo pede que você a aprove novamente. Desconectar no Mage também a encerra.

• Uma geração falhou com insufficient_gems: adicione Gems em API → Billing e tente novamente.

Esta documentação é criada e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.