ClickUp MCP Server

Supergateway를 갖춘 ClickUp MCP 서버

이 통합은 Supergateway를 통해 ClickUp MCP 서버를 실행하여 n8n 노드나 다른 클라이언트에서 사용할 수 있는 SSE 엔드포인트로 노출합니다.

필수 조건

• Node.js 18 이상
• Docker 및 Docker Compose(컨테이너화된 배포용)
• ClickUp API 키 및 팀 ID

지역 개발

Node.js로 실행하기

1. 종속성 설치:지엑스피1
2. 환경 변수 설정:
   export CLICKUP_API_KEY=pk_94547006_D8DFEXXFDOX7RUOJBBPLM2BSVRFXPZE9 export CLICKUP_TEAM_ID=2357720
3. 통합 스크립트를 실행합니다.
   ./run-clickup-mcp.sh
4. 구성 사용자 정의(선택 사항):
   ./run-clickup-mcp.sh --port 9000 --base-url http://example.com --cors "http://localhost:8080,http://localhost:3000"

Docker Compose로 실행

1. .env.example 기반으로 .env 파일을 만듭니다.
   cp .env.example .env
2. ClickUp API 키와 팀 ID로 .env 파일을 편집합니다.
3. 컨테이너를 시작합니다.
   docker-compose up -d
4. 로그 보기:
   docker-compose logs -f

철도 배치

1. 철도에 대한 새로운 프로젝트를 만듭니다.
2. GitHub 저장소를 연결하거나 Railway CLI를 사용하여 배포합니다.
3. Railway에서 다음 환경 변수를 설정하세요.
   • CLICKUP_API_KEY : ClickUp API 키
   • CLICKUP_TEAM_ID : ClickUp 팀 ID
   • PORT : 8000(또는 선호하는 포트)
   • BASE_URL : 철도 앱 URL(예: https://your-app-name.up.railway.app )
   • SSE_PATH : /sse (또는 선호하는 경로)
   • MESSAGE_PATH : /message (또는 선호하는 경로)
   • LOG_LEVEL : info (또는 더 자세한 로깅을 위한 debug)
   • DOCUMENT_SUPPORT : false (필요한 경우 true)
   • CORS_ORIGINS : * (또는 허용된 출처의 쉼표로 구분된 목록)
4. 애플리케이션을 배포합니다.

n8n과 함께 사용

1. n8n에서 새로운 "MCP" 노드를 추가합니다.
2. 다음 설정으로 노드를 구성하세요.
   • 서버 URL: 철도 앱 URL + SSE 경로(예: https://your-app-name.up.railway.app/sse )
   • 메시지 경로: 메시지 경로(예: /message)
3. 사용 가능한 도구 중에서 원하는 ClickUp 도구를 선택하세요.
4. 필요에 따라 도구 매개변수를 구성합니다.
5. 노드를 워크플로에 연결합니다.

API 엔드포인트

• SSE 엔드포인트 : {BASE_URL}{SSE_PATH} (예: http://localhost:8000/sse )
  • 방법: GET
  • 설명: 서버에서 보낸 이벤트 구독
• 메시지 종단점 : {BASE_URL}{MESSAGE_PATH} (예: http://localhost:8000/message )
  • 방법: POST
  • 설명: 서버로 메시지 보내기
  • 콘텐츠 유형: application/json
  • 본문: JSON-RPC 2.0 형식 메시지
• Healthcheck 엔드포인트 : {BASE_URL}/healthz (예: http://localhost:8000/healthz )
  • 방법: GET
  • 설명: 서비스가 정상적으로 실행되고 있는지 확인하세요
  • 응답: 서비스가 정상이면 "ok"

문제 해결

• 연결 문제 : 방화벽이 지정된 포트로의 연결을 허용하는지 확인하세요.
• 인증 오류 : ClickUp API 키와 팀 ID가 올바른지 확인하세요.
• CORS 오류 : 클라이언트의 출처를 포함하도록 CORS_ORIGINS 환경 변수를 구성합니다.