bitrix24-mcp-bridge 0.2.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +37 -8
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -65,18 +65,38 @@ daemon после любой правки, затрагивающей конфи
|
|
|
65
65
|
|
|
66
66
|
## Инструменты
|
|
67
67
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
68
|
+
Помимо `bitrix_help` / `bitrix_status` / `bitrix_call`, мост регистрирует типизированные обёртки
|
|
69
|
+
над каталогом (разумные дефолты + схема параметров). Регистрируются только те, чьё имя есть в
|
|
70
|
+
`actions.json`. Точная выборка — через необязательный `params` (мержится последним, перекрывает
|
|
71
|
+
дефолты). Каждый принимает необязательный `portal` (alias; по умолчанию — из `config.json`).
|
|
72
|
+
Обёртки в основном read-only; мутирующие помечены ⚠. `bitrix_call` выполняет любой разрешённый
|
|
73
|
+
каталогом вызов, включая мутирующие.
|
|
71
74
|
|
|
72
75
|
| Инструмент | Назначение |
|
|
73
76
|
|---|---|
|
|
74
|
-
| `bitrix_help` | справка по API/params (
|
|
75
|
-
| `bitrix_status` | какие порталы сконфигурированы и
|
|
76
|
-
| `bitrix_call` | любой разрешённый вызов из каталога по имени |
|
|
77
|
-
|
|
|
77
|
+
| `bitrix_help` | справка по API/params (= `docs/api-notes.md`) |
|
|
78
|
+
| `bitrix_status` | какие порталы сконфигурированы и подключены |
|
|
79
|
+
| `bitrix_call` | любой разрешённый вызов из каталога по имени (в т.ч. мутирующий) |
|
|
80
|
+
| *Задачи* | |
|
|
81
|
+
| `bitrix_tasks_list` / `bitrix_task_get` | список задач / карточка |
|
|
82
|
+
| `bitrix_task_get_v2` | карточка через v2-подсистему (JSON) |
|
|
83
|
+
| `bitrix_task_scrum_info` | scrum-инфо (спринт / эпик / story points) |
|
|
84
|
+
| `bitrix_task_files` | файлы задачи |
|
|
85
|
+
| `bitrix_task_views_count` | счётчик просмотров |
|
|
86
|
+
| `bitrix_task_subtasks` / `bitrix_task_related` | подзадачи / связанные задачи |
|
|
87
|
+
| *Проекты* | |
|
|
78
88
|
| `bitrix_projects_list` / `bitrix_project_get` | рабочие группы / проекты |
|
|
79
|
-
|
|
|
89
|
+
| *Чаты* | |
|
|
90
|
+
| `bitrix_chats_recent` | недавние чаты (REST) |
|
|
91
|
+
| `bitrix_recent_load` / `bitrix_recent_tail` | недавние по секции (в т.ч. `tasksTask` — чаты задач) + листание |
|
|
92
|
+
| `bitrix_chat_load` | открыть чат по `dialogId`/`chatId` |
|
|
93
|
+
| `bitrix_chat_messages` | последние сообщения чата |
|
|
94
|
+
| `bitrix_chat_history` | листать историю вглубь |
|
|
95
|
+
| `bitrix_chat_get_dialog_id` | резолв dialogId по externalId |
|
|
96
|
+
| `bitrix_chat_mark_read` ⚠ / `bitrix_chat_read_all` ⚠ | пометить сообщения / все чаты прочитанными |
|
|
97
|
+
| *Люди / поиск* | |
|
|
98
|
+
| `bitrix_user_get` | карточка пользователя |
|
|
99
|
+
| `bitrix_entity_selector` / `bitrix_entity_search` | загрузка селектора / текстовый поиск сущностей |
|
|
80
100
|
|
|
81
101
|
`bitrix_help` — единственный источник конвенций params (select/filter/order/пагинация,
|
|
82
102
|
имена полей). Он отдаёт `docs/api-notes.md`, так что любому агенту не нужен доступ к репозиторию.
|
|
@@ -173,6 +193,15 @@ bun run build:ext # dev-сборка пер-пользовател
|
|
|
173
193
|
`setup` затем копирует в runtime-домашнюю папку. Публикуемые файлы перечислены в `files`
|
|
174
194
|
(`dist`, `extension/dist`, `docs/api-notes.md`, `actions.example.json`).
|
|
175
195
|
|
|
196
|
+
### Релизы
|
|
197
|
+
|
|
198
|
+
Версионирование и публикация автоматизированы (conventional commits →
|
|
199
|
+
[release-please](.github/workflows/release-please.yml)): бот ведёт release-PR с bump'ом версии и
|
|
200
|
+
`CHANGELOG.md`; при его мерже создаётся GitHub Release/тег и пакет публикуется в npm через **OIDC
|
|
201
|
+
Trusted Publisher** (с provenance, без токенов). CI ([`.github/workflows/ci.yml`](.github/workflows/ci.yml))
|
|
202
|
+
гоняет `typecheck` + тесты на push/PR. Ручная до-публикация застрявшего релиза — `workflow_dispatch`
|
|
203
|
+
на `release-please`.
|
|
204
|
+
|
|
176
205
|
## Документация
|
|
177
206
|
|
|
178
207
|
- [docs/RUNBOOK.md](docs/RUNBOOK.md) — установка, настройка, повседневная работа, диагностика
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"type": "module",
|
|
3
3
|
"name": "bitrix24-mcp-bridge",
|
|
4
|
-
"version": "0.2.
|
|
4
|
+
"version": "0.2.1",
|
|
5
5
|
"description": "MCP bridge server for Bitrix24 — exposes REST API access, tasks, projects and chat to MCP clients like Claude Code.",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"repository": {
|