MCP로 연결하기

Aether는 원격 Model Context Protocol(MCP) 서버를 제공합니다. Claude, Claude Code, Cursor, Antigravity, Codex, ChatGPT처럼 MCP를 지원하는 AI 어시스턴트가 이 서버로 Aether 계정의 이미지·이펙트·스프라이트 생성과 이미지 변환을 사용할 수 있습니다.

서버 주소

https://api.aetherforgeai.com/mcp

Streamable HTTP 전송 방식을 사용합니다.

Aether 계정으로 연결 (권장)

클라이언트에 서버 주소를 추가합니다. 처음 연결할 때 브라우저에서 Aether 연결 페이지가 열립니다.

1. 로그인하지 않았다면 Aether에 로그인합니다. 로그인 후 연결 페이지로 자동으로 돌아옵니다.
2. 클라이언트 이름과 돌아갈 주소를 확인합니다.
3. 연결을 선택합니다.

이후 클라이언트는 자체 액세스 토큰을 받습니다. 액세스 토큰은 1시간 후 만료되며 클라이언트가 자동으로 갱신합니다.

사용하는 클라이언트를 고르세요.

Claude Code

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

그다음 Claude Code에서 /mcp를 실행하고 aether를 선택하면 로그인이 시작됩니다.

Claude

Claude(웹·데스크톱)에서 설정 → 커넥터 → 커스텀 커넥터 추가를 열고 서버 주소를 입력한 뒤 추가를 선택합니다. 이어서 연결을 선택하면 로그인이 시작됩니다. Claude는 채팅에서 파일을 올릴 수 없으므로 이미지 입력에는 이전 결과의 job_id를 넘깁니다.

Cursor

mcp.json(설정 → MCP)에 서버를 추가합니다. 서버가 Needs login으로 표시되면 선택해 브라우저에서 로그인합니다.

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

Antigravity

Antigravity CLI에 서버를 등록하고 세션을 시작합니다. 서버를 처음 쓸 때 브라우저에서 로그인이 열립니다. 브라우저가 CLI로 돌아오지 못하면 CLI가 요청할 때 주소창의 최종 URL을 붙여 넣습니다.

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

Codex

서버를 등록하고 로그인합니다. 로그인은 브라우저에서 열립니다.

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

ChatGPT

ChatGPT에서 설정 → 커넥터 → 고급 → 개발자 모드를 열고 만들기를 선택합니다. 이름과 서버 주소를 입력하고 인증은 OAuth를 고른 뒤 만들기, 연결을 차례로 선택하면 로그인이 시작됩니다. ChatGPT는 채팅에서 파일을 올릴 수 없으므로 이미지 입력에는 이전 결과의 job_id를 넘깁니다.

API 키로 연결

사용자 지정 헤더를 보낼 수 있는 클라이언트는 로그인 대신 API 키를 사용할 수 있습니다. Claude와 ChatGPT 커넥터는 계정 로그인만 지원합니다.

Authorization: Bearer <api_key>

Claude Code

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

Cursor

mcp.json의 서버 항목에 headers를 추가합니다.

{
  "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는 환경 변수에서 키를 읽습니다.

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

도구

모든 도구는 웹 앱의 해당 페이지와 같은 옵션과 크레딧 비용을 사용합니다.

도구	웹 기능	크레딧 비용
create_image_upload	다른 도구에 쓸 이미지 업로드	무료
get_job_status	작업 상태와 결과 URL	무료
get_credit	크레딧 잔액	무료
list_my_ai_models	에테르 생성에 쓸 수 있는 모델	무료
list_my_results	히스토리 (tool, sprite, aether)	무료
generate_image	이미지 생성	1 (GPT Image 2), 2 (GPT Image 2.5 High, Nano Banana Pro), 3 (GPT Image 2.5 XHigh)
generate_effect_v1	이펙트 생성 V1 탭	5 (1K), 7 (2K), 10 (4K)
generate_effect_v2	이펙트 생성 V2 탭	3
upscale	업스케일	5 (1K), 7 (2K), 10 (4K)
inpaint_v1	인페인트 V1 탭	5
inpaint_v2	인페인트 V2 탭	3
remove_background	배경 제거	1
equip_variation	장비 베리에이션	5
sprite_lite	Sprite Lite	프레임 수에 따라 5~13
sprite_plus	Sprite Plus	9 (49프레임), 13 (81프레임)
sprite_zenith	Sprite Zenith	9 (36프레임), 25 (100프레임)
sprite_pulsar	Sprite Pulsar	3, Sprite To Sprite는 4
aether_generate	에테르	포함 모델은 무료, 그 외 2. 모델별 비용은 list_my_ai_models의 credit_cost

필드 이름과 허용값은 해당 엔드포인트 페이지와 같습니다.

결과 받기

생성 도구는 비동기 작업을 시작하고 즉시 job_id를 반환합니다. 그 job_id로 get_job_status를 호출해 결과를 받습니다. wait_seconds(최대 60)를 지정하면 도구가 반환하기 전에 작업 완료를 기다립니다. status가 Succeed이면 image_urls에 결과 이미지가, 스프라이트는 GIF도 함께 들어 있습니다. 상태 값은 비동기 작업 라이프사이클을 참고하세요.

generate_image는 웹 히스토리 페이지에 채팅방도 하나 만들며, API/MCP 탭에 표시됩니다. 결과의 chat_room_id가 그 방이고, 웹에서 그 방을 열어 이어서 생성할 수 있습니다.

이미지 입력

이미지 필드에는 다음 중 하나를 넣습니다.

• create_image_upload로 받은 upload_id. 이미지의 Content-Type으로 도구를 호출하고, 반환된 upload_url에 5분 안에 HTTP PUT으로 파일을 올린 뒤 upload_id를 넘깁니다.
• 완료된 내 작업의 job_id. 그 결과 이미지를 그대로 씁니다. 예를 들어 upscale 후 remove_background처럼 도구를 이어서 쓸 수 있습니다.

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

업로드는 Claude Code, Cursor, Antigravity, Codex처럼 명령을 실행하거나 HTTP 요청을 보낼 수 있는 클라이언트에서만 가능합니다. 파일을 올릴 수 없는 채팅 앱에서는 완료된 job_id를 대신 사용합니다.

오류

도구 호출이 실패하면 결과 대신 오류 메시지를 반환합니다. 크레딧이 부족하면 메시지에 요금제 페이지 링크가 포함됩니다.