bitrix24-ai-tools

Bitrix24 AI ツール

基準：Bitrix24 クラウド。オンプレミスでは vibecodeconnector を使用 · 検証済み：b24restdocs 2026-09-30、vibecodeconnector 26.200.100（main 26.800.0）

目的	使用するもの
独自のコードで REST 呼び出しを作成または変更する	MCP b24-dev-mcp + bitrix24-rest-api
エージェントにプラットフォーム上でアプリを作成・ホストさせる	Alaio Vibecode
エージェント向けスターター	b24gosdk llms.txt；github.com/bitrix24/b24-ai-starter（Nuxt 3 + PHP/Python/Node、OAuth、Docker）

REST ドキュメント自体には llms.txt の記載はありません。Vibecode（プラットフォーム）≠ Vibe（スタートページ、landing.repowidget.*）≠ Vibe+（クラウドプランの種類）。

ドキュメント MCP b24-dev-mcp

https://mcp-dev.bitrix24.com/mcp：Streamable HTTP（/sse なし）、認証不要。ドキュメントのみを提供します。ポータルのデータやメソッド呼び出しは扱いません。クライアントは application/json と text/event-stream を受け入れる必要があります（そうでない場合は 406）。

ツール	呼び出すタイミング
bitrix-search	最初に使用します。正確な名前が返されます。doc_type：method、event、other、app_development_docs；limit
bitrix-method-details	呼び出しを記述する前に使用します：パラメーター、必須フィールド、レスポンス、エラー、サンプル（field、filter で絞り込めます）
bitrix-event-details	イベントハンドラーを記述する際に使用します：ペイロード
bitrix-article-details	概念の確認に使用します：認証、制限、バッチ、ページネーション
bitrix-app-development-doc-details	アプリのインストール、プレースメント、アプリの種類

セットアップ：

claude mcp add --transport http b24-dev-mcp https://mcp-dev.bitrix24.com/mcp
codex mcp add b24-dev-mcp --url https://mcp-dev.bitrix24.com/mcp

Cursor .cursor/mcp.json：{"mcpServers": {"b24-dev-mcp": {"url": "https://mcp-dev.bitrix24.com/mcp", "timeout": 30000}}}。VS Code .vscode/mcp.json：{"servers": {"b24-dev-mcp": {"url": "https://mcp-dev.bitrix24.com/mcp", "type": "http"}}}。動作確認：crm.item.add のパラメーターを尋ねます。回答には entityTypeId と fields が含まれている必要があります。

ルール：

1. REST 呼び出しを追加または変更する前に、bitrix-search を実行し、続いて正確な名前を指定して bitrix-method-details を実行します。パラメーター名と大文字・小文字、必須フィールド、フィルター構文、適用範囲は、記憶ではなく結果に従ってください。
2. not found は名前が正確でないことを意味します。再検索し、決して推測しないでください。
3. ドキュメントに記載されているのはクラウドです。特定のボックスでメソッドが利用できるかどうかは、そのポータルで method.get を実行して確認してください。
4. Webhook URL、トークン、キー、顧客データを MCP に送信しないでください。

Alaio Vibecode

Vibecode 独自の API を通じて、エージェントが Bitrix24 アプリを作成するプラットフォームです。開始手順：エージェントにキーを渡して GET https://vibecode.bitrix24.com/v1/me を実行します。オブジェクト、キーの権限、手順が返されます。

キー（一度だけ表示されます）：

• vibe_api_…：個人用。Webhook のように 1 人のユーザーとして動作し、UI に埋め込むことはできません。
• vibe_app_…：OAuth 対応のアプリ。ユーザーは各自の権限で操作します。プレースメントとイベント配信に必要です。
• vibe_live_…：管理専用（キー、ポータル）。データへのアクセスはできません。
• モードは READWRITE（デフォルト）または READONLY（書き込みは 403 WRITE_BLOCKED_READONLY_KEY を返します）。

REST と比べて、この API はフィールド名とフィルターを変換し、最大 5 000 件まで内部でページングし（REST：50 件）、バッチ処理を行い、一時的なエラーを再試行します。追加機能：Black Hole サーバー（トンネル経由でホストし、60 分間アイドル状態が続くとスリープ）、再配信機能付きのイベントサブスクリプション、OpenAI 互換モデル（/v1/models、/v1/embeddings）、検索（/v1/search）、ストレージ、ソースバージョン。

制限：キーあたり 300 req/min、/v1/search は 60/min、AI ルーターはキーあたり 600/min、ユーザーあたり 1 500/min。429 には再試行時刻が含まれます。実際の制限は X-RateLimit-Limit に示されます。

費用：有料の Bitrix24 プランに加えて Vibe+ サブスクリプションが必要です。サーバー、従量課金モデル、検索、エージェントは Vibe クレジットで課金されます（1 Ꝟ = 1 USD）。予算が尽きると 402 が返されます。

セキュリティ：キーはプロジェクトの環境変数にのみ保存してください。キーが漏洩した場合は、新しいキーを作成して古いキーを無効にします。チームメンバーは各自のキーを使用し、共有キーは使わないでください。

独自のホスティングなしで社内ツール、ボット、AI 機能をすばやく作成する場合は、Vibecode を選んでください。独自のインフラ、Marketplace での配布、カスタムのトークン保存、または Vibecode 接続のないボックスが必要な場合は、標準の REST アプリ（bitrix24-rest-api）を選んでください。

オンプレミス：モジュール vibecodeconnector

• バージョン 26.200.100、ベータ版：インストーラーではベータ版の利用規約への同意が必要です。REST が有効な rest が必要です。また、im と socialservices を使用します。ライセンスキーごとに 1 つのインストールを接続します。
• モジュール設定 → 接続で、ボックスを Vibecode（vibecode.bitrix24.com、CIS または不明なライセンス地域では vibecode.bitrix24.tech）に登録し、ペアリングキーを保存します。
• その後、Vibecode は Authorization: Bearer <JWT>（CheckIncomingJwt）を付けて、モジュールのアクションに POST します。ボックスは Vibecode からアクセス可能である必要があります。API キーはユーザーの受信 Webhook として発行され、アプリキーはボックスにインストールされた個人用アプリとして発行されます。
• オプション permission_source：vibecode はポータルの Webhook とアプリ作成に関する制限を迂回し、portal はその制限を適用します。RU/BY ライセンスでは Marketplace のサブスクリプションも必要です（SUBSCRIPTION_REQUIRED）。
• 切断してからアンインストールしてください。接続後、ユーザーは Vibecode でボックスを追加（「セルフホスト版 Bitrix24 に接続」）し、クラウド版と同様に利用できます。

チェックリスト

• 新規または変更された REST 呼び出しはすべて、記憶に頼って記述せず、bitrix-method-details（またはメソッドのページ）で確認しました。
• Webhook URL、トークン、Vibecode キーが、リポジトリ、プロンプト、スクリーンショット、MCP リクエストに含まれていません。
• Vibecode キーの権限は必要最小限です。アプリが書き込みを行わない場合は READONLY にしています。
• 生成されたアプリについて、権限、変更するデータ、エラー処理、開けるユーザーを確認しました。