Trello MCP 서버

Trello 보드, 리스트 및 카드를 가져오고 상호작용하기 위한 도구를 제공하는 Model Context Protocol (MCP) 서버입니다.

기능

• 인증된 사용자의 모든 보드 가져오기

• 보드 세부 정보 가져오기

• 보드에서 리스트 가져오기

• 보드나 리스트에서 카드 가져오기

• 특정 카드 세부 정보 가져오기

• 보드 전체에서 카드 검색

• 카드 작업/기록 가져오기

Related MCP server: Trello MCP Server

설정

1. Trello API 자격 증명 얻기

중요: API 자격 증명을 얻으려면 Power-Up을 생성해야 합니다.

1. https://trello.com/power-ups/admin 방문

2. "Create New Power-Up" (또는 "Crear" 버튼) 클릭

3. 기본 정보 입력:

   • 이름: "Trello MCP" (또는 원하는 이름)

   • 워크스페이스: 워크스페이스 선택

4. 생성 후, Power-Up 설정의 "API Key" 섹션으로 이동

5. API Key가 표시됩니다 (32자 문자열)

6. "Token" 링크(또는 설명의 "token")를 클릭하여 API 토큰 생성

7. 메시지가 표시되면 토큰 승인

8. API key와 API token 모두 복사

이미 Power-Up이 생성되어 있다면 https://trello.com/app-key 로 바로 이동할 수도 있습니다.

2. 의존성 설치

npm install

3. 환경 변수 구성

예제 환경 파일을 복사하고 자격 증명을 추가하세요:

cp .env.example .env

.env를 편집하고 자격 증명을 추가하세요:

TRELLO_API_KEY=your_actual_api_key
TRELLO_API_TOKEN=your_actual_api_token

4. 서버 테스트

서버를 직접 실행하세요:

npm start

구성

이 MCP 서버는 Claude Desktop에서 전역으로 구성하거나 Claude Code CLI에서 프로젝트별로 구성할 수 있습니다.

옵션 1: 전역 구성 (Claude Desktop)

Claude Desktop 구성 파일을 편집하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

다음 구성을 추가하세요:

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/absolute/path/to/trello-mcp/index.js"],
      "env": {
        "TRELLO_API_KEY": "your_api_key_here",
        "TRELLO_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

/absolute/path/to/trello-mcp/를 이 디렉토리의 실제 경로로 바꾸세요.

구성을 추가한 후 Claude Desktop을 다시 시작하세요.

옵션 2: 프로젝트별 구성 (Claude Code CLI)

Claude Code CLI의 경우, MCP 서버는 ~/.claude.json에서 프로젝트별로 구성됩니다.

중요: type: "stdio" 필드와 env 변수를 구성에 직접 포함해야 합니다. .env 파일은 자동으로 로드되지 않습니다.

특정 프로젝트에 대해 구성하려면 이 명령어를 사용하세요:

# Using jq to add the configuration
jq '.projects."/path/to/your/project".mcpServers.trello = {
  "type": "stdio",
  "command": "node",
  "args": ["/Users/ehigu/Documents/Esteban/Projects/habitus/webapp/trello-mcp/index.js"],
  "env": {
    "TRELLO_API_KEY": "your_api_key_here",
    "TRELLO_API_TOKEN": "your_api_token_here"
  }
}' ~/.claude.json > /tmp/claude_config.json && mv /tmp/claude_config.json ~/.claude.json

또는 ~/.claude.json을 수동으로 편집하세요:

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "trello": {
          "type": "stdio",
          "command": "node",
          "args": ["/Users/ehigu/Documents/Esteban/Projects/habitus/webapp/trello-mcp/index.js"],
          "env": {
            "TRELLO_API_KEY": "your_api_key_here",
            "TRELLO_API_TOKEN": "your_api_token_here"
          }
        }
      }
    }
  }
}

구성을 추가한 후 Claude Code를 다시 시작하세요.

사용 가능한 도구

get_my_boards

인증된 사용자의 모든 보드를 가져옵니다.

매개변수:

• filter (선택 사항): 유형별로 보드 필터링 (all, open, closed, starred, organization, public, members). 기본값: "open"

get_board

특정 보드의 세부 정보를 가져옵니다.

매개변수:

• board_id (필수): 보드의 ID

get_board_lists

보드의 모든 리스트를 가져옵니다.

매개변수:

• board_id (필수): 보드의 ID

• filter (선택 사항): 리스트 필터링 (all, open, closed, none). 기본값: "open"

get_board_cards

보드의 모든 카드를 가져옵니다.

매개변수:

• board_id (필수): 보드의 ID

get_list_cards

특정 리스트의 모든 카드를 가져옵니다.

매개변수:

• list_id (필수): 리스트의 ID

get_card

특정 카드의 세부 정보를 가져옵니다.

매개변수:

• card_id (필수): 카드의 ID

search_cards

모든 보드에서 카드를 검색합니다.

매개변수:

• query (필수): 검색 쿼리

• board_ids (선택 사항): 검색할 보드 ID (쉼표로 구분)

get_card_actions

특정 카드의 작업(활동/기록)을 가져옵니다.

매개변수:

• card_id (필수): 카드의 ID

사용 예시

Claude Desktop에 구성되면 자연어를 사용하여 Trello 보드와 상호작용할 수 있습니다:

• "내 모든 열린 Trello 보드 보여줘"

• "[board_id] 보드에서 카드 가져와"

• "'bug fix'가 포함된 카드 검색해"

• "[card_id] 카드의 세부 정보 보여줘"

• "내 보드에 있는 리스트는 뭐야?"

문제 해결

인증 오류

인증 오류가 발생하면:

1. API 키와 토큰이 올바른지 확인하세요

2. 토큰이 만료되지 않았는지 확인하세요

3. 필요한 경우 https://trello.com/app-key 에서 토큰을 다시 생성하세요

서버가 시작되지 않음

1. Node.js가 설치되어 있는지 확인하세요: node --version

2. 의존성이 설치되어 있는지 확인하세요: npm install

3. 환경 변수가 올바르게 설정되었는지 확인하세요

MCP 서버가 "Failed" 상태로 표시됨

Claude Code에서 MCP 서버가 "failed"로 표시되는 경우:

1. type 필드 누락: 구성에 "type": "stdio"가 포함되어 있는지 확인하세요. Claude Code CLI에 필수입니다.

2. 환경 변수가 로드되지 않음: Claude Code가 MCP 서버를 실행할 때 .env 파일은 자동으로 로드되지 않습니다. API 자격 증명이 포함된 env 객체를 구성에 직접 포함해야 합니다:

   {
     "type": "stdio",
     "command": "node",
     "args": ["/path/to/trello-mcp/index.js"],
     "env": {
       "TRELLO_API_KEY": "your_api_key",
       "TRELLO_API_TOKEN": "your_api_token"
     }
   }

3. 로그 확인: claude --debug를 실행하여 자세한 오류 로그를 확인하세요

4. 수동 테스트: 서버를 직접 실행하여 작동하는지 확인하세요:

   cd /path/to/trello-mcp
   TRELLO_API_KEY=your_key TRELLO_API_TOKEN=your_token node index.js

5. Claude Code 다시 시작: 구성 변경 후 Claude Code를 완전히 종료하고 다시 시작하세요

MCP 서버가 Claude에 표시되지 않음

1. 구성의 경로가 절대 경로이며 올바른지 확인하세요

2. Claude Desktop/Code를 완전히 다시 시작하세요

3. Claude Desktop 로그에서 오류를 확인하세요

4. Claude Code CLI의 경우, 구성이 ~/.claude.json의 올바른 프로젝트 경로에 있는지 확인하세요

라이선스

MIT