E EmDash CMS Everything Guides, use cases, plugins, templates
한국어

AI 도구

이 페이지

EmDash에는 MCP 서버가 내장되어 있어 AI 어시스턴트가 사이트 콘텐츠를 직접 다룰 수 있습니다. Claude, ChatGPT 등에 글 초안 작성, 페이지 수정, 미디어 관리, 콘텐츠 검색 등을 자연어로 요청할 수 있습니다.

MCP 서버 사용 설정

MCP 서버는 기본적으로 꺼져 있습니다. Astro 설정에서 켭니다.

emdash({
  mcp: true,
})

설정 방법

사이트의 MCP 서버 URL은 다음과 같습니다.

https://example.com/_emdash/api/mcp

example.com을 도메인으로 바꿉니다. 로컬 개발에서는 http://localhost:4321/_emdash/api/mcp를 사용합니다.

Claude

claude.ai에서 추가한 커넥터는 웹앱과 Claude Desktop 모두에서 동작합니다.

  1. Settings > Connectors로 이동

  2. Add custom connector 클릭

  3. 사이트의 MCP 서버 URL 입력

  4. Add 클릭 — 브라우저가 열리며 로그인 후 접근 승인

  5. 새 대화를 시작하고 입력창의 + → Connectors에서 사이트 켜기

Team·Enterprise에서는 소유자가 먼저 Admin Settings > Connectors에서 커넥터를 추가하고, 구성원은 각자 설정에서 연결합니다.

ChatGPT

ChatGPT는 Pro, Business, Enterprise에서 MCP 서버를 지원합니다.

  1. Settings > Apps & Connectors > Advanced settings에서 Developer Mode 사용

  2. Settings > Connectors > Create로 이동

  3. 이름, 설명, 사이트의 MCP 서버 URL 입력

  4. Create 클릭

  5. 대화에서 컴포저 근처 + → More에서 커넥터 선택

할 수 있는 일

연결되면 아래 작업을 자연어로 요청할 수 있습니다. 도구 이름을 외울 필요는 없습니다.

콘텐츠

  • 탐색 — “최근 블로그 글 10개 보여줘” 또는 “초안 페이지 전부 찾아줘”
  • 읽기 — “‘hello-world’ 글 가져와서 요약해줘”
  • 만들기 — “여름 세일 블로그 글 새로 써줘” 또는 “소개 섹션용 초안 페이지 만들어줘”
  • 수정 — “가격 페이지에 새 요금제 언급해줘” 또는 “FAQ 글 오타 고쳐줘”
  • 게시·예약 — “여름 세일 글 게시해줘” 또는 “6월 1일 오전 9시에 공지 예약해줘”
  • 버전 비교 — “홈페이지가 마지막 게시 이후 뭐가 바뀌었는지 보여줘”
  • 초안 관리 — “about 페이지 초안 변경 버려줘” 또는 “뉴스레터 템플릿 복제해줘”
  • 번역 — “환영 글에 어떤 번역이 있어?” (i18n 사용 시)

미디어

  • 탐색 — “업로드한 이미지 전부 목록” 또는 “미디어 라이브러리의 PDF 보여줘”
  • 상세 — “이 미디어 항목 정보 알려줘”
  • 메타데이터 — “히어로 이미지 alt를 ‘Mountain sunset’으로 설정해줘”
  • 삭제 — “옛 배너 이미지 삭제해줘”

검색

  • 찾기 — “‘accessibility’가 나오는 글 검색” 또는 “모든 컬렉션에서 TypeScript 관련 찾기”

분류(택소노미)

  • 목록 — “카테고리 전부” 또는 “태그 보여줘”
  • 용어 추가 — “‘tutorials’ 태그 추가” 또는 “‘Engineering’ 아래 ‘Frontend’ 하위 카테고리 만들기”

메뉴

  • 보기 — “메인 내비 메뉴 보여줘” 또는 “푸터 메뉴에 뭐가 있어?”

스키마(관리자만)

  • 조회 — “어떤 컬렉션이 있어?” 또는 “posts 컬렉션 필드 보여줘”
  • 컬렉션 생성 — “name, quote 필드로 testimonials 컬렉션 만들어줘”
  • 스키마 변경 — “posts에 featured 불리언 필드 추가해줘”

리비전

  • 이력 — “이 글 리비전 이력 보여줘”
  • 복원 — “이 글 이전 버전으로 되돌려줘”

권한

AI 도구로 할 수 있는 일은 EmDash 역할에 따릅니다. AI는 관리자 패널과 동일한 권한으로 동작합니다.

역할AI가 할 수 있는 일
Admin스키마 변경 포함 전부
Editor모든 콘텐츠, 미디어, 분류, 메뉴. 스키마 조회 가능.
Author본인 콘텐츠와 미디어
Contributor본인 콘텐츠(게시 불가)와 미디어

권한 밖 작업을 시도하면 AI가 알려줍니다.

팁

  • 컬렉션을 구체적으로. 여러 컬렉션이 있으면 “블로그 글 만들어줘”처럼 말하세요.
  • 먼저 스키마 확인. 필드를 모르면 “posts 컬렉션 필드가 뭐야?”부터 물어보세요.
  • 게시 전 검토. 초안으로 만들게 한 뒤 관리자에서 확인하고 게시를 요청하거나 직접 게시하세요.
  • 비교로 리뷰. 게시 전 “이 글 라이브와 초안 버전 비교해줘”로 변경점을 확인하세요.
  • 리치 텍스트는 Portable Text. AI가 쓸 수 있지만 복잡한 서식은 관리 에디터가 낫습니다.

개발자용

MCP 엔드포인트, 인증, OAuth 디스커버리, 도구 매개변수, 오류 처리는 MCP 서버 참고에 있습니다.