가이드 / MCP 통합

MCP 클라이언트를 TO3D에 연결

라이브 v2 HTTP 엔드포인트를 사용해 MCP 클라이언트에서 TO3D 도구를 검색하세요. 이 가이드는 엔드포인트와 읽기 전용 검색 증거를 기록하며 모든 클라이언트 테스트나 MCP 자동 리깅을 주장하지 않습니다.

2026년 9월 27일 확인

라이브 엔드포인트 연결

클라이언트에 https://mcp.to3d.app/v2/mcp를 설정하세요. OAuth 클라이언트는 TO3D WorkOS AuthKit에 로그인할 수 있습니다. no-auth 도구는 준비와 검사에 사용할 수 있지만 생성에는 계정이 필요합니다.

현재 14개 도구 표면에는 /v2/mcp 경로를 사용하세요.
클라이언트가 OAuth 범위를 요청하면 openid와 email을 요청하세요.
로그인은 연결을 인증하지만 그 자체로 생성 작업을 제출하지는 않습니다.

{
  "mcpServers": {
    "to3d": {
      "url": "https://mcp.to3d.app/v2/mcp"
    }
  }
}

MCP 검색 실행

클라이언트는 initialize로 시작한 뒤 tools/list와 resources/list를 요청합니다. 라이브 게이트에서 사용한 안전한 검색이며 이 페이지는 생성 도구를 호출하지 않습니다.

initialize는 프로토콜과 서버 정보를 설정합니다.
tools/list는 이름, 스키마, 보안 스킴을 반환합니다.
resources/list는 서버가 알리는 위젯 리소스를 반환합니다.

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"your-client","version":"1.0"}}}
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}
{"jsonrpc":"2.0","id":3,"method":"resources/list","params":{}}

라이브 14개 도구

현재 v2 응답은 OAuth로 보호되는 계정·작업 동작과 no-auth 준비·진단 동작을 나눕니다. 클라이언트 구현의 기준은 실제로 받은 이름과 스키마입니다.

OAuth는 클라이언트가 연결된 계정 세션을 제시해야 한다는 뜻입니다.
인증이 없으면 계정 토큰 없이 도구를 호출할 수 있지만 무료 생성이라는 뜻은 아닙니다.
읽기 전용 힌트는 도구 주석을 설명할 뿐 서버의 권한 검사를 대신하지 않습니다.

curl -fsS https://mcp.to3d.app/v2/mcp -H 'content-type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

라이브 게이트에서 tools/list가 반환한 도구
도구	접근	용도
`get_3d_credits`	OAuth	사용 가능한 크레딧 조회
`estimate_3d_generation`	OAuth	생성 크레딧 예상
`generate_3d`	OAuth	이미지에서 생성
`image-to-3d`	인증 없음	이미지 선택기 열기
`process_image_url_to_3d`	인증 없음	이미지 URL 미리보기
`prepare_3d_generation`	인증 없음	선택한 이미지 준비
`cancel_3d_generation`	인증 없음	제출하지 않은 요청 취소
`generate_3d_authenticated`	OAuth	준비된 생성 시작
`get_authenticated_generation`	OAuth	생성 확인
`create_3d_job_from_url`	OAuth	URL에서 3D 작업 재개
`get_3d_job_status`	OAuth	작업 상태 확인
`get_3d_result`	OAuth	작업 결과 가져오기
`get_3d_status`	OAuth	작업 확인
`report_widget_diagnostic`	인증 없음	위젯 진단 기록

작업 흐름 따르기

이미지를 준비하고 생성 시 인증한 다음 작업을 시작하거나 재개하고 상태와 결과를 읽습니다. 각 단계에서 받은 resumeKey, intentId, jobId, taskId를 그대로 보존하세요.

유료 생성을 요청하기 전에 크레딧과 예상치를 확인하세요.
get_3d_job_status 또는 get_3d_status로 작업을 관찰하고 서버가 완료를 보고하면 get_3d_result를 사용하세요.
현재 엔드포인트는 MCP humanoid 리깅 도구를 제공하지 않습니다. 별도 리그 작업에는 REST Skin Tokens 흐름을 사용하세요.

prepare -> authenticate -> generate_3d_authenticated -> get_3d_job_status -> get_3d_result

클라이언트와 기능의 경계

Web 스튜디오와 REST API는 별도 계약을 가집니다. MCP 클라이언트는 실제로 검색한 도구와 스키마만 보여 주고 다른 경로의 OAuth, 자동 리깅, 호환성 주장을 복사하지 마세요.

이전 /mcp 경로는 existing-v1 호환 경로이며 이 v2 도구 목록의 근거가 아닙니다.
이 라이브 엔드포인트의 OAuth 지원은 기록되어 있지만 각 클라이언트 로그인 흐름은 별도로 검증해야 합니다.
이 가이드에서는 생성 요청을 실행하지 않았습니다.

endpoint=https://mcp.to3d.app/v2/mcp
legacy=https://mcp.to3d.app/mcp