Trello MCP 서버
AI 호스트를 통해 Trello 보드, 목록 및 카드와 상호 작용할 수 있는 강력한 MCP 서버입니다.
목차
필수 조건
- Python 3.12 이상에서는
uv 로 쉽게 관리할 수 있습니다. - 데스크탑용 Claude 설치됨
- Trello 계정 및 API 자격 증명
- uv 패키지 관리자가 설치되었습니다
사전 설치
- Claude Desktop App을 설치했는지 확인하세요
- 귀하가 이미 Claude 계정으로 로그인했는지 확인하세요.
- 클로드 시작
설치
- Trello API 자격 증명을 설정하세요.
- Trello 앱 관리 로 이동
- New Power-Up 또는 Integration 에서 새 통합을 만듭니다.
- 정보를 입력하고(Iframe 커넥터 URL은 비워둘 수 있음) 올바른 작업 공간을 선택했는지 확인하세요.
- 앱 아이콘을 클릭하고 왼쪽 사이드바에서 "API 키"로 이동합니다.
- "API 키"를 복사하고 오른쪽에 있는 "토큰을 수동으로 생성할 수 있습니다."라는 문구를 클릭하면 Trello 토큰을 받을 수 있습니다.
- 프로젝트 루트에 있는
.env.example 파일의 이름을 .env 로 바꾸고 방금 얻은 변수를 설정합니다.
지엑스피1
- 아직 uv를 설치하지 않았다면 설치하세요:
curl -LsSf https://astral.sh/uv/install.sh | sh
- 이 저장소를 복제하세요:
git clone https://github.com/m0xai/trello-mcp-server.git
cd trello-mcp-server
- uv::를 사용하여 종속성을 설치하고 Claude의 서버를 설정합니다.
uv run mcp install main.py
- Claude Desktop 앱을 다시 시작하세요
서버 모드
이 MCP 서버는 두 가지 모드로 실행될 수 있습니다.
클로드 앱 모드
이 모드는 Claude Desktop 애플리케이션과 직접 통합됩니다.
.env 파일에서 USE_CLAUDE_APP=true 설정합니다(이것이 기본값입니다)- 다음을 사용하여 서버를 실행합니다.
uv run mcp install main.py
- Claude Desktop 애플리케이션을 다시 시작하세요
SSE 서버 모드
이 모드는 Cursor를 포함한 모든 MCP 호환 클라이언트와 함께 사용할 수 있는 독립형 SSE 서버로 실행됩니다.
.env 파일에서 USE_CLAUDE_APP=false 설정하세요.- 다음을 사용하여 서버를 실행합니다.
- 서버는 기본적으로
http://localhost:8000 (또는 구성된 포트)에서 사용할 수 있습니다.
도커 모드
Docker Compose를 사용하여 서버를 실행할 수도 있습니다.
- Docker와 Docker Compose가 설치되어 있는지 확인하세요.
- 구성으로
.env 파일을 만듭니다. - 컨테이너를 빌드하고 시작합니다.
- 서버는 기본적으로 SSE 모드로 실행됩니다.
- 로그를 보려면:
- 서버를 중지하려면:
구성
서버는 .env 파일의 환경 변수를 사용하여 구성할 수 있습니다.
| 변하기 쉬운 | 설명 | 기본 |
|---|
| 트렐로_API_키 | Trello API 키 | 필수의 |
| 트렐로 토큰 | Trello API 토큰 | 필수의 |
| MCP_서버_이름 | MCP 서버의 이름 | Trello MCP 서버 |
| MCP_서버_호스트 | SSE 모드의 호스트 주소 | 0.0.0.0 |
| MCP_서버_포트 | SSE 모드용 포트 | 8000 |
| 사용_클라우드_앱 | Claude 앱 모드를 사용할지 여부 | 진실 |
.env 파일에서 이 값을 편집하여 서버를 사용자 지정할 수 있습니다.
클라이언트 통합
Claude Desktop과 함께 사용
- Claude 앱 모드에서 서버를 실행합니다(
USE_CLAUDE_APP=true ) - Claude Desktop을 시작하거나 다시 시작하세요
- Claude는 자동으로 MCP 서버를 감지하고 연결합니다.
커서와 함께 사용
MCP 서버를 Cursor에 연결하려면:
- SSE 모드에서 서버를 실행합니다(
USE_CLAUDE_APP=false ) - 커서에서 설정(기어 아이콘) > AI > 모델 컨텍스트 프로토콜로 이동합니다.
- URL
http://localhost:8000 (또는 구성된 호스트/포트)을 사용하여 새 서버를 추가합니다. - 커서 AI 기능 사용 시 서버를 선택하세요
커서 설정 JSON 파일(일반적으로 ~/.cursor/mcp.json )에 이 구성을 추가할 수도 있습니다.
{
"mcpServers": {
"trello": {
"url": "http://localhost:8000/sse"
}
}
}
다른 MCP 클라이언트와 함께 사용
다른 MCP 호환 클라이언트의 경우 http://localhost:8000 의 SSE 엔드포인트를 가리키세요.
최소 클라이언트 예
SSE 엔드포인트에 연결하는 최소한의 Python 예제는 다음과 같습니다.
import asyncio
import httpx
async def connect_to_mcp_server():
url = "http://localhost:8000/sse"
headers = {"Accept": "text/event-stream"}
async with httpx.AsyncClient() as client:
async with client.stream("GET", url, headers=headers) as response:
# Get the session ID from the first SSE message
session_id = None
async for line in response.aiter_lines():
if line.startswith("data:"):
data = line[5:].strip()
if "session_id=" in data and not session_id:
session_id = data.split("session_id=")[1]
# Send a message using the session ID
message_url = f"http://localhost:8000/messages/?session_id={session_id}"
message = {
"role": "user",
"content": {
"type": "text",
"text": "Show me my Trello boards"
}
}
await client.post(message_url, json=message)
if __name__ == "__main__":
asyncio.run(connect_to_mcp_server())
역량
| 작업 | 판자 | 목록 | 카드 | 체크리스트 | 체크리스트 항목 |
|---|
| 읽다 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 쓰다 | ❌ | ✅ | ✅ | ✅ | ✅ |
| 업데이트 | ❌ | ✅ | ✅ | ✅ | ✅ |
| 삭제 | ❌ | ✅ | ✅ | ✅ | ✅ |
자세한 기능
이사회 운영
- ✅ 모든 게시판을 읽어보세요
- ✅ 특정 보드 세부 정보를 읽어보세요
목록 작업
- ✅ 보드의 모든 목록을 읽어보세요
- ✅ 특정 목록 세부 정보를 읽어보세요
- ✅ 새로운 목록 만들기
- ✅ 목록 이름 업데이트
- ✅ 목록 보관(삭제)
카드 운영
- ✅ 목록에 있는 모든 카드를 읽어보세요
- ✅ 특정 카드 세부 정보를 읽어보세요
- ✅ 새로운 카드 만들기
- ✅ 카드 속성 업데이트
- ✅ 카드 삭제
체크리스트 작업
- ✅ 특정 체크리스트를 받으세요
- ✅ 모든 체크리스트를 카드에 나열하세요
- ✅ 새로운 체크리스트를 만드세요
- ✅ 체크리스트 업데이트
- ✅ 체크리스트 삭제
- ✅ 체크리스트에 체크항목 추가
- ✅ 체크항목 업데이트
- ✅ 체크 항목 삭제
용법
설치가 완료되면 Claude를 통해 Trello 보드와 소통할 수 있습니다. 다음은 몇 가지 쿼리 예시입니다.
- "내 모든 보드를 보여줘"
- "[board_name] 보드에는 어떤 목록이 있나요?"
- "[list_name] 목록에 [title]이라는 제목으로 새 카드를 만듭니다."
- "[카드 이름] 카드 설명을 업데이트하세요"
- "[list_name] 목록을 보관합니다."
제가 사용한 예시는 다음과 같습니다.
문제 해결
문제가 발생하는 경우:
.env 파일에서 Trello API 자격 증명을 확인하세요.- Trello 작업 공간에 적절한 권한이 있는지 확인하세요.
- Claude for Desktop이 최신 버전을 실행하고 있는지 확인하세요.
uv run mcp dev main.py 명령으로 발생한 오류 메시지가 있는지 로그를 확인하세요.- uv가 제대로 설치되었고 PATH에 있는지 확인하세요.
기여하다
문제점과 개선 요청을 자유롭게 제출하세요!