본문으로 건너뛰기
PleumRouter
시작하기

MCP 서버

AI 도구 안에서 이미지·영상·음성 생성과 잔고·사용량 조회까지

PleumRouter 공식 MCP 서버를 MCP(Model Context Protocol)를 지원하는 AI 도구(예: Claude Code)에 연결하면, 코딩 중에 웹 대시보드로 이동하지 않고도 "남은 크레딧 얼마야?", "이 모델 단가는?", "이번 주 사용량은?"을 바로 물을 수 있고, "이 그림 그려줘", "짧은 영상 만들어줘", "이 문장 읽어줘" 까지 바로 생성할 수 있습니다.

MCP 서버란#

MCP는 AI 도구가 외부 서비스에 연결되는 표준 방식입니다. 이 서버는 상태를 저장하지 않는 스테이트리스 서버이며, 사용자의 API 키는 요청 시에만 사용되고 서버에 저장되지 않습니다. 생성된 이미지·영상·오디오는 안정 URL로 30일간 보관됩니다.

연결 방법#

https://mcp.pleum.ai/mcp

Claude Code에는 터미널에서 아래 명령으로 추가합니다.

bash
export PLEUM_API_KEY=plm_xxxxxxxxxxxxxxxx

claude mcp add --transport http pleum https://mcp.pleum.ai/mcp \
  --header "Authorization: Bearer $PLEUM_API_KEY"

다른 MCP 클라이언트는 설정의 mcpServers에 아래 항목을 추가합니다.

json
{
  "mcpServers": {
    "pleum": {
      "url": "https://mcp.pleum.ai/mcp",
      "headers": { "Authorization": "Bearer plm_xxxxxxxxxxxxxxxx" }
    }
  }
}
인증이 필요한 도구는 대시보드에서 발급한 API 키(plm_로 시작)를 Authorization: Bearer 헤더로 전달합니다. 키는 이 서버를 경유해 저장 없이 상류 API로 전달됩니다. 생성 도구(generate_*)는 사용량이 해당 키로 과금됩니다. generate_image와 generate_video는 enhance_prompt가 기본 켜져 있어 프롬프트 강화 1회(텍스트 토큰 단가)가 함께 청구되며, 끄려면 false를 넘기세요.

제공 도구#

아홉 개 도구를 제공합니다:

  • list_models — 모델 카탈로그 검색(공개, 인증 불필요)
  • get_model — 모델 단가 상세 — provider별 오퍼링·양자화 포함(공개)
  • estimate_cost — 토큰 수 기준 비용 추정(공개)
  • get_credits — 크레딧 잔액 조회 ( 필요)
  • get_usage — 기간별 사용 리포트 ( usage:read)
  • generate_image — 이미지 생성 — 결과를 30일 보관 안정 URL + 첫 장 인라인으로 반환 ( 필요)
  • generate_video — 영상 생성 잡 제출(비동기) — get_job으로 폴링 ( 필요)
  • get_job — 생성 잡(video/3D/음악) 상태·결과 조회 ( 필요)
  • generate_speech — 텍스트를 음성으로 변환(TTS) — 오디오 인라인 + 안정 URL 반환 ( 필요)

직접 호출#

MCP 클라이언트 없이 JSON-RPC로 직접 호출할 수도 있습니다 — 배치 스크립트·모니터링에 유용합니다.

bash
curl -X POST https://mcp.pleum.ai/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
        "protocolVersion":"2025-03-26","capabilities":{},
        "clientInfo":{"name":"curl","version":"0"}}}'
bash
export PLEUM_API_KEY=plm_xxxxxxxxxxxxxxxx

curl -X POST https://mcp.pleum.ai/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PLEUM_API_KEY" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
        "name":"get_credits","arguments":{}}}'
bash
curl -X POST https://mcp.pleum.ai/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PLEUM_API_KEY" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{
        "name":"generate_image","arguments":{
          "model":"seedream-5-0-260128",
          "prompt":"a neon-lit alley in the rain, cinematic"}}}'
이전터미널 CLI