@x0333/bitrix24-mcp-server 2.3.0 → 2.3.1

package/.github/workflows/publish-npm.yml

@@ -0,0 +1,50 @@
+name: Publish to npm
+
+on:
+  push:
+    branches: [main, master]
+    paths:
+      - "package.json"
+  workflow_dispatch:
+
+concurrency:
+  group: npm-publish-${{ github.repository }}
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Compare local version with npm latest
+        id: version
+        run: |
+          set -euo pipefail
+          LOCAL=$(node -p "require('./package.json').version")
+          NAME=$(node -p "require('./package.json').name")
+          NPM_VER=$(npm view "$NAME" version 2>/dev/null || echo "0.0.0")
+          echo "Package: $NAME"
+          echo "Local version: $LOCAL"
+          echo "npm latest: $NPM_VER"
+          MATCH=$(npx -y semver@7 -r ">$NPM_VER" "$LOCAL" 2>/dev/null || true)
+          if [ "$MATCH" = "$LOCAL" ]; then
+            echo "should_publish=true" >> "$GITHUB_OUTPUT"
+            echo "Will publish: $LOCAL is newer than $NPM_VER"
+          else
+            echo "should_publish=false" >> "$GITHUB_OUTPUT"
+            echo "Skip publish: $LOCAL is not newer than $NPM_VER"
+          fi
+
+      - name: npm publish
+        if: steps.version.outputs.should_publish == 'true'
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/README.md

@@ -19,6 +19,12 @@ MCP-сервер для работы с Bitrix24 через входящий в
 - **search_groups** — рабочие группы и проекты по подстроке имени (`sonet_group.get.json`, фильтр `%NAME`).
 - **get_group** — данные группы или проекта по ID (`sonet_group.get.json`, фильтр `ID`).
 - **get_kanban_stages_by_group** — стадии канбана задач для группы по её ID (`task.stages.get`, в теле запроса `entityId` = ID группы).
+- **get_task_comments** — «комментарии» задачи в **новой карточке задач** (чат задачи): цепочка `tasks.task.get` → `im.dialog.messages.get`. Сначала **самые свежие** сообщения, если не передавать курсоры пагинации.
+  - Параметры: **`task_id`** (обязательно), **`limit`** (1–50, по умолчанию 20), опционально **`first_id`** (Bitrix `FIRST_ID`, следующая страница **старее**) или **`last_id`** (`LAST_ID`, сообщения **новее** id) — оба курсора одновременно нельзя.
+  - В ответе урезанные массивы: **`messages`** — только `id`, `author_id`, `text`, `date`; **`users`** — только `id`, `name`, `work_position`, `email`. Есть **`agent_instructions`** для модели и **`pagination`** с подсказками `suggested_next_first_id` / `suggested_next_last_id`.
+  - **`author_id === 0`** — системные сообщения чата (смена стадии, учёт времени и т.п.), это **не** пользовательский комментарий; в **`users`** для них строки обычно нет. Для **`author_id > 0`** сопоставляй с **`users[].id`**.
+
+Если в `tasks.task.get` на обычном URL `.../rest/USER/WEBHOOK/` нет **`chatId`**, сервер **сам** повторит запрос к `.../rest/api/USER/WEBHOOK/` (тот же вебхук, другой префикс пути).
 
 Все вызовы к Bitrix24 идут как `POST` на `{B24_BASE}/{метод}` с JSON-телом, как в документации REST.
 
@@ -65,7 +71,8 @@ B24_BASE="https://your-domain.bitrix24.ru/rest/USER_ID/WEBHOOK_CODE/" npx -y @x0
 4. Выдайте вебхуку нужные права (минимум для текущих инструментов):
    - задачи (в т.ч. стадии канбана групповых задач);
    - рабочие группы / проекты;
-   - пользователи (для профиля).
+   - пользователи (для профиля);
+   - **чаты и мессенджер (im)** — для **`get_task_comments`** (`im.dialog.messages.get`).
 5. Скопируйте **URL для вызова REST API**.
 
 Обычно он выглядит примерно так:

package/index.js

@@ -24,6 +24,21 @@ if (!B24_BASE) {
   process.exit(1);
 }
 
+function bitrixPortalUrlFromBase(base) {
+  try {
+    const u = new URL(String(base).trim());
+    if (!u.host) return null;
+    return `${u.protocol}//${u.host}`;
+  } catch {
+    return null;
+  }
+}
+
+const B24_PORTAL_URL = bitrixPortalUrlFromBase(B24_BASE);
+const mcpInstructions = B24_PORTAL_URL
+  ? `Bitrix24 address: ${B24_PORTAL_URL}`
+  : "Bitrix24 address: take scheme and host from B24_BASE (the part before /rest/ in the webhook URL).";
+
 const server = new Server(
   {
     name: "bitrix24-mcp-server",
@@ -33,6 +48,7 @@ const server = new Server(
     capabilities: {
       tools: {},
     },
+    instructions: mcpInstructions,
   }
 );
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x0333/bitrix24-mcp-server",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Bitrix24 MCP Server for AI Agent Integration.",
   "main": "index.js",
   "bin": {