{"pageKey":"Developers","slug":"developers","locale":"ko","localeResolved":"ko","fallbackApplied":false,"version":"developers@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/ko/developers","payload":{"slug":"developers","purpose":"llm-developers","title":"개발자 API, 임베디드, MCP 도구 및 엔터프라이즈 통합 | MerchandAise","description":"맞춤형 상품을 위한 MerchandAise 개발자 API(OpenAPI 문서, 커뮤니티 포함, 공급업체 워크플로, 기업 ID 및 AI 에이전트용 MCP 도구)를 살펴보세요.","sections":[{"heading":"개발자 플랫폼","paragraphs":["MerchandAise API, OpenAPI 계약, 커뮤니티 포함, 공급업체 워크플로, 기업 ID 및 MCP 도구를 사용하여 맞춤형 상품을 웹사이트, 포털 및 AI 에이전트에 연결하세요."]},{"heading":"MerchandAise로 빌드하는 사람","items":[{"title":"커뮤니티 운영자","description":"버전이 지정된 공개 계약을 통해 클럽, 리그 및 회사 사이트 내부에 내장형 상점, 구성기 핸드오프 및 커뮤니티 흐름을 시작하세요."},{"title":"엔터프라이즈 팀 및 플랫폼 파트너","description":"승인 및 공급업체 논리를 다시 구축하지 않고도 조달 포털, ID 시스템 및 내부 운영을 상품 워크플로에 연결합니다."},{"title":"AI 에이전트 및 자동화 빌더","description":"MCP 호환 엔드포인트를 통해 보조자에게 검색, 견적 및 승인된 작업을 위한 구조화된 도구 액세스 권한을 부여하세요."}]},{"heading":"통합 표면 및 계약","items":[{"title":"API 문서","description":"계획, 테스트 및 버전화된 릴리스 관리를 위해 사람이 읽을 수 있는 문서와 기계가 읽을 수 있는 OpenAPI 계약을 검토하세요. Human guide: API 문서 읽기 (/ko/developers/api-integrations). Machine-readable contract: OpenAPI JSON (/api/docs/openapi.json). Access: public. Public reference for assistant and tooling APIs. Production access and order-affecting operations still require the applicable authorization. Canonical section: /ko/developers#api-docs."},{"title":"커뮤니티 삽입 API","description":"버전이 지정된 공개 계약을 통해 로케일 안전 매장 임베드, 커뮤니티 워크플로 및 인증된 핸드오프를 구현합니다. Human guide: Explore community workflows (/ko/developers/api-integrations#community-integrations). Machine-readable contract: Community OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. 매장 임베드, 커뮤니티 검색 및 로케일 인식 핸드오프를 위한 공개 버전의 계약입니다. Canonical section: /ko/developers#community-integrations."},{"title":"공급업체 API","description":"이행 워크플로용으로 구축된 버전이 지정된 엔드포인트를 통해 온보딩, 카탈로그 및 공급업체 측 작업을 연결합니다. Human guide: Explore partner workflow (/ko/developers/api-integrations#supplier-integrations). Machine-readable contract: Supplier OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. 기획 및 고객 창출을 위한 공개 계약. 운영 공급업체에 대한 액세스는 계속 허용됩니다. Canonical section: /ko/developers#supplier-integrations."},{"title":"엔터프라이즈 ID API","description":"SSO, SCIM 프로비저닝, 승인된 엔터프라이즈 액세스에 대한 보호 계약을 통해 엔터프라이즈 롤아웃 및 거버넌스를 위한 감사 준비 ID 흐름을 통합합니다. Human guide: Explore enterprise platform (/ko/developers/api-integrations#enterprise-integrations). Machine-readable contract: Enterprise identity OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. 승인된 기업 업무 공간에 대한 보호 계약 이 엔드포인트를 사용하기 전에 액세스를 요청하세요. Canonical section: /ko/developers#enterprise-integrations."},{"title":"MCP 도구","description":"검색 가능한 MCP 호환 도구 정의 및 보조 권한 부여가 있는 실행 엔드포인트를 통해 승인된 MerchandAise 기능을 AI 에이전트에 노출합니다. Human guide: MCP 구현 가이드 읽기 (/ko/developers/ai-agents-mcp). Machine-readable contract: Public MCP server-card JSON (/.well-known/mcp/server-card). Access: public. Public discovery document for machine clients. The external tools list at /api/v1/mcp/tools exposes current tool metadata; each tool call still follows its declared security, workspace, and confirmation boundaries. Canonical section: /ko/developers#mcp-tools."}]},{"heading":"통합 빠른 시작","items":[{"title":"Step 1: 귀하의 업무 흐름에 맞는 계약을 선택하세요","description":"사용자 및 인증 모델과 일치하는 표면(커뮤니티 포함, 기업 ID, 공급업체 운영 또는 보조자를 위한 MCP 도구)으로 시작하세요."},{"title":"Step 2: 인증, 버전 관리, 환경 경계 검증","description":"프로덕션 트래픽을 라우팅하기 전에 스테이징에서 필수 헤더, 범위, 콜백 예상 및 계약 버전을 확인하세요."},{"title":"Step 3: 출시 전 엔드투엔드 워크플로 테스트","description":"요청, 웹후크, 프로비저닝, 관찰 가능성 및 롤백 경로를 확인하여 최초 라이브 사용부터 통합이 안정적으로 이루어지도록 하세요."}]},{"heading":"What production-ready means","paragraphs":["프로덕션 통합에는 공개 엔드포인트 이상의 것이 필요합니다. 이러한 게이트를 사용하여 워크플로가 고객, 공급업체, 기업 또는 AI 에이전트 트래픽에 준비되었는지 여부를 결정하세요."],"items":[{"title":"Sandbox and access review","description":"출시 전에 공개 계약, 승인이 필요한 기업 표면, 자격 증명 또는 작업 공간 역할이 필요한지 확인하세요."},{"title":"Versioned implementation evidence","description":"프로덕션 트래픽이 활성화되기 전에 생성된 클라이언트, 콜백 URL, 인증 범위, 계약 버전 및 롤백 소유권을 문서화해 두세요."},{"title":"Operational observability","description":"주문, 공급업체 또는 기업 사용자에게 영향을 미칠 수 있는 모든 워크플로에 대한 로그, 재시도, 지원 소유권, 오류 상태 및 상태 확인을 계획합니다."}]},{"heading":"통합 검토가 필요합니까?","paragraphs":["아키텍처, 출시 일정, 대상 채널을 공유하세요. 올바른 계약 표면, 인증 패턴 및 실행 순서를 권장해 드립니다."],"items":[{"title":"통합팀에 문의하세요","description":"/ko/contact/integrations"},{"title":"엔터프라이즈 플랫폼 살펴보기","description":"/ko/enterprise"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}