MCP 개요

지원 범위

구현됨	아직 제공하지 않음
허용된 플랫폼 연결 목록	고객용 WordPress 로그인·동의·연결 화면
플랫폼 이름·언어	페이지 편집·생성·공개 게시·복원
페이지 메타데이터·목록	상품·콘텐츠 변경, 주문·고객 조회
블록 종류·페이지 버전	구매·배송·환불·정기결제·정산

페이지 조회는 블록 구조 목록입니다. 원본 HTML·JavaScript·이미지·본문을 통째로 반환하거나 디자인을 개선하는 기능이 아닙니다.

기존 API와의 차이

구분	호출자	자격 증명
스토어프론트 API	브라우저·외부 프론트엔드	스토어프론트 키 + 필요 시 구매자 토큰
서버용 비공개 API	판매자 서버	서버용 API 키
MCP 로컬 개발 기반	MCP 클라이언트	MCP 전용 OAuth 접근 토큰 + 유효한 플랫폼 연결

스토어프론트 키, 서버용 API 키, WordPress 쿠키, 구매자 로그인 토큰으로 MCP에 접근할 수 없습니다.

연결 구조와 주소

Gateway는 공식 TypeScript SDK와 Streamable HTTP를 사용합니다. Laravel 어댑터는 같은 보호 리소스의 구성 요소이며, 토큰과 현재 권한을 독립적으로 검증합니다.

연결 하나는 플랫폼 하나와 OAuth 사용자·클라이언트에 묶입니다. 대상 플랫폼은 도메인이나 임의 식별자가 아니라 검증된 연결로 결정됩니다. MCP 토큰을 WordPress, PG, 다른 API나 다른 MCP 서버로 전달하지 않습니다.

개발용 주소 예시는 http://127.0.0.1:8120/mcp입니다. 로컬에서 별도로 실행해야 하며 이미 동작 중인 운영 주소가 아닙니다. 운영 주소를 추측해서 연결하지 마세요.

메서드·경로	용도
POST `/mcp`	MCP 요청
GET `/.well-known/oauth-protected-resource/mcp`	인증 리소스 메타데이터
GET `/.well-known/oauth-protected-resource`	동일한 메타데이터

MCP 리소스의 일반 GET 요청이나 세션 삭제 기능은 현재 제공하지 않습니다.

로컬 검증

moa-laravel의 services/runmoa-mcp/README.md에 격리된 DB, 발급자·공개키 준비 및 실행 순서가 있습니다.

# moa-laravel 저장소 루트: 메모리 SQLite와 테스트 전용 키
php vendor/bin/phpunit tests/Feature/McpAuthorizationTest.php

# services/runmoa-mcp 디렉터리: 가짜 backend와 실제 SDK 클라이언트
npm ci --ignore-scripts
npm test

실제 계정 연결, 운영 DB 변경, 고객 데이터 접근, PG·AI 호출 없이 테스트합니다. 검증한 클라이언트는 공식 SDK v2.3.1입니다. 다른 AI 클라이언트 호환성은 아직 보장하지 않습니다.

공개 전 필요한 작업

OAuth 발급자·토큰 계약 확정, PKCE·리다이렉트·클라이언트 등록 검증.
WordPress 로그인·플랫폼 선택·권한 동의·철회 화면 구현.
기존·신규 플랫폼 사용자 연결, 공개키 교체·토큰 갱신·철회 검증.
HTTPS·프록시·비공개 backend·사용량 제한·감사 기록 보관 정책 검증.
지원 클라이언트의 실제 연결·철회·권한 오류 테스트.

기본 설정은 MCP_ENABLED=false입니다. 코드 병합이나 문서 게시만으로 공개 연결이 활성화되지 않습니다.

다음 문서

/mcp-tools.json은 정적 문서 자료입니다. 실제 서버의 tools/list 응답이나 연결 상태를 대신하지 않습니다.