AI 도구

EmDash에는 AI 어시스턴트가 사이트 콘텐츠를 직접 작업할 수 있는 내장 MCP 서버가 있습니다. Claude, ChatGPT 또는 기타 도구에 게시물 초안 작성, 페이지 업데이트, 미디어 관리, 콘텐츠 검색 등을 자연스러운 대화를 통해 요청할 수 있습니다.

MCP 서버 활성화

MCP 서버는 기본적으로 비활성화되어 있습니다. Astro 구성에서 활성화하세요:

emdash({
  mcp: true,
})

설정

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

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

example.com을 도메인으로 교체하세요. 로컬 개발의 경우 http://localhost:4321/_emdash/api/mcp를 사용하세요.

할 수 있는 일

연결되면 AI 어시스턴트에게 자연어로 이러한 작업 중 하나를 수행하도록 요청할 수 있습니다. 도구 이름을 알 필요가 없습니다. 원하는 것을 설명하기만 하면 됩니다.

콘텐츠

• 콘텐츠 탐색 — “최신 블로그 게시물 10개를 보여줘” 또는 “모든 초안 페이지를 찾아줘”
• 콘텐츠 읽기 — “‘hello-world’라는 게시물을 가져와서 요약해줘”
• 콘텐츠 생성 — “여름 세일에 대한 새 블로그 게시물을 작성해줘” 또는 “소개 섹션에 대한 초안 페이지를 만들어줘”
• 콘텐츠 편집 — “새 플랜을 언급하도록 가격 페이지를 업데이트해줘” 또는 “FAQ 게시물의 오타를 수정해줘”
• 게시 및 일정 예약 — “여름 세일 게시물을 게시해줘”, “6월 1일 오전 9시에 발표를 예약해줘” 또는 “출시 게시물의 일정을 취소해줘”
• 버전 비교 — “마지막으로 게시된 이후 홈페이지에서 무엇이 변경되었는지 보여줘”
• 초안 관리 — “소개 페이지의 초안 변경 사항을 삭제해줘” 또는 “뉴스레터 템플릿을 복제해줘”
• 번역 — “환영 게시물에 어떤 번역이 있나요?” (i18n이 활성화된 경우)

미디어

• 미디어 탐색 — “업로드된 모든 이미지를 나열해줘” 또는 “미디어 라이브러리에서 PDF를 보여줘”
• 세부 정보 확인 — “이 미디어 항목의 세부 정보를 가져와줘”
• 업로드 등록 — “media/2026/banner.png에 방금 업로드한 파일을 미디어 항목으로 등록해줘”
• 메타데이터 업데이트 — “히어로 이미지의 대체 텍스트를 ‘산 일몰’로 설정해줘”
• 파일 제거 — “오래된 배너 이미지를 삭제해줘”

검색

• 콘텐츠 찾기 — “‘접근성’을 언급하는 게시물을 검색해줘” 또는 “모든 컬렉션에서 TypeScript에 관한 모든 것을 찾아줘”

분류

• 탐색 — “모든 카테고리를 나열해줘” 또는 “태그를 보여줘”
• 용어 생성 — “‘튜토리얼’ 태그를 추가해줘” 또는 “‘엔지니어링’ 아래에 ‘프론트엔드’ 하위 카테고리를 만들어줘”
• 용어 이름 변경 — “‘frontend’ 카테고리의 이름을 ‘Web Frontend’로 변경해줘”
• 용어 이동 — “‘튜토리얼’ 태그를 ‘가이드’ 카테고리 아래로 이동해줘” 또는 “‘react’를 부모에서 분리해줘”
• 용어 삭제 — “사용하지 않는 ‘archive’ 태그를 삭제해줘”

메뉴

• 메뉴 보기 — “기본 탐색 메뉴를 보여줘” 또는 “바닥글 메뉴에 무엇이 있나요?”
• 메뉴 생성 — “새 ‘sidebar’ 메뉴를 만들어줘”
• 메뉴 편집 — “‘main’ 메뉴의 이름을 ‘기본 탐색’으로 변경해줘”
• 항목 설정 — “기본 메뉴의 항목을 홈, 블로그, 소개, 연락처로 교체해줘”
• 메뉴 삭제 — “사용하지 않는 ‘mobile’ 메뉴를 삭제해줘”

사이트 설정

• 검사 — “현재 사이트 제목이 무엇인가요?” 또는 “소셜 링크를 보여줘”
• 정체성 업데이트 — “사이트 제목을 ‘Acme Blog’로, 태그라인을 ‘팀의 이야기’로 설정해줘”
• 로고/파비콘 설정 — “이 이미지를 사이트 로고로 사용해줘” (media_create로 등록한 후)
• SEO 기본값 — “기본 OG 이미지를 새 배너로 설정해줘” 또는 “제목 구분 기호를 세로 막대로 업데이트해줘”
• 소셜 핸들 — “소셜 설정에 Mastodon 및 YouTube 링크를 추가해줘”

스키마 (관리자 전용)

• 검사 — “어떤 컬렉션이 있나요?” 또는 “게시물 컬렉션의 필드를 보여줘”
• 컬렉션 생성 — “이름 및 인용 필드가 있는 새 ‘testimonials’ 컬렉션을 만들어줘”
• 스키마 수정 — “게시물에 ‘featured’ 부울 필드를 추가해줘”

수정

• 히스토리 보기 — “이 게시물의 수정 히스토리를 보여줘”
• 복원 — “게시물을 이전 버전으로 복원해줘”

권한

AI 도구를 통해 할 수 있는 일은 EmDash 역할에 따라 다릅니다. AI 어시스턴트는 관리 패널에서 가지고 있는 것과 동일한 권한으로 작동합니다:

액세스 권한이 없는 작업을 시도하면 AI가 알려줍니다.

팁

• 컬렉션에 대해 구체적으로. 여러 컬렉션이 있는 경우 “게시물 만들기”가 아닌 “블로그 게시물 만들기”라고 말하세요.
• 먼저 스키마를 요청하세요. 컬렉션에 어떤 필드가 있는지 확실하지 않은 경우 콘텐츠를 생성하거나 편집하기 전에 “게시물 컬렉션에는 어떤 필드가 있나요?”라고 물어보세요.
• 게시하기 전에 검토하세요. AI에게 콘텐츠를 초안으로 만들도록 요청하고 관리 패널에서 검토한 다음 AI에게 게시하도록 요청하거나 직접 게시하세요.
• 검토를 위해 비교를 사용하세요. 게시하기 전에 “이 게시물의 라이브 및 초안 버전을 비교해줘”라고 물어 정확히 무엇이 변경될지 확인하세요.
• 리치 텍스트 필드는 Portable Text를 사용합니다. AI는 리치 텍스트 필드의 콘텐츠를 작성할 수 있지만 복잡한 서식은 관리 편집기에서 가장 잘 수행됩니다.

개발자용

MCP 서버 엔드포인트, 인증 방법, OAuth 검색, 도구 매개변수 및 오류 처리는 MCP 서버 참조에 문서화되어 있습니다.