Storyblok MCP Server: AI Agent로 콘텐츠 관리 자동화

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

웹 개발

대상자

• 개발자 (API 통합 및 AI 도구 구축)
• 마케터/콘텐츠 크리에이터 (자연어로 콘텐츠 관리)
• AI 개발자 (LLM/에이전트와의 연동)
• 난이도: 중급 (Python, API 이해 필요)

핵심 요약

• 155+ MCP 툴을 통해 Storyblok Management API의 CRUD 기능을 AI 에이전트로 자동화 (예: Create, Read, Update, Delete)
• 모듈화된 아키텍처로 각 리소스(스토리, 컴포넌트 등)를 독립적인 툴 모듈로 관리
• FastMCP SDK와 Python HTTPX/AsyncIO 기반으로 빠른 비동기 처리 및 AI 도구 추상화

섹션별 세부 요약

1. 서론 및 목적

• AI 에이전트와 Storyblok Management API 간의 직접 연동을 위한 MCP 서버 구축
• 개발자, 마케터, 콘텐츠 크리에이터의 수동 API 작업 제거
• 155+ MCP 툴로 모든 Storyblok 리소스(스토리, 자산, 워크플로우 등)의 CRUD 지원

2. 주요 기능

• CRUD 기능
• Create: 새로운 스토리, 컴포넌트, 자산 등 생성
• Read: 모든 리소스의 데이터 읽기
• Update: 기존/새로운 리소스 업데이트
• Delete: 특정/전체 리소스 삭제
• 모듈화된 툴링
• 각 리소스(예: Stories, Assets)에 맞춤 툴 모듈 제공
• Meta Tool을 통해 런타임 시 모든 도구 목록 확인 가능
• 비동기 처리
• FastMCP 및 AsyncIO 기반으로 빠른 처리 성능

3. 구현 방법

• 설치 및 설정
• git clone 후 pip install -r requirements.txt
• .env 파일에 STORYBLOK_SPACE_ID, MANAGEMENT_TOKEN 등 입력
• Claude Desktop과 연동 시 uv run --with mcp 명령어 사용
• 테스트
• mcp run server.py로 로컬 테스트
• MCP Inspector를 통해 서버 디버깅

4. 사용 기술 및 의존성

• 프레임워크
• Python 3.x (HTTPX, AsyncIO)
• FastMCP (AI 도구 정의)
• Storyblok Management API (핵심 기능)
• 도구
• MCP Python SDK
• uv (Python 실행 도구)

5. 커버링 리소스

• Storyblok Management API의 주요 리소스
• Access Tokens, Activities, Approvals, Assets, Components, Releases, Workflows 등
• 120개 이상의 리소스에 대한 CRUD 기능 지원

결론

• MCP Server는 AI 에이전트와 Storyblok의 직접 연동을 통해 수동 API 작업을 대체
• FastMCP SDK와 모듈화된 아키텍처로 확장성과 유지보수성 향상
• git clone 후 .env 설정 및 Claude Desktop과의 연동으로 즉시 사용 가능

> 💡 실무 적용 시: MCP Inspector로 서버 디버깅, uv 설치 확인, 155+ MCP 툴의 활용을 통해 콘텐츠 자동화 가능