MCP Playground: 문서에서 바로 에이전트의 도구를 라이브로 실행하세요
지난주 우리는 MCP 도구를 일급 API Contract로 만들었습니다. 실행 중인 MCP 서버를 Archyl에 연결하면 모든 도구와 입력 스키마를 발견하고, REST나 GraphQL 계약처럼 C4 모델에 연결해 문서화합니다.
그것은 첫 번째 질문에 대한 답이었습니다. 내 에이전트는 무엇을 할 수 있는가?
오늘은 두 번째 질문에 답합니다. 그게 정말로 동작하는가?
MCP Playground를 소개합니다. 모든 라이브 MCP 계약에 추가된 새 탭으로, 실제 서버에 대해 어떤 도구든 호출하고 실제 결과를 확인할 수 있습니다. 클라이언트 설정도, 수동 JSON-RPC도 필요 없고, 아키텍처 문서를 떠날 필요도 없습니다.
스키마에서 폼으로, 자동으로
라이브 MCP 계약을 열면 스키마 옆에 Playground 탭이 있습니다. 목록에서 도구를 선택하면 — 이미 문서화된 그 검색 가능한 목록입니다 — Archyl이 inputSchema를 폼으로 변환합니다:
- 문자열, 숫자, 불리언은 타입이 지정된 필드가 됩니다.
- enum은 허용된 값의 드롭다운이 됩니다.
- 필수 매개변수는 표시되며, 전송 전에 검증됩니다.
- 중첩 객체와 배열은 원시 JSON 필드로 처리되며, 제출 시 검증됩니다.
입력하고 도구 실행을 누르면 결과가 소요 시간과 함께 돌아옵니다 — 결과다운 방식으로 렌더링됩니다. 포맷됨 뷰는 응답을 깔끔하게 들여쓰기된 JSON으로 보여줍니다. 트리 뷰는 큰 페이로드를 탐색 가능하게 만듭니다. 관심 없는 부분은 접고, 중요한 부분만 펼치세요. 도구가 반환하는 텍스트, 이미지, 리소스는 네이티브로 렌더링됩니다.
도구가 오류를 반환하면, 에이전트가 보게 될 것과 정확히 같은 것을 보게 됩니다 — 오류 플래그와 페이로드가 빨간색으로 표시되며, 절대 숨겨지지 않습니다.
토큰은 브라우저를 떠나지 않습니다
Playground는 라이브 디스커버리와 동일한 보안 모델을 따릅니다. 이것이 핵심이기 때문에 반복할 가치가 있습니다:
모든 호출은 브라우저에서 실행됩니다. 도구 실행을 누르면 브라우저가 MCP 서버와 직접 통신합니다. Archyl의 백엔드는 경로에 없습니다.
- 토큰은 절대 저장되지 않습니다. 세션 동안 입력할 뿐, 페이지 안에만 존재합니다.
- 결과는 절대 영속화되지 않습니다. 돌아온 것은 렌더링되고, 읽히고, 탭을 닫으면 사라집니다.
- 서버 측에서 당신의 네트워크에 접근하지 않습니다. 요청이 당신의 머신에서 시작되므로 Playground는
localhost와 사설 서버에도 도달합니다 — 그리고 악용될 수 있는 서버 측 요청 경로 자체가 존재하지 않습니다.
디스커버리와 마찬가지로 유일한 트레이드오프는 CORS입니다. 대상 서버가 Archyl의 origin을 허용해야 합니다. 직접 관리하는 서버라면 설정 한 줄입니다.
왜 중요한가
MCP 도구는 AI 에이전트가 실제로 사용하는 인터페이스입니다. 지금까지 도구 하나를 확인하려면 클라이언트를 구성하거나, JSON-RPC 봉투를 직접 만들거나, 아니면… 그냥 설명을 믿어야 했습니다.
이제 문서가 곧 테스트 벤치입니다:
- 에이전트의 능력 범위를 리뷰 중인가요? 도구를 실행해 설명된 형태가 아닌 실제 형태를 확인하세요.
- 에이전트 호출이 왜 실패했는지 디버깅 중인가요? 정확히 같은 인수로 두 번의 클릭만에 재현하세요.
- 누군가를 서비스에 온보딩 중인가요? 계약을 보내세요 — 모든 도구를 읽을 수 있고 직접 시도할 수도 있습니다.
이것이 우리가 말하는 살아있는 문서입니다. 실행 가능한 스펙은 조용히 표류하지 않습니다. 거짓말하는 순간 들통납니다.
언제나처럼, 우리가 먼저 씁니다
Archyl 자체가 MCP 서버입니다 — 이번 주 기준 181개의 도구. Playground의 첫 사용자는 우리 자신의 계약이었습니다. 매일 우리 문서에서 우리 엔드포인트에 대해 list_projects, get_project_c4_model 등을 실행합니다. 위 스크린샷이 바로 그것입니다.
사용해 보세요
프로젝트 열기 → API Contracts → 라이브 엔드포인트가 있는 MCP 계약 → Playground. 토큰을 입력하고, 도구를 선택하고, 실행하세요.
당신의 아키텍처 문서가 방금 실행하는 법을 배웠습니다.