Conectar com MCP

O Aether oferece um servidor remoto de Model Context Protocol (MCP). Assistentes de IA compatíveis com MCP, como Claude, Claude Code, Cursor, Antigravity, Codex e ChatGPT, podem usá-lo para gerar imagens, efeitos e sprites e para ajustar imagens com sua conta do Aether.

URL do servidor

https://api.aetherforgeai.com/mcp

O servidor usa o transporte Streamable HTTP.

Conectar com sua conta do Aether (recomendado)

Adicione a URL do servidor ao seu cliente. Na primeira conexão, o navegador abre a página de conexão do Aether.

1. Faça login no Aether se ainda não tiver feito. Você volta para a página de conexão automaticamente.
2. Confira o nome do cliente e o endereço para onde você será enviado de volta.
3. Selecione Conectar.

Depois disso, o cliente recebe o próprio token de acesso. Os tokens de acesso expiram após uma hora e o cliente os renova automaticamente.

Escolha seu cliente:

Claude Code

claude mcp add --transport http aether https://api.aetherforgeai.com/mcp

Depois execute /mcp no Claude Code e escolha aether para iniciar o login.

Claude

No Claude (web e desktop), abra Configurações → Conectores → Adicionar conector personalizado, informe a URL do servidor e selecione Adicionar. Em seguida selecione Conectar para iniciar o login. O Claude não consegue enviar arquivos pelo chat, então passe o job_id de um resultado anterior nas entradas de imagem.

Cursor

Adicione o servidor ao mcp.json (Configurações → MCP). Quando o servidor mostrar Needs login, selecione-o para fazer login no navegador.

{
  "mcpServers": {
    "aether": {
      "url": "https://api.aetherforgeai.com/mcp"
    }
  }
}

Antigravity

Registre o servidor na CLI do Antigravity e inicie uma sessão. O login abre no navegador na primeira vez que o servidor é usado. Se o navegador não conseguir voltar para a CLI, cole a URL final da barra de endereços quando a CLI pedir.

agy mcp add aether https://api.aetherforgeai.com/mcp
agy

Codex

Registre o servidor e faça login. O login abre no navegador.

codex mcp add aether --url https://api.aetherforgeai.com/mcp
codex mcp login aether

ChatGPT

No ChatGPT, abra Configurações → Conectores → Avançado → Modo desenvolvedor e selecione Criar. Informe um nome e a URL do servidor, escolha OAuth como autenticação e depois selecione Criar e Conectar para iniciar o login. O ChatGPT não consegue enviar arquivos pelo chat, então passe o job_id de um resultado anterior nas entradas de imagem.

Conectar com uma chave de API

Clientes que podem enviar cabeçalhos personalizados podem usar uma chave de API em vez de fazer login. Os conectores do Claude e do ChatGPT só aceitam login com conta.

Authorization: Bearer <api_key>

Claude Code

claude mcp add --transport http aether https://api.aetherforgeai.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Adicione uma entrada headers ao servidor no mcp.json.

{
  "mcpServers": {
    "aether": {
      "url": "https://api.aetherforgeai.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Antigravity

agy mcp add --header "Authorization: Bearer YOUR_API_KEY" aether https://api.aetherforgeai.com/mcp

Codex

O Codex lê a chave de uma variável de ambiente.

export AETHER_API_KEY=YOUR_API_KEY
codex mcp add aether --url https://api.aetherforgeai.com/mcp --bearer-token-env-var AETHER_API_KEY

Ferramentas

Cada ferramenta usa as mesmas opções e o mesmo custo em créditos da página correspondente no aplicativo web.

Ferramenta	Recurso na web	Custo em créditos
create_image_upload	Enviar uma imagem para outras ferramentas	Grátis
get_job_status	Status do job e URLs dos resultados	Grátis
get_credit	Saldo de créditos	Grátis
list_my_ai_models	Modelos disponíveis para a geração Aether	Grátis
list_my_results	Histórico (tool, sprite, aether)	Grátis
generate_image	Gerar imagem	1 (GPT Image 2), 2 (GPT Image 2.5 High, Nano Banana Pro), 3 (GPT Image 2.5 XHigh)
generate_effect_v1	Gerar efeitos, aba V1	5 (1K), 7 (2K), 10 (4K)
generate_effect_v2	Gerar efeitos, aba V2	3
upscale	Upscale	5 (1K), 7 (2K), 10 (4K)
inpaint_v1	Inpaint, aba V1	5
inpaint_v2	Inpaint, aba V2	3
remove_background	Remover fundo	1
equip_variation	Variação de equipamento	5
sprite_lite	Sprite Lite	De 5 a 13 conforme os quadros
sprite_plus	Sprite Plus	9 (49 quadros), 13 (81 quadros)
sprite_zenith	Sprite Zenith	9 (36 quadros), 25 (100 quadros)
sprite_pulsar	Sprite Pulsar	3, ou 4 para Sprite To Sprite
aether_generate	Aether	Grátis para os modelos incluídos; os demais, 2. list_my_ai_models mostra credit_cost por modelo

Os nomes dos campos e os valores permitidos são os mesmos das páginas de endpoints correspondentes.

Resultados

As ferramentas de geração iniciam um job assíncrono e retornam um job_id imediatamente. Chame get_job_status com esse job_id para obter o resultado. Defina wait_seconds (até 60) para aguardar o job antes de a ferramenta responder. Quando status for Succeed, image_urls contém a imagem resultante e, para sprites, também o GIF. Consulte Ciclo de vida de jobs assíncronos para ver os valores de status.

generate_image também cria uma sala de chat na página Histórico da web, listada na aba API/MCP. O chat_room_id do resultado a identifica, e você pode continuar gerando nessa sala pela web.

Imagens de entrada

Os campos de imagem aceitam uma destas opções:

• Um upload_id de create_image_upload. Chame a ferramenta com o Content-Type da imagem, envie o arquivo para a upload_url retornada com uma requisição HTTP PUT em até 5 minutos e depois passe o upload_id.
• O job_id de um dos seus jobs concluídos, para reutilizar a imagem resultante. Assim você pode encadear ferramentas, por exemplo upscale e depois remove_background.

curl -X PUT -H "Content-Type: image/png" --data-binary @character.png "<upload_url>"

O envio exige um cliente que possa executar comandos ou enviar requisições HTTP, como Claude Code, Cursor, Antigravity ou Codex. Em aplicativos de chat que não conseguem enviar arquivos, reutilize um job_id concluído.

Erros

Quando uma chamada de ferramenta falha, ela retorna uma mensagem de erro em vez de um resultado. Se você não tiver créditos suficientes, a mensagem inclui um link para a página de preços.