MCP
넓은 자격 증명 노출 없이 AI 에이전트를 승인된 워크스페이스 맥락에 연결합니다.
MCP
hosted·shell이 없는 AI assistant가 워크스페이스 맥락이나 schema 조회가 필요할 때 MCP를 사용합니다. shell을 사용할 수 있는 coding agent는 CLI를 사용하며, hosted MCP는 콘솔 기반 discovery 도구만 제공하는 단일 HTTP/OAuth 표면입니다: get-collection-schema, get-tenant-context, check-feature-progress. 로컬 stdio 전송은 폐기되었습니다. MCP에는 collection CRUD 또는 commerce 도구가 없으므로 shell agent는 CLI, 애플리케이션 런타임은 SDK를 사용합니다. MCP는 범위, 자격 증명, 출시 준비에 대한 사람 승인을 대체하지 않습니다.
get-collection-schema는 customers와 products의 active custom-field
구조를 optional collection.customFields로 포함할 수 있습니다. machine key,
type, required marker, select 저장값, customData 저장 경로만 반환하며 운영자
label이나 저장된 고객·상품 값은 반환하지 않습니다. MCP 권한도 넓어지지
않습니다.
표면
| 표면 | 사용처 | 경계 |
|---|---|---|
| hosted MCP | OAuth 기반 hosted 클라이언트 접근 | context, schema, feature-progress discovery |
| Agent CLI | shell 사용 agent(01 agent) | 로컬 자격 증명, 기계 안정 I/O |
| API / SDK | 애플리케이션 런타임·서버 쓰기 | secret-key/서버 자격 증명 |
| OpenAPI | HTTP 계약 생성 | 구현 세부사항 |
에이전트 인계
- 에이전트에게 워크스페이스 목표, 활성화된 기능, 허용 변경 범위를 제공합니다.
- 이커머스 작업은 인계 전에
check-feature-progress를 실행하게 합니다. - Secret Key 처리는 신뢰할 수 있는 로컬 또는 서버 환경에 둡니다.
- 에이전트에게 검증 명령과 변경 파일을 보고하게 합니다.
- 출시 전에는 워크스페이스 변경을 사람이 검토합니다.
중지 조건
- 자격 증명 담당자가 불명확함
- 에이전트 범위가 작업보다 넓음
- 플랜에 막힌 기능을 요청함
- 출시 준비에 해결되지 않은 blocker가 있음
AI 에이전트 접근은 워크스페이스와 작업 범위로 제한해야 합니다. MCP를 자격 증명 소유권이나 출시 검토를 우회하는 수단으로 사용하지 않습니다.
Hosted 연결
클라이언트가 지원하는 HTTP/OAuth 흐름으로 https://mcp.01.software/mcp에 연결합니다. 설치할 local stdio 패키지는 없습니다. 연결과 도구 제공에는 대상 배포와 허가된 workspace 접근이 필요하며 문서 build가 그 접근을 보장하지 않습니다. OAuth나 discovery가 불가능하면 실패를 보고하고 클라이언트에 Secret Key를 대신 넣지 마세요.