Work Integrations MCP

Это небольшой MCP-сервер, предоставляющий инструменты для работы с различными рабочими системами (сейчас Jira, в планах Slack/GitHub и другие).

Текущие инструменты

• jira_get_issue — получение задачи Jira по ключу

• jira_search — поиск в Jira с использованием JQL

• slack_get_message_by_url — получение сообщения Slack по URL

• slack_get_channel_history — получение недавних сообщений из Slack

• slack_find_channel — поиск ID канала по его названию

• slack_find_user — поиск пользователя по email или отображаемому имени

• confluence_get_page — получение страницы Confluence по ID (включает футер и встроенные комментарии с вложенными ответами)

• confluence_get_page_by_url — получение страницы Confluence по URL (включает футер и встроенные комментарии с вложенными ответами)

• confluence_search — поиск в Confluence с использованием CQL

Настройка

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. Зарегистрируйте MCP-сервер в Cursor (~/.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.

Примеры использования

• "Use jira_get_issue with key CVR-248"

• "Search Jira with JQL: project = CVR ORDER BY updated DESC"

• "Use slack_get_message_by_url with url https://..."

• "Use slack_get_channel_history with channel general"

• "Use slack_find_user with email user@company.com"

• "Use confluence_get_page with id 123456"

• "Use confluence_get_page_by_url with url https://.../wiki/..."

• "Use confluence_search with cql space = DOCS and type = page"

Примечания по настройке Slack

Создайте Slack-приложение и установите его в своем рабочем пространстве. Минимальные области доступа (scopes) для публичных каналов:

• channels:read

• channels:history

• users:read

• users:read.email

Для приватных каналов добавьте:

• groups:read

• groups:history

Расширение

Добавляйте новые инструменты для Slack, GitHub или других сервисов, создавая новую папку в services/ и регистрируя модуль в server.ts:

1. Создайте services/<service>/client.ts для аутентификации и вызовов API

2. Создайте services/<service>/tools.ts, экспортирующий ToolModule

3. Импортируйте модуль в server.ts и передайте его в mergeToolModules

4. При необходимости добавьте новые переменные окружения в конфигурацию MCP в Cursor

Сохраняйте названия инструментов неизменными, чтобы существующие промпты продолжали работать.