curl -X POST https://www.deckbase.co/api/mcp \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

다음을 YOUR_ACCESS_TOKEN 사용자의 OAuth 토큰으로 교체하세요: 연결 페이지. 설정 방법은 다음을 참조하세요: MCP 설정 가이드.

API 개요

Deckbase는 두 가지 통합 경로를 제공합니다: AI 기반 덱 및 카드 관리용 MCP 서버와 프로그래밍 방식 접근용 REST API 엔드포인트입니다.

덱과 카드를 배치로 생성, 업데이트, 삭제
ElevenLabs와 이미지 모델을 통해 카드용 AI 오디오와 이미지 생성
블록 스냅샷과 메타데이터를 포함한 전체 덱 데이터 내보내기
유연한 블록 레이아웃으로 사용자 지정 템플릿 구축
덱 및 카드 변경에 대한 webhook 이벤트 수신

여기서 시작하기

MCP 클라이언트 연결

설정 가이드를 사용해 Cursor, VS Code, Claude Code 또는 다른 MCP 호환 클라이언트에 Deckbase 인증을 구성하세요.

먼저 스키마 검증

대량으로 카드를 생성하기 전에 템플릿 스키마와 필수 필드를 확인해 생성된 레코드의 일관성을 유지하세요.

단계적 배치 실행

작은 쓰기 배치로 시작하고 결과를 샘플링한 뒤, 카드 품질과 중복률이 양호해진 후에만 확장하세요.

모범 사례

카드 생성을 운영 파이프라인으로 다루기

요청 로그를 보관하고, 쓰기 전에 필수 템플릿 필드를 검증하며, 배치 크기를 늘리기 전에 생성된 카드를 샘플 검사하세요.

하나의 표준 템플릿 전략 정의

팀이라면 하나의 표준 템플릿 전략과 하나의 재시도 정책을 정의하세요. 이렇게 하면 프롬프트 드리프트 중복을 방지하고 매퍼 규칙이 바뀔 때 인시던트 대응이 훨씬 빨라집니다.

권장 읽기 순서 따르기

먼저 설정 페이지, 두 번째로 MCP 서버 참조, 그다음 프로덕션 롤아웃 점검 순서입니다. 이 경로는 카드 생성 중 인증 실수와 스키마 불일치 오류를 최소화합니다.

저장소에 규칙 문서화

팀 워크플로우를 구현 중이라면 템플릿 규칙과 배치 승인 기준을 저장소에 직접 문서화해 이후 업데이트의 일관성을 유지하세요.

주간 운영 점검 실행

자동화 규모를 확장하기 전에 최근 쓰기 실패, 템플릿 드리프트, 중복 프롬프트 비율을 확인하세요.

통합 체크리스트 버전 관리

통합 체크리스트를 버전 관리해 두면 새 기여자 온보딩 시 이전 MCP 설정 결정을 역추적할 필요가 없습니다.

롤백 실행 가이드 포함

가능하면 롤백과 실패 배치 재처리를 위한 짧은 실행 가이드를 포함해 템플릿이 바뀌어도 프로덕션 업데이트가 안전하게 유지되도록 하세요.

자주 묻는 질문

Deckbase MCP 서버란 무엇인가요?

Model Context Protocol(MCP) 서버를 사용하면 Cursor, Claude Code, VS Code 같은 AI 도구가 문서를 읽고 덱을 나열하며 카드를 프로그래밍 방식으로 생성할 수 있습니다. 표준 JSON-RPC over HTTP를 사용합니다.

Deckbase MCP를 사용하려면 코딩 경험이 필요한가요?

아니요. 대시보드의 연결 페이지에서 OAuth로 로그인하면 준비 완료입니다. AI 도구의 자연어 프롬프트로 작업하며, 기술적인 부분은 MCP 서버가 처리합니다.

어떤 AI 도구가 Deckbase MCP를 지원하나요?

Cursor, Claude Code, MCP 확장이 설치된 VS Code, Windsurf, 그리고 Model Context Protocol을 지원하는 다른 모든 클라이언트입니다.

Deckbase API는 무료인가요?

MCP 및 API 접근은 Basic, Pro, VIP 등 모든 유료 플랜에 포함됩니다. 구독 후 연결 페이지에서 OAuth로 로그인하면 됩니다.

가이드와 아티클은 다음을 참조하세요: 리소스