MockaoTalk MCP 사용법: AI로 채팅 목업 PNG와 편집 URL 만들기

MockaoTalk MCP 사용법에서 바로 확인할 설정은 원격 Streamable HTTP 주소 https://mockaotalk.com/mcp를 MCP 클라이언트에 추가하고 generate_chat_image를 호출하는 것입니다. 도구는 PNG와 동일한 builderUrl·editUrl을 반환하며, 요청 대화는 서버 렌더링을 거치므로 민감한 실제 정보는 넣지 마세요.

2026년 7월 22일 실제 엔드포인트에 MCP protocol 2025-03-26으로 initialize, tools/list, 샘플 생성을 호출해 확인했습니다. 직접 편집이 더 편하면 채팅 목업 빌더를 쓰고, 제품 전체 흐름은 MockaoTalk 소개, 데이터 구분은 채팅 목업 개인정보 보호를 참고하세요.

한눈에 요약

• 서버 주소는 https://mockaotalk.com/mcp, 전송 방식은 Streamable HTTP입니다.
• 2026년 7월 22일 tools/list에서 확인된 도구는 generate_chat_image 1개입니다.
• 입력은 script 또는 완전한 state 중 하나이며, 렌더 옵션으로 배율·워터마크·전체 대화 캡처를 정할 수 있습니다.
• 출력은 내장 PNG, 정확한 편집 URL, 파일명·바이트 수 등의 구조화된 정보입니다. MCP가 MP4를 직접 반환하지는 않습니다.
• MCP 요청과 PNG는 서버에서 처리됩니다. 입력 상태와 생성 PNG에는 생성 시점 기준 10분의 만료 시각이 설정되며 활성 서버 인스턴스 메모리에 최대 32건 임시 캐시됩니다. 만료 뒤 조회 또는 예약 타이머 실행 시 제거됩니다.

바로 쓰는 설정값

클라이언트별 메뉴와 설정 파일 형식은 버전에 따라 달라질 수 있습니다. 원격 HTTP MCP 서버 추가 화면에서 위 URL을 넣고, 연결 후 도구 목록에 generate_chat_image가 보이는지 확인하는 방식이 가장 안전합니다. 특정 CLI 명령을 복사하기 전에는 해당 클라이언트의 현재 공식 문서를 확인하세요.

MockaoTalk MCP란?

MockaoTalk MCP는 AI 클라이언트가 짧은 대화 스크립트나 구조화된 채팅 상태를 보내면 서버에서 PNG 목업을 렌더링해 돌려주는 원격 MCP입니다. 기본 흐름은 AI가 대화 구성 → generate_chat_image 호출 → PNG 확인 → builderUrl에서 사람이 수정입니다. AI가 만든 결과를 최종본으로 간주하지 않고 이름, 말투, 시간, 공개 정보, 줄바꿈을 빌더에서 다시 검수하는 용도에 맞습니다.

실제 tools/list 응답의 input schema에는 script와 state, 방 이름, 사용자·상대 이름, 기준 시각, 메시지 간격, 배율, 워터마크 제거, 전체 대화 캡처가 있습니다. 프로필 이미지 URL은 state 입력에서 허용되지 않아 텍스트 중심 장면에 적합합니다.

2026년 7월 22일 실제 연결·생성 결과

브랜드 운영 환경이 아니라 공개 endpoint에 직접 요청해 확인한 결과입니다. initialize는 protocol version 2025-03-26, 서버명 mockaotalk-mcp, version 0.1.0을 반환했습니다. 이어서 tools/list에서 generate_chat_image 하나와 JSON schema를 확인했습니다.

검증용 가명 대화 2개 메시지를 scale: 1로 생성했을 때 응답은 26,867바이트 PNG를 내장했고, content 유형은 text, resource_link, image, text 순서였습니다. 구조화 응답의 builderUrl과 editUrl은 같은 URL이었고 추천 파일명은 기준 시각을 반영한 mockaotalk-20260722-1400.png였습니다. 이 수치는 해당 샘플 1건의 결과일 뿐 다른 장면의 용량이나 처리 시간을 보장하지 않습니다.

가장 단순한 요청 형식

자연어 설명만 던지기보다 화자 방향과 결과 요구를 명시하면 검수하기 쉽습니다.

MockaoTalk MCP의 generate_chat_image를 사용해 주세요.
방 이름: 프로젝트 일정 확인
< 민지: 회의는 몇 시야?
> 나: 오후 2시야. 10분 전에 들어갈게.
PNG를 생성하고 정확한 builderUrl도 알려 주세요.

<는 왼쪽 상대 메시지, >는 오른쪽 사용자 메시지로 파싱됩니다. 한 줄에 이름: 메시지를 쓰면 참가자 이름을 반영할 수 있습니다. URL이나 시각이 메시지 본문에 들어가도 되지만, 실제 비밀번호·인증번호·내부 주소는 샘플 값으로 바꾸세요.

바로 복사하는 요청 예시 10개

1. 가명 2명이 회의 시각을 확인하는 4개 메시지 채팅 목업 PNG를 만들고 정확한 builderUrl을 알려 주세요.
2. 배송 지연 안내를 고객과 상담원 대화 6개로 구성하되 주문 번호는 SAMPLE-1001로 써 주세요.
3. 학부모 공지 장면을 교사와 보호자 가명으로 만들고 날짜·준비물·확인 답장을 한 화면에 넣어 주세요.
4. 제품 기능을 과장 없이 묻고 답하는 창작 대화 5개를 만들고 광고용 연출임이 드러나게 해 주세요.
5. 영어 약속 변경 장면을 4개 메시지로 만들고 마지막 말풍선에 새 시간 확인을 넣어 주세요.
6. 팀 회식 일정 투표를 참가자 3명, 메시지 7개로 만들고 실제 회사명은 쓰지 마세요.
7. CS 교육용 환불 문의를 문의·확인·규정·다음 단계 순서로 만들고 정책 수치는 임의 값이라고 표시해 주세요.
8. 쇼트폼 첫 장면용 친구 대화를 5개 메시지로 만들되 혐오·모욕 표현은 빼 주세요.
9. state 입력으로 참가자 2명과 읽지 않은 수 1을 설정하고 PNG 배율 2로 생성해 주세요.
10. 전체 대화 캡처를 켜고 긴 공지 예시를 만들되 결과 URL과 로컬 저장 파일명을 함께 알려 주세요.

입력 제한과 출력 필드

출력 schema에는 mimeType, bytes, builderUrl, editUrl, recommendedFileName, imageEmbedded, localSaveRecommended와 AI 응답 지침이 포함됩니다. 이미지 크기가 내장 한도를 넘으면 오류가 날 수 있으며, 공개 도구 schema의 기본 내장 한도는 서버 내부 옵션으로 관리됩니다. 긴 실제 상담 로그를 그대로 보내기보다 핵심 장면만 줄여 만드는 편이 검수하기 쉽습니다.

builderUrl과 editUrl은 무엇인가요?

현재 소스에서 editUrl은 builderUrl과 같은 문자열로 반환됩니다. URL은 https://mockaotalk.com/builder#state=mt1... 형태이며, #state 뒤에 deflate-raw로 압축하고 base64url로 인코딩한 대화 JSON이 들어갑니다. URL fragment는 일반적인 서버 HTTP 요청에 포함되지 않지만 암호화된 비밀 저장소는 아닙니다.

전체 URL을 받은 사람은 같은 대화 상태를 열 수 있습니다. 빌더는 상태를 가져온 뒤 주소창에서 fragment를 지우고, 참가자·메시지·방 설정을 브라우저 localStorage에 자동 저장합니다. 따라서 URL을 잃어버리면 서버 계정에서 복구하는 방식이 없고, 반대로 민감한 URL을 공유하면 수신자가 내용을 복원할 수 있습니다.

개인정보와 서버 처리 범위

MCP 요청은 MockaoTalk 서버로 전송되고 헤드리스 Chromium에서 PNG로 렌더링됩니다. 렌더러는 Google Analytics, 광고, 네이버 분석 등 지정된 외부 호스트 요청을 차단합니다. 검사한 소스에는 생성한 대화를 영구 저장하는 별도 DB나 업로드 파일 로직이 없습니다. 렌더 결과 객체에는 PNG base64와 대화 상태가 든 builder URL이 포함됩니다. 입력 상태와 생성 PNG에는 생성 시점 기준 10분의 만료 시각이 설정되며 활성 서버 인스턴스의 프로세스 메모리에 최대 32건 임시 캐시됩니다. 만료 뒤 조회 또는 예약 타이머 실행 시 제거됩니다.

이 구조를 서버로 전송되지 않음 또는 저장 흔적이 전혀 없음으로 표현하면 부정확합니다. 실제 고객 대화, 전화번호, 주소, 인증번호, 결제 정보, 비밀번호, 내부 프로젝트명은 가명과 더미 값으로 바꾸세요. MCP 클라이언트 자체의 로그·대화 기록·파일 저장 정책도 MockaoTalk과 별개로 확인해야 합니다.

연결이 안 될 때 10가지 확인

1. URL이 정확히 https://mockaotalk.com/mcp인지 확인합니다.
2. 클라이언트가 원격 Streamable HTTP MCP를 지원하는지 확인합니다.
3. 설정 변경 뒤 클라이언트의 서버 목록을 새로고침합니다.
4. 도구 목록에 generate_chat_image가 나타나는지 봅니다.
5. 사내 방화벽이나 프록시가 외부 POST 요청을 막는지 확인합니다.
6. script와 state를 동시에 보내지 않았는지 확인합니다.
7. 메시지·참가자·방 이름 제한을 넘지 않았는지 확인합니다.
8. state의 시간값이 offset을 포함한 date-time 형식인지 확인합니다.
9. 이미지 대신 링크만 보이면 정확한 builderUrl을 브라우저에서 엽니다.
10. MP4를 직접 요청했다면 PNG 생성 후 빌더에서 내보내는 흐름으로 바꿉니다.

자주 묻는 질문

MockaoTalk MCP에 API 키가 필요한가요?

2026년 7월 22일 공개 endpoint와 소스를 확인했을 때 별도 API 키 없이 초기화와 도구 호출이 가능했습니다. CORS도 공개 origin을 허용하도록 구성되어 있습니다. 운영 정책은 바뀔 수 있으므로 연결이 실패하면 현재 서비스 공지와 클라이언트 로그를 다시 확인하세요. 공개 endpoint라는 이유로 과도한 자동 호출을 해서는 안 됩니다.

MCP에서 MP4를 바로 받을 수 있나요?

아닙니다. 현재 generate_chat_image의 직접 결과는 PNG입니다. 응답에 포함된 정확한 builderUrl 또는 editUrl을 열면 같은 대화 상태를 웹 빌더에서 수정하고 MP4 내보내기를 진행할 수 있습니다. 영상 작업 순서는 채팅 대화 MP4 만들기에서 확인할 수 있습니다.

민감한 실제 대화를 넣어도 되나요?

넣지 않는 편이 안전합니다. 입력은 서버로 전송되고, 결과가 짧은 시간 메모리 캐시에 남을 수 있으며, builderUrl 자체에도 대화 상태가 들어갑니다. AI 클라이언트가 별도로 프롬프트와 도구 응답을 보관할 수도 있습니다. 실명·연락처·고객 정보·인증정보를 제거한 재현용 샘플만 사용하세요.

원격 MCP를 지원하지 않는 도구에서는 어떻게 하나요?

URL만으로 연결할 수 없습니다. AI에게 대화 스크립트만 작성하게 한 뒤 채팅 장면 만들기에 직접 입력하는 방법이 가장 단순합니다. 중간 브리지나 프록시를 쓰려면 그 도구의 인증·로그·데이터 처리 범위를 별도로 검토해야 하며, 이 글은 특정 브리지를 권장하지 않습니다.

다음 단계

가명 2명과 메시지 4개로 첫 호출을 만들고, 결과의 PNG와 정확한 builderUrl을 모두 확인하세요. 최종 공개 전에는 빌더에서 이름·시간·줄바꿈·민감정보를 다시 검수하고, 연결이 필요 없다면 웹 빌더에서 직접 채팅 목업 만들기로 전환하면 됩니다.