trello-mcp

Claude Code가 Trello 티켓(보드, 리스트, 카드, 댓글, 체크리스트, 라벨, 멤버)을 관리할 수 있게 해주는 로컬 MCP 서버(stdio)입니다.

설정

1. API 키 및 토큰 가져오기

Trello 파워업 관리자 페이지에서 이미 API 키를 가지고 계실 것입니다. 또한 토큰(OAuth 시크릿이 아님)이 필요합니다.

브라우저에서 다음 URL을 열고 <API_KEY>를 교체하세요:

https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=ClaudeMCP&key=<API_KEY>

승인 후 생성된 토큰을 복사하세요.

2. .env 구성

cp .env.example .env
$EDITOR .env   # paste TRELLO_API_KEY and TRELLO_TOKEN

TRELLO_DEFAULT_BOARD는 선택 사항입니다. 보드 ID로 설정하면 board_id 인수를 생략할 때 해당 보드가 사용됩니다. 보드 ID를 찾으려면 브라우저에서 보드를 열고 URL 끝에 .json을 추가하거나, 서버 실행 후 list_boards를 호출하세요.

3. 의존성 설치

uv sync

4. Claude Code에 등록

claude mcp add trello --scope user -- \
  uv run --directory "$(pwd)" trello-mcp

확인:

claude mcp list

열려 있는 모든 Claude Code 세션을 다시 시작한 다음, Claude에서 /mcp를 실행하세요. 16개의 도구가 연결된 trello가 표시되어야 합니다.

도구

읽기: list_boards, list_lists, list_cards, get_card, list_labels, list_board_members

카드 CRUD: create_card, update_card, move_card, archive_card

주석: add_comment, add_checklist, add_checklist_item, set_check_item, add_label, assign_member

수동 스모크 테스트

uv run fastmcp dev src/trello_mcp/server.py

MCP Inspector가 열립니다. 먼저 list_boards를 시도해 보세요.