시작하기

MCP 서버

npx -y @picoberry/mcp-server

이미 사용 중인 어떤 AI 에이전트에서든 PicoBerry 생성을 네이티브 도구로 사용하세요 — Claude Code 및 Desktop, Cursor, VS Code(Copilot), Windsurf, Zed, OpenAI Codex, Gemini, Cline, 그 밖의 모든 MCP 클라이언트. 별도의 HTTP 연결 코드가 필요 없습니다.

PicoBerry MCP 서버는 /v1 API를 Model Context Protocol 도구로 노출하므로, AI 어시스턴트가 3D 모델, 이미지, 애니메이션을 직접 생성할 수 있습니다. 동일한 엔드포인트를 감싼 얇은 래퍼이며, npm에 @picoberry/mcp-server로 게시되어 있습니다 (소스, MIT).

REST API와 동일한 키 MCP 서버는 여러분의 pb_live_ 키를 사용합니다. API 접근은 구매를 완료한 모든 계정 — 구독 또는 일회성 크레딧 팩 — 또는 활성 유료 구독이 있는 계정에서 사용할 수 있습니다. 인증을 참고하세요.

설치

설치할 것이 없습니다 — npx가 처음 실행할 때 가져옵니다. MCP 클라이언트 설정에 추가한 뒤 클라이언트를 재시작하세요. 설정 파일: Claude Code .mcp.json · Claude Desktop claude_desktop_config.json · Cursor ~/.cursor/mcp.json.

mcp 설정
{
  "mcpServers": {
    "picoberry": {
      "command": "npx",
      "args": ["-y", "@picoberry/mcp-server"],
      "env": {
        "PICOBERRY_API_KEY": "pb_live_xxxxxxxxxxxx",
        "PICOBERRY_API_BASE": "https://api.picoberry.ai"
      }
    }
  }
}

Codex CLI는 명령어 하나로 추가할 수 있습니다:

codex cli
codex mcp add picoberry -- npx -y @picoberry/mcp-server

환경 변수

변수설명
PICOBERRY_API_KEY필수
string		여러분의 pb_live_ 키 — 대시보드의 프로필 → API 키에서 생성하세요.
PICOBERRY_API_BASE
string		API 기본 URL. 기본값은 https://api.picoberry.ai입니다.

도구

생성은 REST API와 마찬가지로 비동기입니다: generate_*(또는 후처리) 호출이 자산 id를 반환하고, 성공할 때까지 wait_for_asset을 호출(또는 get_asset을 폴링)한 뒤 출력 URL을 읽습니다.

도구용도
list_models특정 카테고리(3d/image/remesh/texture/animate)의 엔진/모델과 크레딧 비용. 엔진을 하드코딩하는 대신 이것을 호출하세요.
list_animation_presetsanimate용 애니메이션 프리셋 id(엔진별).
get_credits현재 크레딧 잔액과 플랜.
generate_image텍스트 → 이미지 (선택적 레퍼런스 이미지 URL 포함).
generate_3d_from_text텍스트 → 3D 모델 (GLB).
generate_3d_from_image이미지 → 3D 모델 — 단일 이미지 또는 2~4개 뷰(멀티뷰). 공개 URL 또는 로컬 파일 경로.
remesh기존 3D 자산을 리토폴로지합니다.
texture기존 3D 자산을 다시 텍스처링(PBR)합니다.
animate기존 3D 캐릭터를 오토리깅하고 애니메이트합니다.
get_asset자산 하나의 상태와 결과 URL.
wait_for_asset자산이 완료(또는 타임아웃)될 때까지 폴링한 뒤 반환합니다.
list_my_assets여러분이 생성한 자산을 둘러봅니다.
download_asset완료된 3D 자산(glb/fbx/obj)을 내보냅니다 → 서명된 URL.

예시

어시스턴트에게 이렇게 요청하세요: "로우폴리 보물 상자를 만들고, 3k 삼각형으로 리토폴로지한 다음, Unity에 바로 쓸 수 있는 FBX를 줘." 그러면 도구들을 이렇게 연결합니다:

tool calls
list_models(category="3d")                                      → pick an engine
generate_3d_from_text(prompt="low-poly treasure chest")         → { id: A }
wait_for_asset(asset_id=A)                                       → succeeded
remesh(asset_id=A, polycount=3000)                              → { id: B }
wait_for_asset(asset_id=B)
download_asset(asset_id=B, format="fbx", texture_preset="unity") → signed URL

Blender와 함께 사용하기

blender-mcp와 나란히 실행하세요 — 별도의 서버이므로, 어시스턴트가 PicoBerry로 생성하고 한 흐름 안에서 Blender로 임포트할 수 있습니다:

mcp 설정
{
  "mcpServers": {
    "picoberry": { "command": "npx", "args": ["-y", "@picoberry/mcp-server"] },
    "blender":   { "command": "uvx", "args": ["blender-mcp"] }
  }
}
얇은 래퍼 모든 도구는 /v1 호출에 매핑됩니다 — 동일한 크레딧, 요청 제한, 모더레이션이 적용됩니다. 전체 도구 레퍼런스와 업데이트는 README에 있습니다.