Prismic 자동화은(는) 무엇을 하나요?
Claude Code에서 바로 Prismic 헤드리스 CMS를 관리하세요. 유형별 문서 쿼리, 전체 텍스트 검색, 사용자 정의 유형 검사, 콘텐츠 버전 관리를 위한 리포지토리 참조 작업을 수행할 수 있습니다.
도구 키트 문서: composio.dev/toolkits/prismic
설정
- 구성에 Composio MCP 서버를 추가합니다:
https://rube.app/mcp - 메시지가 표시되면 Prismic 계정을 연결합니다. 에이전트가 인증 링크를 제공합니다.
- 대부분의 콘텐츠 쿼리에는
ref토큰이 필요합니다. 항상PRISMIC_REPOSITORY_API_GET_REFS또는PRISMIC_REPOSITORY_API_GET_INFO를 호출하여 마스터 ref를 얻는 것으로 시작하세요.
핵심 워크플로
1. 리포지토리 정보 및 Ref 가져오기
사용 가능한 ref(콘텐츠 버전), 사용자 정의 유형, 언어, 태그 및 책갈피를 포함한 포괄적인 리포지토리 메타데이터를 검색합니다. 일반적으로 첫 번째 API 호출입니다.
도구: PRISMIC_REPOSITORY_API_GET_INFO, PRISMIC_REPOSITORY_API_GET_REFS
매개변수가 필요하지 않습니다. 이 엔드포인트는 전체 리포지토리 구성을 반환합니다. 모든 콘텐츠 쿼리에 ref가 필요하므로 refs 필드는 매우 중요합니다.
프롬프트 예시: "내 Prismic 리포지토리 정보와 현재 마스터 ref를 가져와줘"
2. 조건자(Predicate)로 문서 쿼리하기
전체 페이지 매김 및 필터링 지원과 함께 Prismic의 조건자 쿼리 구문을 사용하여 문서를 가져옵니다.
도구: PRISMIC_CONTENT_API_QUERY_DOCUMENTS
주요 매개변수:
ref(필수) -- 콘텐츠 릴리스 참조 ID (일반적으로 마스터 ref)q-- 조건자 쿼리, 예:[[at(document.type, "page")]]page(최소 1) 및pageSize(1-100) -- 페이지 매김lang-- 언어 코드, 예:en-us(기본값*는 모든 언어)orderings-- 정렬 순서, 예:[my.article.date desc]fetch-- 가져올 필드 목록(쉼표로 구분), 응답 크기 감소fetchLinks-- 연결된 문서 필드를 인라인으로 해석
프롬프트 예시: "Prismic에서 게시된 모든 블로그 게시물을 날짜 내림차순, 영어로 쿼리해줘"
3. 유형별 문서 가져오기
자동 마스터 ref 해석과 함께 특정 사용자 정의 유형의 모든 문서를 검색합니다.
도구: PRISMIC_GET_DOCUMENTS_BY_TYPE
주요 매개변수:
type(필수) -- 사용자 정의 유형 API ID, 예:blog_post,article,pagepage(기본값 1) 및pageSize(1-100, 기본값 20)lang-- 언어 코드 필터orderings-- 정렬 순서, 예:[my.article.date desc]after-- 50페이지 이후의 깊은 페이지 매김을 위한 커서 기반 페이지 매김
프롬프트 예시: "Prismic에서 blog_post 문서를 20개씩 가져와줘"
4. 전체 텍스트 검색
지정된 용어에 대해 문서의 모든 텍스트 필드를 검색합니다. 대소문자를 구분하지 않으며 어근 단어와 일치합니다.
도구: PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_FULLTEXT_SEARCH
주요 매개변수:
q(필수) -- 전체 텍스트 조건자, 예:[[fulltext(document, "machine learning")]]page,pageSize,lang,orderings-- 다른 쿼리와 동일한 페이지 매김/필터링
프롬프트 예시: "Prismic 문서에서 'machine learning'을 검색해줘"
5. ID로 단일 문서 가져오기
고유 식별자로 특정 문서를 검색합니다.
도구: PRISMIC_GET_DOCUMENT_BY_ID
주요 매개변수:
document_id(필수) -- 고유 문서 식별자ref(필수) -- 리포지토리의 콘텐츠 reflang-- 선택적 언어 필터
프롬프트 예시: "Prismic 문서 Xx2KLhEAAJljVWaA를 가져와줘"
6. 사용자 정의 유형 나열
리포지토리에 정의된 모든 사용자 정의 유형(콘텐츠 모델)과 그 구조 정의를 검색합니다.
도구: PRISMIC_TYPES_API_GET_TYPES
주요 매개변수:
limit-- 페이지당 반환할 최대 유형 수page-- 페이지 번호 (1부터 시작)sort-- 정렬 순서, 예:name
프롬프트 예시: "내 Prismic 리포지토리의 모든 사용자 정의 유형을 나열해줘"
알려진 문제점
- 모든 콘텐츠 쿼리에는 Ref가 필요합니다: 문서를 쿼리하기 전에
PRISMIC_REPOSITORY_API_GET_REFS또는PRISMIC_REPOSITORY_API_GET_INFO에서 유효한ref(일반적으로 마스터 ref)를 얻어야 합니다. ref 없이 쿼리하면 실패합니다. - 조건자 구문에는 이중 대괄호가 필요합니다: Prismic 쿼리는 이중 대괄호를 사용합니다:
[[at(document.type, "page")]]. 여러 조건자의 경우 결합하세요:[[at(document.type, "blog")][at(document.tags, ["featured"])]]. - 깊은 페이지 매김 제한: 표준 페이지 기반 페이지 매김은 50페이지 이후에 실패할 수 있습니다. 깊은 페이지 매김을 위해서는 이전 결과 세트의 마지막 문서 ID와 함께
after매개변수를 사용하세요. - pageSize 최대값은 100입니다: 페이지당 100개 이상의 문서를 요청하면 거부됩니다. 페이지 매김을 사용하여 더 큰 결과 세트를 반복하세요.
- 언어 필터링: 기본 언어 필터는
*(모든 언어)입니다. 특정 로케일의 문서가 필요한 경우 항상lang을 명시적으로 전달하세요(예:en-us,fr-fr). - 통합 필드에는 별도의 ref가 필요합니다:
PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_INTEGRATION_FIELDS를 사용할 때는 표준 콘텐츠ref외에integrationFieldsRef가 필요합니다.
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
PRISMIC_REPOSITORY_API_GET_INFO | 리포지토리 메타데이터, ref, 유형, 언어 가져오기 |
PRISMIC_REPOSITORY_API_GET_REFS | 모든 ref(마스터 + 릴리스) 나열 |
PRISMIC_TYPES_API_GET_TYPES | 모든 사용자 정의 유형/콘텐츠 모델 나열 |
PRISMIC_CONTENT_API_QUERY_DOCUMENTS | 조건자 및 페이지 매김으로 문서 쿼리 |
PRISMIC_GET_DOCUMENTS_BY_TYPE | 사용자 정의 유형별로 필터링된 문서 가져오기 |
PRISMIC_GET_DOCUMENT_BY_ID | ID로 단일 문서 검색 |
PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_FULLTEXT_SEARCH | 모든 문서에서 전체 텍스트 검색 |
PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_PREDICATES | 여러 조건자 조건으로 문서 필터링 |
PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_INTEGRATION_FIELDS | 통합 필드 데이터가 있는 문서 가져오기 |
PRISMIC_GET_DOCUMENTS_ORDERED | 지정된 필드로 정렬된 문서 가져오기 |
Composio 제공