AI 도구

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

MCP 서버

MCP 서버는 기본적으로 활성화되어 있습니다 — /_emdash/api/mcp의 라우트는 명시적으로 비활성화하지 않는 한 마운트됩니다. 항상 인증이 필요하므로 유효한 자격 증명 없이는 콘텐츠가 노출되지 않습니다.

비활성화하려면 Astro 구성에서 mcp: false를 설정하세요:

emdash({
  mcp: false,
})

설정

사이트의 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에 방금 업로드한 파일을 미디어 항목으로 등록해줘”
• 메타데이터 업데이트 — “히어로 이미지의 alt 텍스트를 ‘산 일몰’로 설정해줘”
• 파일 삭제 — “오래된 배너 이미지를 삭제해줘”

검색

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

분류 체계

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

메뉴

• 메뉴 보기 — “메인 내비게이션 메뉴를 보여줘” 또는 “푸터 메뉴에 무엇이 있어?”
• 메뉴 생성 — “새 ‘사이드바’ 메뉴를 만들어줘”
• 메뉴 편집 — “‘메인’ 메뉴를 ‘기본 내비게이션’으로 이름 변경해줘”
• 항목 설정 — “메인 메뉴의 항목을 홈, 블로그, 소개, 연락처로 교체해줘”
• 메뉴 삭제 — “사용하지 않는 ‘모바일’ 메뉴를 삭제해줘”

사이트 설정

• 확인 — “현재 사이트 제목이 뭐야?” 또는 “소셜 링크를 보여줘”
• 아이덴티티 업데이트 — “사이트 제목을 ‘Acme Blog’로, 태그라인을 ‘팀의 이야기’로 설정해줘”
• 로고 / 파비콘 설정 — “이 이미지를 사이트 로고로 사용해줘” (media_upload로 업로드 후)
• SEO 기본값 — “기본 OG 이미지를 새 배너로 설정해줘” 또는 “제목 구분자를 세로 막대로 업데이트해줘”
• 소셜 계정 — “Mastodon과 YouTube 링크를 소셜 설정에 추가해줘”

스키마 (관리자 전용)

• 확인 — “어떤 컬렉션이 있어?” 또는 “게시물 컬렉션의 필드를 보여줘”
• 컬렉션 생성 — “이름과 인용문 필드가 있는 새 ‘추천 후기’ 컬렉션을 만들어줘”
• 스키마 수정 — “게시물에 ‘추천’ 불리언 필드를 추가해줘”

리비전

• 이력 보기 — “이 게시물의 리비전 이력을 보여줘”
• 복원 — “게시물을 이전 버전으로 복원해줘”

권한

MCP 클라이언트가 OAuth 동의 페이지를 열면 요청된 모든 권한이 기본적으로 선택되어 있습니다. 접근을 승인하기 전에 클라이언트가 필요하지 않은 권한의 선택을 해제하세요. 결과 토큰은 선택을 유지한 권한과 EmDash 역할에서 허용하는 권한으로 제한되므로, 더 적은 권한을 부여해도 클라이언트가 할 수 있는 것이 늘어나지 않습니다.

접근 권한이 없는 것을 시도하면 AI가 알려줍니다.

팁

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

개발자를 위한 정보

MCP 서버 엔드포인트, 인증 방법, OAuth 디스커버리, 도구 매개변수, 오류 처리는 MCP 서버 레퍼런스에 문서화되어 있습니다.