AI 도구와 Tabple 연결하기
개인 연결 토큰을 발급해 외부 작업 도구에서 Tabple 데이터를 안전하게 사용할 수 있습니다.
연결 토큰 발급
설정 → 연동 → MCP
프로필 아바타 > 설정 > 연동의 MCP 카드에서 토큰 이름을 적고 '발급'을 누릅니다. 최대 5개까지 만들 수 있고 365일 동안 유효하며, 토큰은 발급할 때 한 번만 보이고 이후에는 다시 확인할 수 없습니다.
읽기 전용 토큰
조회만 필요하다면 발급할 때 '읽기 전용 토큰으로 발급'을 켜세요. 생성·수정·삭제 도구 10개가 막혀 AI 가 데이터를 읽기만 합니다. 토큰은 만든 사람의 권한 안에서만 동작하므로 보기 권한만 있는 프로젝트에서는 아무것도 바꾸지 못합니다.
토큰 폐기
토큰 카드의 '폐기' 버튼으로 즉시 무효화하세요. 폐기 후 같은 토큰으로는 어떤 요청도 통과하지 않습니다.
Claude Desktop / Cursor 설정
claude_desktop_config.json 편집
Claude Desktop 설정 파일에 Tabple MCP 서버를 추가합니다. macOS 기준 경로: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"tabple": {
"command": "npx",
"args": ["mcp-remote", "https://tabple.com/api/mcp", "--header", "Authorization:${AUTH_HEADER}"],
"env": {
"AUTH_HEADER": "Bearer YOUR_PAT_HERE"
}
}
}
}Claude 재시작
Claude Desktop 을 완전히 재시작하면 'tabple' 서버가 도구 목록에 나타납니다. Cursor·VS Code·Claude Code·Codex·Gemini CLI 는 형식이 달라서, MCP 카드의 '클라이언트 설정'에서 쓰는 도구를 고르면 그 도구용 설정을 복사할 수 있습니다.
사용할 수 있는 20개 도구
- list_projects — 내 프로젝트 목록
- list_columns — 프로젝트 보드 컬럼 목록 (태스크 생성·이동에 쓸 ID 확인)
- get_tasks / create_task / update_task — 태스크 조회·생성·수정
- list_pages / get_page — 위키 페이지 트리와 페이지 본문 조회
- get_wiki_block_guide — 위키 블록 형식 안내
- create_page / update_page / delete_page — 위키 페이지 생성·수정·삭제(하위 포함)
- get_project_stats — 프로젝트 통계 (태스크 수·진행률)
- search — 내가 접근할 수 있는 프로젝트의 태스크·위키·기능 명세 검색
- get_prd / update_prd — PRD 조회·부분 수정 (제공한 필드만 갱신)
- list_features / create_feature / update_feature / delete_feature — 기능 명세 CRUD (level 1-3 계층)
- link_feature_task — 기능 명세 ↔ 태스크 연결/해제 (action=link|unlink)
한도
사용할 수 있는 플랜
MCP 연결은 저장 공간 100GB(Pro) 플랜과 평생 라이선스(Lifetime)에서 쓸 수 있습니다. MCP 는 탭플의 AI 호출을 쓰지 않아 AI 추가팩이 필요 없고, Free·저장 공간 20GB(Starter) 플랜의 연결 요청은 거절됩니다.
호출 한도
분 30회 / 시 300회 / 일 5,000회입니다. 여러 도구를 이어 부르는 에이전트 작업에도 넉넉합니다.
한도 초과 시
429 응답 + Retry-After 헤더가 반환됩니다. AI 에이전트는 자동으로 백오프합니다.