Supergateway를 갖춘 ClickUp MCP 서버

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

필수 조건

• Node.js 18 이상

• Docker 및 Docker Compose(컨테이너화된 배포용)

• ClickUp API 키 및 팀 ID

Related MCP server: ClickUp MCP Server

지역 개발

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 환경 변수를 구성합니다.