MCPTrello

제한된 소수의 엄선된 Trello 도구를 제공하는 MCP(Model Context Protocol) 서버입니다. 에이전트가 수동으로 붙여넣은 컨텍스트 없이 Trello board를 읽고 간단히 업데이트할 수 있으며, 도구 설명이 에이전트의 동작을 어떻게 결정하는지 학습하기 위한 연습도구이기도 합니다(각 도구의 설계 근거는 DESIGN_NOTES.md 참조).

Tools

이 v1에서는 완전한 CRUD, 원격/OAuth 인증, 속도 제한, MCP 리소스/프롬프트, cc-init 명령, 체크리스트 자동 생성, 호출 간 보드/목록 이름 캐싱은 지원하지 않습니다.

Related MCP server: trello-mcp-server

Setup

1. Trello 자격 증명 가져오기

1. https://trello.com/power-ups/admin로 이동하여 API key를 얻으려면 Power-Up을 생성하거나(선택) 그리고문.

2. 같은 key 페이지에서 "Token" 링크를 따라 토큰도 생성하는 동시에, 이 키가 Trello 계정을 대신하여 작업할 수 있도록 인증받아야 합니다.

2. 환경 설정

cp .env.example .env

..env를 채우기:

TRELLO_API_KEY=...
TRELLO_TOKEN=...
DEFAULT_BOARD_ID=...   # optional — id of the board to use when `board` is omitted

DEFAULT_BOARD_ID는 선택사항입니다. 보드가 필요한 도구는 이 값이 없으면 보드를 직접 전달하거나(search_card의 경우) 접근가능한 모든 보드를 검색해야 합니다.

3. 설치 및 빌드

Node.js **18+**가 필요합니다.

npm install
npm run build

4. Claude Code에 등록

claude mcp add trello -- node <absolute-path-to-repo>\dist\index.js

검증

" npm run build — TypeScript 빌드를 수행합니다. 소스 변경 후 실행합니다. " npm run verify — 내장된 서버를 stdio 하위 프로세스로 시작하며, MCP SDK 자체 Client + StdioClientTransport 를 사용하여 모든 도구체를 나열하고 각각을 실제 Trello 계정에 대해 호출합니다(각 도구별 오류/모호한 경우 포함). 완전히 채우진 .env 필요 — 실 API 호출을 우발합니다. " MCP Inspector(npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list)는 보조적이고, 최상의 실행 방식입니다. 게시된 모든 Inspector 버전명은 Node ≥23.7.5가 필요하며; Node 18에서는 스타투전 실패합니다. 실행하려면 이 프로젝트의 런타임 요구 사항을 업그레이드하는 대신 별도 Node 20+ 설치(예: nvm)를 사용하세요.