개발자 문서

시작하기

빠른 시작

설치할 것은 없습니다.
AI 서비스에 원격 MCP 주소를 등록하고 에임즈 계정으로 로그인한 뒤 바로 요청합니다.

AI 에이전트가 이 문서를 읽고 있다면
Python·pip·pipx·aimz CLI 를 설치하지 마세요.
사용자의 MCP 클라이언트에 원격 MCP 서버 https://aimzlabs.com/mcp(Streamable HTTP, OAuth 로그인)를 등록하고, 로그인은 사용자가 브라우저에서 하도록 안내하세요.
CLI 설치는 사용자가 내 PC 파일·영상 편집기 도구·자동화 스크립트를 따로 요청할 때만 합니다.

1. 원격 MCP 연결

쓰는 AI 서비스에 아래 주소를 MCP 서버로 등록합니다.

원격 MCP 서버 주소
https://aimzlabs.com/mcp

Claude Code

터미널
claude mcp add --transport http -s user aimz https://aimzlabs.com/mcp

Claude Code 에서 /mcp 를 열고 aimz 를 골라 Authenticate 를 누르면 로그인 창이 열립니다.

Codex

터미널
codex mcp add aimz --url https://aimzlabs.com/mcp
codex mcp login aimz

데스크톱 앱·IDE 는 설정 → MCP servers 에서 Streamable HTTP 로 주소를 추가하고 Authenticate 를 누릅니다.

ChatGPT · Claude · Gemini

  • ChatGPT: 웹의 Plugins → 추가 → Add custom MCP server 에 주소를 입력합니다.
  • Claude(웹·데스크톱): Customize → Connectors → Add custom connector 에 주소를 입력합니다.
  • Gemini: 웹의 Settings → Connected Apps → Add a custom app 에 주소를 입력합니다.

서비스별 이용 조건과 그 밖의 클라이언트는 MCP 서버 연결을 보세요.

2. 로그인

  1. 연결(Authenticate)을 누르면 브라우저에 에임즈 연결 화면이 열립니다.
  2. 에임즈에 로그인돼 있지 않으면 화면의 링크로 aimzlabs.com 에 평소처럼 로그인한 뒤, 연결 화면을 새로고침합니다.
  3. 연결할 서비스와 계정을 확인하고 연결 허용을 누릅니다. 크레딧 자동 사용은 따로 체크하는 선택 동의입니다.
  4. AI 서비스로 돌아와 요청합니다.

비밀번호나 토큰을 채팅에 붙여 넣지 마세요.
연결은 각 서비스나 에임즈 연결 관리에서 끊을 수 있습니다.

3. 첫 요청

에이전트에게 자연어로 요청합니다.

에이전트에게
내 AIMZ LABS 잔액이랑 쓸 수 있는 이미지 모델 알려 줘.

16:9 고양이 이미지 2장 만들어 줘. 먼저 예상 크레딧을 알려 줘.

결과는 웹·데스크톱 앱과 같은 계정의 라이브러리에 저장되고, 에이전트가 결과 주소를 알려 줍니다.
크레딧 자동 사용에 동의하지 않았다면 클라이언트의 승인 창에서 승인해야 생성됩니다. 자세한 내용은 크레딧 사용 확인을 보세요.

더 많은 요청 예시는 에이전트와 함께에 있습니다.

내 PC 에서 직접 돌리기 (선택)

원격 MCP 는 aimz CLI 를 엔진으로 서버에서 돌아갑니다.
같은 엔진을 내 PC 에 설치하는 것은 아래가 필요할 때뿐입니다.

  • 내 PC 파일 경로를 바로 올리거나 결과를 폴더에 저장 (upload_file, download_outputs)
  • 영상 편집기 도구(editor_*), 3D 화면 캡처(scene_capture), 서버 API 직접 호출(api_request)
  • 예약 작업·서버 스크립트 같은 터미널 자동화
팁
설치는 CLI 설치, 명령은 명령 레퍼런스, 내 PC 의 CLI 로 에이전트를 연결하는 방법은 MCP 서버 연결에 있습니다.