Terhubung dengan MCP

Aether menyediakan server Model Context Protocol (MCP) jarak jauh. Asisten AI yang mendukung MCP, seperti Claude, Claude Code, Cursor, Antigravity, Codex, dan ChatGPT, dapat memakainya untuk membuat gambar, efek, dan sprite serta menyesuaikan gambar dengan akun Aether Anda.

URL server

https://api.aetherforgeai.com/mcp

Server menggunakan transport Streamable HTTP.

Terhubung dengan akun Aether (disarankan)

Tambahkan URL server ke klien Anda. Saat klien pertama kali terhubung, browser Anda membuka halaman koneksi Aether.

1. Masuk ke Aether jika belum. Anda akan kembali ke halaman koneksi secara otomatis.
2. Periksa nama klien dan alamat tujuan Anda dikembalikan.
3. Pilih Hubungkan.

Setelah itu klien menerima token akses sendiri. Token akses kedaluwarsa setelah satu jam dan klien memperbaruinya secara otomatis.

Pilih klien Anda:

Claude Code

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

Lalu jalankan /mcp di Claude Code dan pilih aether untuk mulai masuk.

Claude

Di Claude (web dan desktop), buka Settings → Connectors → Add custom connector, masukkan URL server, lalu pilih Add. Kemudian pilih Connect untuk mulai masuk. Claude tidak bisa mengunggah file dari obrolan, jadi berikan job_id dari hasil sebelumnya ke input gambar.

Cursor

Tambahkan server ke mcp.json (Settings → MCP). Saat server menampilkan Needs login, pilih server itu untuk masuk lewat browser.

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

Antigravity

Daftarkan server di Antigravity CLI dan mulai sesi. Proses masuk terbuka di browser saat server pertama kali dipakai. Jika browser tidak bisa kembali ke CLI, tempel URL akhir dari bilah alamat saat CLI memintanya.

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

Codex

Daftarkan server lalu masuk. Proses masuk terbuka di browser.

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

ChatGPT

Di ChatGPT, buka Settings → Connectors → Advanced → Developer mode lalu pilih Create. Masukkan nama dan URL server, pilih OAuth untuk autentikasi, lalu pilih Create dan Connect untuk mulai masuk. ChatGPT tidak bisa mengunggah file dari obrolan, jadi berikan job_id dari hasil sebelumnya ke input gambar.

Terhubung dengan kunci API

Klien yang dapat mengirim header kustom dapat menggunakan kunci API sebagai pengganti masuk. Konektor Claude dan ChatGPT hanya mendukung masuk dengan akun.

Authorization: Bearer <api_key>

Claude Code

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

Cursor

Tambahkan entri headers ke server di 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

Codex membaca kunci dari variabel lingkungan.

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

Alat

Setiap alat menggunakan opsi dan biaya kredit yang sama dengan halaman terkait di aplikasi web.

Alat	Fitur web	Biaya kredit
create_image_upload	Unggah gambar untuk alat lain	Gratis
get_job_status	Status job dan URL hasil	Gratis
get_credit	Saldo kredit	Gratis
list_my_ai_models	Model yang tersedia untuk pembuatan Aether	Gratis
list_my_results	Riwayat (tool, sprite, aether)	Gratis
generate_image	Buat gambar	1 (GPT Image 2), 2 (GPT Image 2.5 High, Nano Banana Pro), 3 (GPT Image 2.5 XHigh)
generate_effect_v1	Buat efek, tab V1	5 (1K), 7 (2K), 10 (4K)
generate_effect_v2	Buat efek, tab V2	3
upscale	Upscale	5 (1K), 7 (2K), 10 (4K)
inpaint_v1	Inpaint, tab V1	5
inpaint_v2	Inpaint, tab V2	3
remove_background	Hapus latar	1
equip_variation	Variasi perlengkapan	5
sprite_lite	Sprite Lite	5 sampai 13 sesuai jumlah frame
sprite_plus	Sprite Plus	9 (49 frame), 13 (81 frame)
sprite_zenith	Sprite Zenith	9 (36 frame), 25 (100 frame)
sprite_pulsar	Sprite Pulsar	3, atau 4 untuk Sprite To Sprite
aether_generate	Aether	Gratis untuk model yang termasuk, lainnya 2. list_my_ai_models menampilkan credit_cost per model

Nama field dan nilai yang diizinkan sama dengan halaman endpoint terkait.

Hasil

Alat pembuatan memulai job asinkron dan langsung mengembalikan job_id. Panggil get_job_status dengan job_id tersebut untuk mendapatkan hasil. Atur wait_seconds (hingga 60) untuk menunggu job sebelum alat mengembalikan respons. Saat status bernilai Succeed, image_urls berisi gambar hasil, dan untuk sprite juga GIF. Lihat Siklus hidup job asinkron untuk nilai status.

generate_image juga membuat ruang obrolan di halaman Riwayat web, yang tampil di tab API/MCP. chat_room_id pada hasil adalah ruang tersebut, dan Anda bisa melanjutkan pembuatan di ruang itu lewat web.

Gambar input

Field gambar menerima salah satu dari berikut:

• upload_id dari create_image_upload. Panggil alat dengan Content-Type gambar, unggah file ke upload_url yang dikembalikan dengan HTTP PUT dalam 5 menit, lalu kirim upload_id.
• job_id dari job Anda yang sudah selesai, untuk memakai ulang gambar hasilnya. Dengan begitu Anda dapat merangkai alat, misalnya upscale lalu remove_background.

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

Mengunggah memerlukan klien yang bisa menjalankan perintah atau mengirim permintaan HTTP, seperti Claude Code, Cursor, Antigravity, atau Codex. Di aplikasi obrolan yang tidak bisa mengunggah file, gunakan kembali job_id yang sudah selesai.

Error

Jika panggilan alat gagal, alat mengembalikan pesan error, bukan hasil. Jika kredit Anda tidak cukup, pesan tersebut menyertakan tautan ke halaman harga.