제품 구성기 MCP: Claude, Cursor 및 VS Code를 Simplio3D에 연결

오늘 제품 구성기에 관해 AI 어시스턴트에게 물어보면 채팅에 붙여넣은 내용(스크린샷, 옵션 목록, 직접 입력한 가격)을 바탕으로 답변합니다. MCP 커넥터는 이 단계를 없애 줍니다. 커넥터는 어시스턴트가 권한에 따라 Simplio3D 계정에 직접 연결할 수 있게 하므로, 실제 프로젝트(옵션 블록, 조건부 규칙, 가격 계산식, 3D 모델 내부의 부품 이름)를 읽고 이를 기반으로 답변합니다.

이 가이드에서는 MCP 커넥터가 무엇인지, 연결된 에이전트가 Simplio3D에서 할 수 있는 일과 할 수 없는 일, 위험한 변경 사항을 계속 관리하는 방법, 그리고 Claude, Cursor 또는 VS Code를 연결하는 방법을 설명합니다.

MCP 커넥터란 무엇인가요?

Model Context Protocol(MCP)은 AI 어시스턴트를 외부 도구 및 데이터에 연결하기 위한 개방형 표준입니다. 여기에는 두 가지 측면이 있습니다. MCP 클라이언트는 Claude, Cursor 또는 VS Code처럼 이미 사용 중인 AI 도구입니다. MCP 서버는 어시스턴트가 연결하는 시스템으로, 질문에 필요한 경우 어시스턴트가 호출할 수 있도록 설명과 스키마를 갖춘 도구 목록을 제공합니다.

커넥터는 이 둘을 연결하는 수단입니다. 즉, 서버 주소와 연결 주체 및 접근 가능한 항목을 지정하는 자격 증명으로 구성됩니다. Claude에서는 이를 사용자 지정 커넥터라고 하며, 다른 클라이언트에서는 MCP 서버 항목이라고 합니다. Simplio3D에서는 항상 다음 두 가지입니다.

• 엔드포인트: https://app.simplio3d.ai/mcp
• 자격 증명: Simplio3D 동의 화면에서 승인하는 OAuth 로그인 또는 Dashboard → Integrations → AI Connections에서 생성하는 연결 토큰

연결되면 어시스턴트는 자체 도구와 함께 Simplio3D의 도구를 확인하고, 요청 내용에 따라 언제 호출할지 결정합니다.

연결된 에이전트가 Simplio3D에서 할 수 있는 작업

Simplio3D MCP 서버는 읽기 작업 52개, 제어된 쓰기 모델에서 작동하는 쓰기 작업 68개, 에이전트 워크플로를 실행하는 작업 3개 등 총 123개의 도구를 제공합니다. 이 도구들은 프로젝트, 3D 모델 검사, 소재, 옵션 블록, 조건부 로직, 가격 책정, 양식, 견적 요청 및 스토어 연결을 포괄합니다. 실제로 연결된 에이전트는 다음과 같은 작업을 수행할 수 있습니다.

• 실제 프로젝트 읽기: 모델, 옵션 블록 및 변형, 소재, 조건부 규칙, 가격 블록과 수식, 양식 필드를 확인합니다.
• 3D 모델 내부 확인: 부품 이름과 계층 구조를 살펴 모든 옵션이 여전히 존재하는 메시를 대상으로 하는지 확인합니다.
• 컨피규레이터 감사: 누락된 부품 대상, 삭제된 소재, 절대 실행될 수 없는 규칙, 가격이 없는 변형을 찾아냅니다.
• 로직 설명 및 구성 가격 계산: 어떤 규칙이 옵션을 숨기는지 설명하고, 서버에서 계산된 특정 선택 조합의 비용을 제공합니다.
• 생성 및 편집: 프로젝트, 옵션 블록, 변형, 소재, 조건부 규칙 및 양식 필드를 만들고, 기존 항목을 정리합니다.
• 에이전트 워크플로 실행: 프로젝트 감사나 안전한 복구와 같은 다단계 작업을 시작하고, 질문에 답하며 진행 상황을 추적합니다. 워크플로는 승인을 위해 일시 중지되며 절대 게시하지 않습니다.
• 리드 요약: 받은 견적 요청과 각 고객이 구성한 내용을 확인합니다.
• 문서 기반 제품 질문 답변: 기억에 의존해 답하는 대신 공식 Simplio3D 문서를 검색하고 해당 페이지를 인용합니다.

각 도구와 필요한 범위, 읽기 또는 쓰기 여부는 MCP 도구 참조에 나와 있습니다.

할 수 없는 작업

어떤 범위를 부여하더라도 일부 작업은 수행할 수 없습니다. 연결된 에이전트는 프로젝트를 게시하거나 공유 링크를 만들거나 임베드 설정을 변경할 수 없습니다. 파일을 업로드하거나 프로젝트를 삭제할 수도 없습니다. Shopify 또는 WooCommerce 스토어를 연결하거나 연결 해제할 수 없으며, 해당 스토어의 자격 증명을 읽을 수도 없습니다. 또한 데이터베이스 액세스, API 키, 웹훅 시크릿 또는 공유 보기 비밀번호를 절대 받지 않습니다. 도구는 원시 레코드가 아닌 선별된 요약 정보만 반환합니다.

범위: 각 연결에 필요한 권한만 부여하세요

연결은 해당 범위에 포함된 도구만 확인하고 호출할 수 있습니다. 읽기 전용으로 시작하고, 작업에 따라 한 번에 하나의 쓰기 범위를 추가하세요.

모든 작업을 수행할 수 있는 하나의 연결보다 여러 개의 작은 연결이 더 안전합니다. 가격을 검토하는 어시스턴트에는 읽기 범위와 가격 쓰기 권한이 있는 전용 연결을 부여하고, 프로젝트를 구축하는 어시스턴트에는 별도의 연결을 부여하세요. 그러면 하나를 해제해도 다른 연결은 중단되지 않습니다.

변경 사항을 관리하는 방법

잘못된 편집 내용이 고객에게 전달되지 않는 경우에만 AI가 운영 중인 구성기를 편집하도록 허용할 수 있습니다. Simplio3D는 모든 쓰기 작업을 제안, 확인, 스냅샷의 세 단계로 처리합니다.

• 위험도가 낮은 편집은 사용자 대기 없이 적용됩니다. 예를 들어 블록 이름 변경이나 변형 추가가 이에 해당합니다.
• 위험도가 높은 변경은 항상 제안만 생성합니다. 가격, SKU, 삭제, 일괄 편집, 공유 머티리얼 및 스토어 제품 링크가 이에 해당합니다. 제안은 AI Connections 페이지의 Pending AI changes에 대기하며, 적용될 모든 변경 사항을 나열합니다. 사용자가 Apply를 누르거나 해제합니다. 어떤 에이전트도 자신의 제안을 승인할 수 없으며, 이 규칙은 비활성화할 수 없습니다.
• 적용된 모든 변경 사항은 스냅샷으로 저장됩니다. 따라서 변경을 되돌린 후 다시 검증하고 감사 로그에 기록할 수 있습니다.

제안은 유효 기간이 짧습니다. 에이전트가 제안한 후 프로젝트가 변경된 경우, 최신 편집 내용을 덮어쓰는 대신 기존 제안은 거부됩니다. 에이전트에게 다시 요청하세요.

또한 도구 호출은 다음 네 가지 검사를 모두 통과해야만 성공합니다. 계정 이메일 주소가 인증되었는지, 워크스페이스 소유자의 요금제가 활성 상태인지, 시트 역할이 해당 작업을 허용하는지, 연결에 해당 범위가 있는지입니다. 가장 제한적인 조건이 적용됩니다. 예를 들어 Viewer 시트는 연결에 어떤 범위가 있더라도 변경을 수행하거나 확인할 수 없습니다.

토큰 없이 Claude 연결하기. Simplio3D은 Claude의 커넥터 디렉터리에 등록되어 있습니다. Claude에서 Customize → Connectors를 열고 Simplio3D을 검색한 뒤 Connect를 클릭하거나, Add custom connector를 선택하고 https://app.simplio3d.ai/mcp을 붙여넣으세요. 어느 방법을 사용하든 Claude는 Simplio3D의 로그인 화면과 동의 화면을 열며, 여기에서 워크스페이스와 범위를 선택할 수 있고 읽기 전용 액세스는 기본으로 선택되어 있습니다. 연결이 완료되면 동일한 AI Connections 목록에 OAuth app으로 표시되며, 다른 연결과 마찬가지로 해당 위치에서 갱신하거나 해지할 수 있습니다.

먼저 시도해 볼 프롬프트

프로젝트 이름을 지정하고 근거를 요청하세요. “왜 숨겨져 있나요?”보다 “어떤 규칙이 이를 숨기나요?”라고 물으면 더 정확한 답변을 받을 수 있습니다.

의존하기 전에 알아둘 만한 제한 사항

• 에이전트는 저장된 데이터를 읽습니다. 에디터는 변경 후 몇 초 뒤에 자동 저장되므로, 방금 수정한 내용은 아직 표시되지 않을 수 있습니다. 저장한 후 다시 요청하세요.
• 서버 측 가격 및 로직에는 유의사항이 있습니다. 가격 계산과 규칙 평가는 일반적인 경우를 다루지만, 단위별 Number Input 가격 책정과 같은 게시된 구성기의 모든 동작을 포괄하지는 않습니다. 각 결과에는 평가하지 않은 항목이 표시되며, 미리보기와 게시된 공유 보기에서 확인한 내용이 최종 기준입니다.
• 요청 제한. 각 연결은 5분마다 300개의 요청을 보낼 수 있습니다. 하나의 워크스페이스는 연결된 모든 에이전트와 기본 제공 어시스턴트가 공유하여 10분마다 30개의 적용된 AI 변경을 허용합니다.
• 큰 응답은 잘리며, 그 사실이 표시됩니다. 약 60KB를 초과하는 결과는 요약되고 잘림으로 표시되므로, 에이전트가 목록의 일부를 전체로 오인하지 않습니다.
• 에이전트가 읽는 내용은 사용 중인 AI 제공업체로 전송됩니다. 견적 요청에는 고객 이름과 연락처 정보가 포함되므로, Quotes 범위는 신중하게 부여하세요.
• 토큰은 90일 후 만료됩니다. 채팅, 지원 티켓 또는 화면 공유에 붙여넣은 적이 있다면 즉시 교체하세요. 교체하면 이전 토큰은 즉시 중지됩니다.

모든 AI 인터페이스를 뒷받침하는 하나의 도구 계층

MCP 서버는 별도로 덧붙인 독립 제품이 아닙니다. Simplio3D’의 기본 제공 AI 어시스턴트, 자체 자동화를 위한 인증된 REST 도구 엔드포인트, 그리고 외부 MCP 클라이언트는 모두 동일한 인증, 권한 및 감사 로그 기반의 동일한 도구 레지스트리를 호출합니다. 기능은 어디에서 호출하든 동일하게 작동하며, 한 곳에서 차단하는 범위 또는 역할은 모든 곳에서 차단됩니다.

이 점이 MCP가 REST API 및 SDK와 다른 이유이기도 합니다. SDK은 API 키로 인증되는 자체 코드용 타입 지정 클라이언트이며, 이 키는 MCP 엔드포인트에서 절대 허용되지 않습니다. MCP는 도구별로 범위를 지정하는 연결을 통해 인증되는 AI 에이전트를 위한 것입니다.