Bitrix24 用 MCP サーバー

41 ツール · 約 870 アクション · Bitrix24 REST 1.0 + 3.0 · 88 テスト

Bitrix24 プラットフォーム用の MCP サーバー。 Bitrix24 REST API（CRM、タスク、チャット、ファイル、カレンダー、人事、スマート プロセス、メール、テレフォニー、ワークフロー、イベント、オープンライン、チャットボット、ドキュメント ジェネレーター、見積、通貨、Web フォーム、トラッキング、在庫）を、AI エージェントが直接呼び出せる 41 のツールにラップし、ポータル上で実際の呼び出しを実行します（ドキュメントを提供するだけの 公式 Bitrix24 MCP とは異なります）。

インストール · MCP クライアント設定 · 機能 · ツール · シナリオ · 開発 · npm パッケージ

言語: English · Русский

ポータルとサブスクリプション

この MCP サーバーは Bitrix24 REST API をラップします。 Bitrix24 はオールインワンのワークスペースです。CRM、タスク、プロジェクト、チャット、ビデオ 通話、ドキュメント、メール、カレンダー、人事、ビジネスプロセス、テレフォニーなどに対応しています。 クラウド（*.bitrix24.ru / *.bitrix24.com）とオンプレミスの両方で利用できます。

⚠️ このサーバーを使用するには Bitrix24 ポータルが必要です。 受信 Web フック （BX24_WEBHOOK_URL）または OAuth アプリケーション （BX24_DOMAIN + BX24_CLIENT_ID + BX24_CLIENT_SECRET + BX24_REFRESH_TOKEN）のいずれかが必要です。ポータルの 開発者リソース → 受信 Web フック で Web フックを作成するか、oauth.bitrix24.ru で OAuth アプリを登録してください。

➡️ 詳細: bitrix24.com · REST ドキュメント: apidocs.bitrix24.ru

Related MCP server: fast-bitrix24-mcp

対応 API バージョン

インストール

前提条件

• Node.js 18+

• アクティブな Bitrix24 ポータル（クラウドまたはオンプレミス）

• 認証情報: 受信 Web フック または OAuth アプリ（下記参照）

npm からインストール

npm install -g mcp-b24
# or run without installing
npx -y mcp-b24

環境変数

次のいずれかを設定できます:

• BX24_WEBHOOK_URL を設定 — 最も簡単で、Web フック作成者として動作します。リフレッシュは不要です。または

• BX24_DOMAIN + OAuth 認証情報を設定 — サーバーがアクセストークン（有効期間約 1 時間）を自動更新し、OAuth 応答の client_endpoint に従います。

破壊的操作の確認

BX24_CONFIRM_DESTRUCTIVE=true が設定されている場合、サーバーは破壊的操作（削除、削除、完了、退出、キック、キャンセル、停止、クローズ、ミュート、バインド解除、クリア、markDeleted、kill など）を実行する前に、明示的な confirm: true パラメータを要求します。これがない場合、ツールは構造化された requiresConfirmation プレビューを返し、実行はされません。AI エージェントによる偶発的なデータ損失を防ぎます。実行されたすべての破壊的操作は JSONL 監査ログ（BX24_AUDIT_LOG）に書き込まれます。未設定または false の場合、破壊的操作は確認なしで実行されます（デフォルト）。

MCP クライアント設定

Claude Desktop

claude_desktop_config.json に追加:

npx（推奨）:

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": ["-y", "mcp-b24"],
      "env": {
        "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/",
        "BX24_CONFIRM_DESTRUCTIVE": "true"
      }
    }
  }
}

OAuth:

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": ["-y", "mcp-b24"],
      "env": {
        "BX24_MODE": "oauth",
        "BX24_DOMAIN": "portal.bitrix24.ru",
        "BX24_CLIENT_ID": "app.abc123",
        "BX24_CLIENT_SECRET": "******",
        "BX24_REFRESH_TOKEN": "******"
      }
    }
  }
}

Windows — cmd /c を使用:

{
  "mcpServers": {
    "bitrix24": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-b24"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

Docker:

docker build -t mcp/bitrix24 .

{
  "mcpServers": {
    "bitrix24": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "BX24_WEBHOOK_URL", "mcp/bitrix24"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

Streamable HTTP:

BX24_TRANSPORT=http BX24_HTTP_PORT=3000 BX24_WEBHOOK_URL="https://..." npx mcp-b24
# serves http://127.0.0.1:3000/mcp

Cursor

.cursor/mcp.json に追加:

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": ["-y", "mcp-b24"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

VS Code

.vscode/mcp.json に追加（注: トップレベルのキーは mcpServers ではなく servers です）:

{
  "servers": {
    "bitrix24": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-b24"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

Codex CLI

codex mcp add bitrix24 --env BX24_WEBHOOK_URL=https://portal.bitrix24.ru/rest/1/abcd1234/ -- npx -y mcp-b24

ソースから

git clone https://github.com/kostikpenzin/mcp_b24.git
cd mcp_b24
npm install
npm run build

{
  "mcpServers": {
    "bitrix24": {
      "command": "node",
      "args": ["/absolute/path/to/mcp_b24/dist/index.js"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

ツール概要

41 ツール、約 870 アクション

各ドメインツールはアクションベースです：action列挙型が操作を選択します （例：action: "add"、"list"、"update"、"delete"）。完全なアクション一覧： docs/en/TOOLS_REFERENCE.md（RU：docs/ru/）。

機能

MCPサーバーはロシア語と英語の自然言語を理解します。ツール名やアクション列挙型を知る必要はありません — プレーンな言語でやりたいことを説明すれば、AIエージェントが適切なツールとアクションにマッピングします。

できること

• CRM — リード、連絡先、会社、取引、見積の作成/検索/更新；パイプライン間での取引移動；アクティビティ管理（通話/会議）；商品行；カスタムフィールド；支払詳細＋銀行詳細；重複の検索＆マージ；スマートプロセス；ドキュメント生成；通貨；Webフォーム；トラッキング；住所；コールリスト；自動化トリガー；ステージ履歴

• タスク＆プロジェクト — タスクの作成、完了、委任、延期；チェックリスト；コメント；経過時間；フロー；かんばんステージ；プランナー；依存関係；ユーザーフィールド；グループ/プロジェクト＋テーマの管理

• チャット＆メッセンジャー — チャット作成、メンバーの追加/削除、メッセージの送信/編集/削除、リアクション、検索、カウンター、通知、最近；オープンライン（設定、セッション、オペレーター）；チャットボットv2（登録、コマンド、ファイル）

• ファイル（ディスク） — ファイルのアップロード/ダウンロード/移動/コピー、フォルダー一覧、バージョン、共有、公開リンク、権限、添付オブジェクト

• カレンダー — イベント、セクション、会議、リソース、空き状況、設定

• HR＆組織 — ユーザー、部署、勤務時間＋時間管理＋ネットワーク範囲＋スケジュール、招待/解雇/異動

• ビジネス — ユニバーサルリスト＋セクション、メール（メッセージ→タスク/イベント/チャット/CRM含む）、レポート、マーケティング、ワークフロー＋ロボット/アクティビティCRUD、テレフォニー（通話、SIP、voximplantコールバック/インフォコール/TTS/回線/統計）、イベント

• 商品カタログ — 商品、セクション、価格、価格タイプ、単位、VAT、比率、丸めルール、追加料金、在庫ドキュメント、商品プロパティ、バリエーション（オファー）、SKUヘッド、サービス、在庫記録（bizproc）、テレフォニー、イベント購読

• バッチ＆汎用 — 最大50件の呼び出しを結合；任意のRESTメソッドを名前で呼び出し

セキュリティ

• 認証情報（webhookシークレット、OAuthトークン）はAIエージェントに決して公開されず、ツール結果にも返されません

• 破壊的なアクションには明示的なconfirm: trueが必要な場合があります（BX24_CONFIRM_DESTRUCTIVE=true）。これらはJSONL監査ログに書き込まれます

• レート制限はトークンバケット方式で尊重されます。QUERY_LIMIT_EXCEEDED（503）とOPERATION_TIME_LIMIT（429）はバックオフ付きで再試行されます

• パスワード管理と認証/ログインアクションは除外されています — 認証は環境変数によって自動的に処理されます

使用シナリオ

1. リードを作成

あなたの発言： 「リードを作成：イワン・ペトロフ、電話+79001234567、メールivan@example.ru」

AIエージェントはbx24_crm_leadsをaction: "add"で呼び出し、 fields = { TITLE: "Ivan Petrov", PHONE: [{ VALUE: "+79001234567", VALUE_TYPE: "WORK" }], EMAIL: [...] }を設定します。

2. 今日の自分のタスクを表示

あなたの発言： 「Покажи мои задачи на сегодня」

AIエージェントはbx24_tasksをaction: "list"で呼び出し、 RESPONSIBLE_ID = currentとDEADLINE = todayでフィルタリングします。

3. 取引をパイプライン間で移動

あなたの発言： 「Передвинь сделку №456 на стадию «В работе»」

AIエージェントはbx24_crm_dealsをaction: "update"で呼び出し、 STAGE_IDを設定します（ステージはaction: "category_list"で一覧表示できます）。

4. チャットにメッセージを送信

あなたの発言： 「Напиши в чат «Проект Альфа»: релиз сегодня в 18:00」

AIエージェントはbx24_im_chatをaction: "sendMessage"で呼び出します （DIALOG_ID = chatNNN、MESSAGE = "…"）。

5. ファイルをアップロードしてリンクを共有

あなたの発言： 「Загрузи PDF-договор на Диск в папку «Договоры 2026» и скинь ссылку в чат «Партнёры»」

AIエージェントは：bx24_disk → file_upload、次にfile_getExternalLink、 その後bx24_im_chat → sendMessageを実行します。

6. 承認ワークフローを開始

あなたの発言： 「Запусти бизнес-процесс «Согласование с юристами» для сделки #456」

AIエージェントはbx24_workflowsをaction: "start"で呼び出し、 templateIdとdocumentId = ["crm", "DEAL", 456]を設定します。

7. セールスファネルを分析

あなたの言葉: 「売上」ファネルのレポートを作成してください：ステージ別の取引、平均チェック

AIエージェントはbx24_crm_deals action: "list"（CATEGORY_IDでフィルタリング ）とbx24_reports action: "funnel_stages"を呼び出し、集計します。

開発

npm install          # Install dependencies
npm run build        # Compile TypeScript + chmod +x
npm run dev          # Watch mode
npm test             # Run 88 tests (vitest)
npm run test:coverage
npm start            # Run server
docker build -t mcp/bitrix24 .   # Docker image
npm publish          # Publish to npm (auto clean + build + test)

プロジェクト構造

mcp_b24/
├── src/
│   ├── index.ts          # MCP server entry point (transport selection)
│   ├── server.ts         # MCP server: register/list/call + instructions
│   ├── config.ts         # Environment configuration (BX24_*)
│   ├── api-client.ts     # HTTP client: webhook/OAuth, refresh, backoff, token-bucket
│   ├── error.ts          # Error handling
│   ├── types.ts          # Shared types
│   ├── i18n/             # ru.ts, en.ts, index.ts
│   ├── audit/log.ts      # JSONL audit of destructive + auth events
│   ├── utils/            # logger, tokenBucket
│   ├── transport.ts      # stdio + Streamable HTTP
│   └── tools/
│       ├── framework.ts  # Data-driven action-tool framework
│       ├── params.ts     # Reusable param schemas
│       ├── index.ts      # Tool registration (41 tools)
│       ├── batch.ts      # bx24_batch
│       ├── call.ts       # bx24_call (escape-hatch)
│       ├── crm/          # 10 CRM tools
│       ├── collab/       # 7 collab tools
│       ├── org/         # 4 org tools
│       └── biz/          # 7 biz tools
├── docs/                 # en/ + ru/ (USER_GUIDE, SELLER_GUIDE, DEVELOPER_GUIDE, TOOLS_REFERENCE, AUDIT_LOG)
├── i18n/README.ru.md     # Russian README
├── specs/openapi.yaml    # OpenAPI overview
├── Dockerfile            # Multi-stage Docker build
├── docker-compose.yml
├── .env.example
├── LICENSE
├── CHANGELOG.md
├── package.json
└── tsconfig.json

ライセンス

MIT

著者

Penzin Konstantin — GitHub · penzin85@gmail.com