Contentful Automation
Contentful 헤드리스 CMS 공간을 Claude Code에서 직접 관리하세요. 터미널을 떠나지 않고 공간을 나열하고, 메타데이터를 조회하며, 구성을 업데이트할 수 있습니다.
툴킷 문서: composio.dev/toolkits/contentful
설정
- Composio MCP 서버를 설정에 추가하세요:
https://rube.app/mcp - 안내에 따라 Contentful 계정을 연결하세요. 에이전트가 인증 링크를 제공합니다. 액세스 토큰에 공간 관리 권한이 있는지 확인하세요.
핵심 워크플로
1. 모든 공간 나열
인증된 계정에 액세스 가능한 모든 Contentful 공간을 확인합니다. 이는 일반적으로 첫 번째 작업이며, 대부분의 다른 작업에는 space_id가 필요합니다.
도구: CONTENTFUL_LIST_SPACES
주요 파라미터:
limit(1-1000) -- 반환할 최대 공간 수 (기본값: 100)skip-- 페이지네이션을 위해 건너뛸 공간 수order-- 정렬 필드 (예:sys.createdAt또는 내림차순-sys.createdAt)
예시 프롬프트: "내 모든 Contentful 공간을 나열해줘"
2. 공간 세부 정보 조회
특정 공간의 상세 메타데이터를 조회합니다. 업데이트에 필요한 현재 sys.version이 포함됩니다.
도구: CONTENTFUL_GET_SPACE
주요 파라미터:
space_id(필수) -- 조회할 공간의 ID (영숫자, 1-64자)
예시 프롬프트: "Contentful 공간 abc123def의 세부 정보를 가져와줘"
3. 공간 이름 업데이트
특정 공간의 이름을 업데이트합니다. 동시 수정 충돌을 방지하기 위해 낙관적 잠금을 위해 현재 버전 번호가 필요합니다.
도구: CONTENTFUL_UPDATE_SPACE
주요 파라미터:
space_id(필수) -- 업데이트할 공간의 IDname(필수) -- 공간의 새 이름 (1-255자)version(필수) --sys.version의 현재 공간 버전 (0보다 커야 함)
예시 프롬프트: "Contentful 공간 abc123def의 이름을 '프로덕션 콘텐츠 허브'로 변경해줘"
4. 공간 인벤토리 감사
공간 나열과 세부 조회를 결합하여 조직의 Contentful 공간을 감사합니다.
도구: CONTENTFUL_LIST_SPACES 후 CONTENTFUL_GET_SPACE
워크플로:
- 모든 공간을 나열하여 ID와 이름을 가져옵니다.
- 각 공간의 세부 정보를 가져와 버전 정보, 생성일, 메타데이터를 확인합니다.
예시 프롬프트: "모든 Contentful 공간을 감사해줘 -- 생성일과 현재 버전과 함께 나열해줘"
알려진 문제점
- 업데이트 시 버전 충돌:
CONTENTFUL_UPDATE_SPACE는CONTENTFUL_GET_SPACE에서 가져온 최신sys.version이 필요합니다. 읽기와 쓰기 사이에 다른 사람이 공간을 수정하면 버전 충돌로 업데이트가 실패합니다. 업데이트 직전에 항상 공간 정보를 가져오세요. - 많은 공간의 페이지네이션:
CONTENTFUL_LIST_SPACES는limit및skip파라미터를 사용합니다. 공간이 많을 경우 더 이상 결과가 반환되지 않을 때까지skip을 증가시켜 반복하면 공간을 놓치지 않습니다. - 범위 제한: 이 도구는 공간 수준 메타데이터(이름)만 관리합니다. 공간 내 항목, 콘텐츠 유형 또는 에셋을 생성하거나 수정할 수 없습니다.
- 인증/권한 불일치:
CONTENTFUL_GET_SPACE로 읽기가 성공하더라도 토큰에 공간 관리 권한이 없으면CONTENTFUL_UPDATE_SPACE로 업데이트가 실패합니다. 토큰에 쓰기 권한이 있는지 확인하세요. - Space ID 형식:
space_id는^[a-zA-Z0-9-_.]{1,64}$패턴과 일치해야 합니다. 유효하지 않은 문자는 거부됩니다.
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
CONTENTFUL_LIST_SPACES | 계정에 액세스 가능한 모든 공간 나열 |
CONTENTFUL_GET_SPACE | 단일 공간의 상세 메타데이터 조회 |
CONTENTFUL_UPDATE_SPACE | 공간 이름 업데이트 (버전 필요) |
Composio 제공