# trello-mcp-server

Trello REST API를 감싸는 [MCP(Model Context Protocol)](https://modelcontextprotocol.io) 서버입니다.
Claude Desktop, Claude Code 등 MCP를 지원하는 클라이언트에 연결하면 채팅에서 Trello 보드/리스트/카드를 조회하고 생성·수정할 수 있습니다.

## 제공 도구

| 도구 | 설명 |
|---|---|
| `trello_list_boards` | 내 보드 목록 조회 |
| `trello_get_board` | 보드 상세 조회 |
| `trello_list_lists` | 보드 안의 리스트(컬럼) 조회 |
| `trello_list_cards_in_list` | 특정 리스트의 카드 조회 |
| `trello_list_cards_in_board` | 보드 전체 카드 조회 |
| `trello_get_card` | 카드 상세 조회 |
| `trello_search` | 카드/보드 키워드 검색 |
| `trello_create_card` | 카드 생성 |
| `trello_update_card` | 카드 수정(제목/설명/마감일/리스트 이동/보관) |
| `trello_add_comment` | 카드에 댓글 추가 |
| `trello_create_list` | 보드에 새 리스트 생성 |

## 1. Trello API Key / Token 발급

1. https://trello.com/app-key 접속 (Trello 로그인 필요)
2. 상단의 **API Key**를 복사 → `TRELLO_API_KEY`
3. 같은 페이지의 **Token** 링크를 클릭해 권한 위임 후 발급되는 토큰을 복사 → `TRELLO_TOKEN`

이 두 값은 계정 접근 권한을 가진 비밀값입니다. 코드에 직접 적지 말고 환경 변수로만 전달하세요.

## 2. 설치

```bash
git clone <이 저장소 URL>
cd trello-mcp-server
npm install
```

## 3. Claude Desktop / Claude Code에 등록

`claude_desktop_config.json` (또는 Claude Code의 MCP 설정)에 아래와 같이 추가합니다.

```json
{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/절대/경로/trello-mcp-server/src/index.js"],
      "env": {
        "TRELLO_API_KEY": "여기에_본인_API_KEY",
        "TRELLO_TOKEN": "여기에_본인_TOKEN"
      }
    }
  }
}
```

설정 후 Claude를 재시작하면 `trello_list_boards` 등의 도구를 채팅에서 바로 호출할 수 있습니다.

## GitHub에 공개할 때 주의할 점

- **API Key/Token을 절대 커밋하지 마세요.** 이 저장소의 `.gitignore`는 `.env` 파일을 제외하도록 되어 있지만, `claude_desktop_config.json`처럼 개인 설정 파일을 실수로 함께 커밋하지 않도록 주의하세요.
- 커밋 히스토리에 한 번이라도 토큰이 올라갔다면 git 히스토리에서 지우는 것만으로는 부족합니다 — Trello 계정 설정에서 해당 토큰을 즉시 폐기(revoke)하고 재발급하세요.
- 코드 자체는 Trello의 공개 REST API 문서를 참고해 직접 작성한 것이라 라이선스/저작권 문제는 없습니다. `package.json`의 라이선스는 원하는 대로(MIT 등) 바꿔도 됩니다.
- Trello/Atlassian 브랜드명을 프로젝트명에 쓰는 것 자체는 일반적으로 문제되지 않지만(수많은 오픈소스 커넥터가 이렇게 하고 있음), 로고 사용이나 "공식 Trello 제품"으로 오인될 수 있는 표현은 피하는 게 안전합니다.

## 참고

- Trello REST API 문서: https://developer.atlassian.com/cloud/trello/rest/
- Rate limit: 사용자 토큰 기준 10초당 100회, 앱 API 키 기준 10초당 300회 (초과 시 429 응답)