MCP 서버
Model Context Protocol을 통해 Claude Code, Cursor, VS Code와 같은 AI 어시스턴트 및 코딩 에이전트에서 MLMux를 사용하세요. 모델 목록 조회, 비용 예측, 이미지 생성 및 비디오 생성이 가능합니다.
엔드포인트 및 인증
MLMux MCP 서버는 Streamable HTTP 전송을 지원하는 원격 서버입니다. 다음 URL을 클라이언트에 추가하세요:
https://www.mlmux.com/api/mcpAuthorization: Bearer 헤더에 MLMux API 키를 포함하여 인증하세요. 키는 API 키에서 생성할 수 있습니다. 서버는 호출마다 키를 MLMux API로 전달하며 키를 저장하지 않습니다. 키가 없으면 list_models 및 estimate_cost만 작동합니다.
클라이언트 연결
사용할 클라이언트를 선택하고 서버를 추가하세요. 각 예시는 환경 변수에서 키를 읽거나 입력을 요청하므로, 공유될 수 있는 구성 파일에 키가 직접 노출되지 않습니다.
claude mcp add --transport http mlmux https://www.mlmux.com/api/mcp \
--header "Authorization: Bearer $MLMUX_API_KEY"먼저 셸에서 MLMUX_API_KEY를 설정한 후 명령을 한 번 실행하세요.
사용자 지정 헤더와 함께 Streamable HTTP를 통한 원격 MCP 서버를 지원하는 모든 클라이언트에서 동일한 방식으로 작동합니다.
도구
서버는 7개의 도구를 제공합니다. 클라이언트는 이 도구들을 어시스턴트에 표시하며, 어시스턴트는 사용자의 요청에 따라 적절한 도구를 선택합니다.
| 도구 | API 키 | 설명 |
|---|---|---|
list_models | 불필요 | 이미지 및 비디오 모델 목록을 각 경로(route)의 모델 ID, 작업, 크기 및 예상 가격과 함께 반환합니다. |
estimate_cost | 불필요 | 가격 계산기와 동일한 가격을 기준으로 두 경로 모두에서 여러 이미지 또는 비디오 클립의 예상 비용을 계산합니다. |
generate_image | 필수 | 프롬프트로부터 이미지를 생성하고 해당 URL을 반환합니다. 잔액에서 차감됩니다. |
edit_image | 필수 | 프롬프트와 함께 참조 이미지(공개 URL)를 편집하거나 결합하고 새 이미지 URL을 반환합니다. 잔액에서 차감됩니다. |
create_video | 필수 | Seedance 비디오 작업(텍스트 투 비디오, 이미지 투 비디오 또는 첫 프레임 및 마지막 프레임)을 시작하고 작업 ID를 반환합니다. 비디오가 성공적으로 생성되면 잔액에서 차감됩니다. |
get_task | 필수 | 작업 상태를 반환하며, 성공한 경우 출력 URL 및 청구된 금액을 반환합니다. |
get_balance | 필수 | 크레딧 잔액을 반환합니다. |
요금 청구
generate_image, edit_image 및 create_video는 동일한 API 요청과 마찬가지로 요금 페이지의 요율에 따라 청구됩니다: 1 크레딧 = 1 USD이며, 실패한 요청에는 비용이 청구되지 않습니다. 대부분의 클라이언트는 실행 전에 도구 호출 승인을 요청합니다. 비용이 중요한 경우 어시스턴트에게 estimate_cost를 먼저 실행하도록 요청하세요.
제한 사항
- 이미지 도구는 결과를 최대 약 4분 동안 대기합니다. 처리 시간이 더 오래 걸리는 이미지는 작업 ID를 반환하므로, 나중에
get_task를 요청하여 가져올 수 있습니다. create_video는 작업 ID와 함께 즉시 반환됩니다. 이후 어시스턴트가 비디오가 준비될 때까지get_task를 호출합니다.- MCP를 통한 요청은 계정의 동시 실행 작업 제한 수인 60개에 포함됩니다.
- OAuth 로그인은 아직 지원되지 않으므로 claude.ai 및 ChatGPT 웹 앱처럼 OAuth가 필요한 커넥터는 현재 연결할 수 없습니다. 사용자 지정 헤더를 허용하는 클라이언트는 바로 사용할 수 있습니다.