APIMart MCP

npx add-mcp 'https://mcp.apimart.ai/mcp'

agent — APIMart task 시뮬레이션 데모

“제품 메인 이미지에 적합한 모델을 찾아서 향수 광고 이미지를 생성하고, 작업 결과를 알려주세요.”

1. 01 요구사항 이해 이미지 생성 작업 식별
2. 02 모델 선택 성능과 파라미터 비교
3. 03 작업 제출 APIMart API 호출
4. 04 결과 반환 상태와 파일 획득

작업 완료 예시

Agent가 모델 문서에 따라 파라미터를 준비하고 작업을 제출한 뒤 결과를 가져옵니다. 여기서는 흐름만 보여주며, 요청을 보내지 않고 할당량을 소모하지 않습니다. 더 많은 대화 예시 보기

APIMart MCP의 list_models를 사용하여 5개의 사용 가능한 모델을 나열하고, 콘텐츠를 생성하지 마세요.

→ APIMart / list_models
  {"limit": 5}

模型展示名称（示例，非 API 模型 ID）：
01  GPT Image 2.5
02  Nano Banana Pro
03  Seedream 5.0 Pro
04  Z-Image Turbo
05  Midjourney

✓ 示例数据。实际数量与模型 ID 以当前 Key 的返回结果为准。

세 가지 방식, 필요에 따라 연동

사용 습관에 따라 문서, 원격 도구 또는 로컬 스킬을 선택하세요. 지원되는 구체적인 작업은 해당 인터페이스, 도구 및 클라이언트에 따라 달라집니다.

단계별로 연동 완료하기

한 가지 방식을 선택하고 단계에 따라 구성을 완료하세요. 명령어는 바로 복사할 수 있으며, 테스트 프롬프트도 준비되어 있습니다.

APIMart Agent Tools

macOS · zsh · Codex 데스크톱 · 프로덕션 환경

API Key 안전하게 설정하기

프로덕션 환경에서 사용 가능

먼저 APIMart에서 유효한 API Key를 생성한 뒤, macOS의 zsh 터미널에서 아래 명령어를 실행하고 안내에 따라 Key를 숨김 입력하세요.

API Key 받기

터미널 명령어

read -s "APIMART_API_KEY?APIMart API Key: "
echo
launchctl setenv APIMART_API_KEY "$APIMART_API_KEY"
unset APIMART_API_KEY

실제 Key는 터미널에서 입력하라는 메시지가 표시될 때만 붙여넣으세요. 명령어, 채팅 또는 스크린샷에 작성하지 마세요. 유출된 Key는 폐기한 후 다시 생성하세요.

추가 설명 및 적용 범위

이 구성은 현재 로그인 세션에서 다시 시작되는 데스크톱 앱에 적용됩니다. 설정을 완료한 후 Codex 데스크톱을 완전히 종료하고 다시 열어주세요. 터미널 버전을 사용하는 경우, Key를 숨김 입력한 후 export APIMART_API_KEY를 실행하고 동일한 터미널에서 Codex를 시작하세요. 여기의 unset은 실행하지 마세요. 아래는 키 형식 예시일 뿐이며, 실행하거나 교체할 필요가 없습니다.

키 형식 예시 · 실행 불필요 sk-••••••••••••••••

선택 기준은 사용 습관에 따라 다릅니다

빠른 문서 조회는 AI 문서, 일상적인 도구 호출은 MCP, 로컬 스크립트와 고정된 흐름이 필요하면 Skill을 선택하세요.

연동 방식	가장 적합한 경우	설치 및 구성	기능 실행 위치	주요 장점	주의 사항	빠른 시작
AI 문서 llms.txt	임시 조회, 호출 코드 생성	설치 불필요, 프롬프트 복사	Agent가 문서를 읽고 코드 실행	가볍게 시작, 인터페이스 유연 호출	웹 읽기 기능 필요, 코드 실행 시 자격 증명 필요	연동 단계 보기
MCP 추천	고빈도 상호작용, 일상 창작	원격 서비스와 Key 구성	APIMart 원격 MCP	구조화된 도구, 로컬 MCP 패키지 불필요	네트워크와 클라이언트 지원에 의존, 제공된 도구로 제한	연동 단계 보기
Agent Skill 로컬 스킬 패키지	고정된 흐름, 팀 표준화	GitHub을 통해 전체 디렉터리 설치	로컬 스크립트가 APIMart API 호출	흐름 재사용 가능, MCP와 독립적	Node.js 필요, 업데이트 시 재설치 필요할 수 있음	연동 단계 보기

Agent가 도와줄 수 있는 작업

모델 발견, 문서 이해, 일반적인 이미지 및 비디오 작업을 중심으로 합니다. 사용 전에 선택한 모델, 도구 또는 로컬 클라이언트가 해당 작업을 지원하는지 확인하세요.

모델 발견

작업 목표에 따라 사용 가능한 모델을 찾고, 현재 요구사항에 적합한 성능과 버전을 확인합니다.

파라미터 및 문서

입력 파라미터, 사용 설명 및 제한 조건을 읽고 모델의 호출 방식을 이해합니다.

이미지 생성

모델 선택, 파라미터 준비, 작업 제출, 상태 조회 및 결과 획득을 완료합니다.

비디오 생성

비디오 모델을 호출하여 작업 진행률, 실행 상태 및 최종 결과를 지속적으로 가져옵니다.

API Key는 설치 명령어에 포함되지 않습니다

환경 변수를 통해 자격 증명을 전달하여 Key가 터미널 기록, 스크린샷 또는 채팅 기록에 우연히 저장될 위험을 줄입니다.

• 문서를 먼저 읽고 자격 증명을 구성하세요 AI 문서는 Agent가 인터페이스를 이해하도록 돕고, 자동으로 모델 호출을 시작하지 않습니다.
• 환경 변수로 읽기 MCP와 Skill은 환경 변수에서 Key를 읽습니다. Key를 프롬프트나 설치 명령어에 작성하지 마세요.
• 모델 조회로 연결을 먼저 검증하세요 실제 생성은 APIMart 계정 규칙에 따라 과금됩니다. 연동 후 모델 조회로 구성을 먼저 검증하세요.

자주 묻는 질문

한 가지 방식을 선택하고 시작하세요

MCP와 Skill은 독립적으로 사용할 수 있습니다. AI 문서는 설치가 필요 없으며 프롬프트를 바로 복사할 수 있습니다.