Work Integrations MCP

여러 업무 시스템을 위한 도구를 제공하는 소규모 MCP 서버입니다 (현재 Jira 지원, Slack/GitHub 등 계획 중).

현재 도구

• jira_get_issue - 키를 사용하여 Jira 이슈 가져오기

• jira_search - JQL을 사용하여 Jira 검색

• slack_get_message_by_url - URL을 사용하여 Slack 메시지 가져오기

• slack_get_channel_history - 최근 Slack 메시지 가져오기

• slack_find_channel - 채널 이름을 ID로 확인

• slack_find_user - 이메일 또는 표시 이름으로 사용자 확인

• confluence_get_page - ID를 사용하여 Confluence 페이지 가져오기 (바닥글 + 중첩된 답글이 포함된 인라인 댓글 포함)

• confluence_get_page_by_url - URL을 사용하여 Confluence 페이지 가져오기 (바닥글 + 중첩된 답글이 포함된 인라인 댓글 포함)

• confluence_search - CQL을 사용하여 Confluence 검색

설정

1. 의존성 설치:

   • npm install

2. 환경 변수 구성 (예시):

   • JIRA_BASE=https://company.atlassian.net

   • JIRA_EMAIL=you@company.com

   • JIRA_TOKEN=your_api_token

   • JIRA_API_VERSION=3

   • SLACK_TOKEN=xoxb-your-slack-bot-token

   • CONFLUENCE_BASE=https://company.atlassian.net/wiki

   • CONFLUENCE_EMAIL=you@company.com

   • CONFLUENCE_TOKEN=your_api_token

3. Cursor에 MCP 서버 등록 (~/.cursor/mcp.json):

   {
     "mcpServers": {
       "work-integrations-mcp": {
         "command": "npx",
         "args": [
           "tsx",
           "/ABS/PATH/jira-mcp/server.ts"
         ],
         "env": {
           "JIRA_BASE": "https://company.atlassian.net",
           "JIRA_EMAIL": "you@company.com",
           "JIRA_TOKEN": "your_api_token",
           "JIRA_API_VERSION": "3",
          "SLACK_TOKEN": "xoxb-your-slack-bot-token",
          "CONFLUENCE_BASE": "https://company.atlassian.net/wiki",
          "CONFLUENCE_EMAIL": "you@company.com",
          "CONFLUENCE_TOKEN": "your_api_token"
         }
       }
     }
   }

4. Cursor 재시작.

사용 예시

• "jira_get_issue를 사용하여 키 CVR-248의 이슈를 가져와줘"

• "JQL로 Jira 검색: project = CVR ORDER BY updated DESC"

• "slack_get_message_by_url을 사용하여 URL https://...의 메시지를 가져와줘"

• "slack_get_channel_history를 사용하여 채널 general의 기록을 가져와줘"

• "slack_find_user를 사용하여 이메일 user@company.com인 사용자를 찾아줘"

• "confluence_get_page를 사용하여 ID 123456의 페이지를 가져와줘"

• "confluence_get_page_by_url을 사용하여 URL https://.../wiki/...의 페이지를 가져와줘"

• "confluence_search를 사용하여 CQL space = DOCS and type = page로 검색해줘"

Slack 설정 참고 사항

Slack 앱을 생성하고 워크스페이스에 설치하세요. 공개 채널에 대한 최소 범위(Scope)는 다음과 같습니다:

• channels:read

• channels:history

• users:read

• users:read.email

비공개 채널의 경우 다음을 추가하세요:

• groups:read

• groups:history

확장

services/ 아래에 새 폴더를 추가하고 server.ts에 모듈을 등록하여 Slack, GitHub 또는 기타 서비스용 새 도구를 추가할 수 있습니다:

1. 인증 및 API 호출을 위해 services/<service>/client.ts 생성

2. ToolModule을 내보내는 services/<service>/tools.ts 생성

3. server.ts에서 모듈을 가져와 mergeToolModules에 전달

4. 필요한 경우 Cursor MCP 구성에 새 환경 변수 추가

기존 프롬프트가 계속 작동하도록 도구 이름을 안정적으로 유지하세요.