Mcp Server For Bitrix24

mcp-bitrix24

Bitrix24 のタスク、ワークグループ、ユーザー向け MCP サーバーです。STDIO 経由で MCP/JSON-RPC を実装しています。

機能

• タスク：作成、更新、クローズ、再開、一覧表示
• ワークグループ：作成、一覧表示
• ユーザー：一覧表示、現在のユーザー、利用可能なフィールド
• タスクのフィールド：利用可能なフィールド、および create_task.fields の検証

要件

• Node.js >= 18
• Bitrix24 のWebhook URL

インストール／ビルド

npm install
npm run build

npm 経由で実行します：

npx mcp-bitrix24

設定

環境変数で Bitrix24 のWebhook URLを設定します：

BITRIX24_WEBHOOK_URL=https://<your-domain>/rest/<user_id>/<webhook>/

Codex MCP 設定の例：

[mcp_servers.bitrix24]
command = "npx"
args = ["-y", "mcp-bitrix24"]

[mcp_servers.bitrix24.env]
BITRIX24_WEBHOOK_URL = "https://<your-domain>/rest/<user_id>/<webhook>/"

ツール

タスク

• create_task

  • 入力：title（string、必須）、description?（string）、responsible_id?（number）、group_id?（number）、fields?（object）
  • 出力：{ task_id: number }
  • 注意：fields が指定されている場合、キーは get_task_fields に基づいて検証されます。

• update_task

  • 入力：task_id（number、必須）と、次のいずれか1つ以上：title?、description?、responsible_id?、group_id?
  • 出力：{ task_id: number }

• close_task

  • 入力：task_id（number、必須）
  • 出力：{ task_id: number }

• reopen_task

  • 入力：task_id（number、必須）
  • 出力：{ task_id: number }

• list_tasks

  • 入力：responsible_id?（number）、group_id?（number）、start?（number）、limit?（number）
  • 出力：{ tasks: [{ id, title, status }] }

• get_task_fields

  • 入力：{}
  • 出力：{ fields: { [field: string]: object } }

• list_task_history

  • 入力：task_id（number、必須）、filter?（object）、order?（object）
  • 出力：{ list: [ { id, createdDate, field, value, user } ] }

ワークグループ

• create_group

  • 入力：name（string、必須）、description?（string）
  • 出力：{ group_id: number }

• list_groups

  • 入力：limit?（number）
  • 出力：{ groups: [{ id, name }] }

ユーザー

• list_users

  • 入力：
    • filter?（object）
    • sort?（string）
    • order?（"ASC" | "DESC"）
    • admin_mode?（boolean）
    • start?（number）
    • limit?（number）
  • 出力：{ users: [{ id, name, last_name, email?, active }] }
  • 注意：filter は、>=、%、@ などのプレフィックスを含む Bitrix24 の user.get フィルターに対応しています。 start はページングを制御します（Bitrix は1ページあたり50件を返します）。limit は API の応答後にローカルで適用されるスライスです。

• get_user_fields

  • 入力：{}
  • 出力：{ fields: { [field: string]: string } }

• get_current_user

  • 入力：{}
  • 出力：{ user: { id, name, last_name, email?, active } }

アーキテクチャ

クリーンアーキテクチャのレイヤー：

• mcp/ — プロトコル、トランスポート、サーバー
• adapters/ — MCP ツールからドメインへのマッピング
• domain/ — エンティティ、サービス、ポート
• infrastructure/ — Bitrix24 REST クライアント

開発メモ

• 入力検証には zod を使用します。
• トランスポート：STDIO のみ。
• ビルド：tsc（npm run build）。

コントリビューション

ガイドラインについては CONTRIBUTING.md を参照してください。