Red by Big Red Cloud について
Redは、AIアシスタントやMCPクライアントをBig Red Cloudの会計データやサポート資料につなぐオープンソースのMCPサーバーです。読み取り専用の照会と、確認・監査を伴う書き込みを分離し、機能はデプロイ設定に応じて有効になります。
主な機能
- 01Big Red Cloudの会計記録を照会
- 02書き込み内容のプレビューと確認
- 03記録の作成・更新・削除・一括処理・メール送信
- 04VATと取引の安全チェック
- 05公式ヘルプとトレーニング資料の検索
- 06ホスト型HTTPまたはローカルstdioで実行
活用シーン
- 01請求書・顧客・レポートの確認
- 02確認前の会計データ変更の準備
- 03会社を接続せずに操作方法を質問
MCP 対応
会計、会社の準備状況、リクエストルーティング、ヘルプのツールをMCPクライアントに公開します。ホスト型の`/mcp`は設定に応じてルーティングと確認を伴う書き込みに対応し、`/mcp/copilot`は読み取り専用の会計インターフェースを提供します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://red.bigredcloud.com/mcpclaude mcp add --transport http bigredcloud-red https://red.bigredcloud.com/mcp{"mcpServers":{"bigredcloud-red":{"type":"http","url":"https://red.bigredcloud.com/mcp"}}}Cursor で開く{"servers":{"bigredcloud-red":{"type":"http","url":"https://red.bigredcloud.com/mcp"}}}VS Code で開く{"mcpServers":{"bigredcloud-red":{"type":"http","url":"https://red.bigredcloud.com/mcp"}}}{"mcpServers":{"bigredcloud-red":{"serverUrl":"https://red.bigredcloud.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
159| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| connectionRef | string | いいえ | brc_confirm_company_connection が返す不透明な Red 接続参照です。MCP クライアントがセッション ID をローテーションする場合(例:Vibe/Mistral)、以降のツール呼び出しすべてでこの値をそのまま渡してください。ツール呼び出しが成功した後も同じ connectionRef を再利用してください。検索結果が空または一部データのみでも、新しい接続を開始しないでください。これは API キーではなく、認証情報も含みません。 |
詳細
Red MCP サーバー
Red は、AI アシスタントと MCP クライアントを一連の制御された MCP ツールを通じて Big Red Cloud の会計データに接続する、オープンソースの Model Context Protocol (MCP) サーバーです。
現在サポートしている顧客向けプラットフォームは、ChatGPT、Claude、Mistral (Vibe)、および Microsoft 365 Copilot です。Copilot は /mcp/copilot の Microsoft フェデレーションコネクターを使用します。Microsoft フェデレーションコネクターの現時点での制限により、このコネクターは現在読み取り専用です。Microsoft が対応した後、Copilot での作成、更新、削除ツールの提供を予定しています。ChatGPT、Claude、Mistral は /mcp を使用し、デプロイ環境で有効になっている場合は、すでにこれらの書き込みツールが含まれています。他の MCP クライアントも技術的には動作する可能性がありますが、公式サポート対象のプラットフォームとしては扱われません。Red は、匿名の運用テレメトリーに限り、プラットフォームを検出します(プライバシーに配慮したテレメトリーを参照)。
Big Red Cloud REST API を直接呼び出す代わりに、ユーザーは平易な言葉で操作できます。サーバーはリクエストを構造化された API 呼び出しに変換し、データを変更する処理には安全確認を適用します。
Red を使うと、接続済みのユーザーは次のことができます。
- 読み取り専用の照会で Big Red Cloud のデータ(顧客、仕入先、商品、請求書、見積書、勘定科目レポートなど)を確認できます。
- 登録前に確認 — Big Red Cloud にデータを書き込む前に、新規または変更されたレコードの内容を平易な英語でプレビューできます。
- 明示的な確認後にのみ(かつ、デプロイ環境で該当する機能が有効になっている場合に限り)、レコードの作成、更新、削除、一括処理、またはメール送信ができます。
- Big Red Cloud の操作方法やトレーニングに関する質問ができます — Red は、公式サポート記事、顧客向けドキュメント、スクリーンショット、ウェビナー資料を使って回答します。これらのサポートツールを利用するために、会社への接続は必要ありません。
なぜオープンソースにするのか?
AI インフラストラクチャは透明であるべきだと考えています。顧客は、会計データを AI アシスタントに接続するソフトウェアを調査できるべきです。
私たちの競争上の強みはコネクターそのものではありません。それは、会計プラットフォーム、専門的な簿記のアドバイス、顧客体験、そしてその上に築く価値です。
Red をオープンソースにすることで、信頼やコミュニティからの貢献、オープン標準のより広い普及を促進したいと考えています。
主な機能
- 安全な会社接続フロー(1 回限りの接続ページ。チャットに認証情報を入力する必要はありません)
- 接続ページでの会社接続認証情報の事前確認(単一会社のフォームまたは複数会社の CSV アップロード)
- 部分的な接続結果 — 無効なキーは確認前に拒否され、
failedCompaniesに報告されます - ホスト型 HTTP の
connectionRef/activeConnectionRefにより、MCP クライアントは対応するセッション変更をまたいで、確認済みの接続をユーザーに知らせることなく再利用できます。ツールの JSON 内に保持され、エンドユーザーには表示されません - 取引処理のリクエストルーティング — アクションツールでは、作成/更新/削除/一括処理/メールのワークフローを進める前に、ルーターから短期間有効な
routeTokenを取得する必要があります - プライバシーに配慮した匿名の運用テレメトリ(プラットフォーム、環境、ツール名、接続済み会社の数) — docs/TELEMETRY.md を参照してください
- 接続済みの会社を対象とした会社の準備状況チェック(
brc_company_readiness_check) - Big Red Cloud の読み取り専用照会
- 顧客、仕入先、製品、営業担当者、VAT、分析カテゴリのツール
- 売上見積書、請求書、クレジットノート、仕入、支払い、現金のツール
- 作成、更新、削除、一括処理の実行前確認フロー(メールツールでは明示的な送信確認を使用します)
- VAT および取引の安全性チェック
- 複数行の生成参照番号の検証、Gross Price Entry の
priceBasis処理、Sales VAT カテゴリの検証、プレースホルダー製品 ID のブロック、関連する事前チェックなど、売上請求書の安全対策 - MCP セッションを通じて実行された書き込みのセッション監査ログ、および接続済みの 1 社を対象としたダウンロード可能なサポート診断情報
- Freshdesk の記事、顧客向けドキュメント、スクリーンショット、ウェビナーに基づく Big Red Cloud の公式ヘルプ回答 — 会社への接続は不要です
- ローカルの stdio およびホスト型 HTTP トランスポート
セキュリティと安全性のモデル
Red は、AI による会計データへのアクセスが制御され、監査可能な状態に保たれるよう設計されています。
- リポジトリに認証情報を含めません。 会社の接続認証情報やシークレットがコミットされることはありません。設定は実行時に環境変数を通じて指定します。
- チャットに認証情報を含めません。 会社の接続認証情報をチャットに貼り付けてはいけません。会社の接続には、安全な Red 接続ページを使用します。認証情報はチャットウィンドウではなく、そのページに直接入力します。
- 2 つの接続モデル。
https://red.bigredcloud.com/mcpでは、接続した会社は設定されたセッション期間ほど利用可能な状態が続き、セッションメモリ(またはホステッドデプロイメントではオプションの共有接続ストア)に保持されます。対応している場合、このフローでは MCP セッションの変更をまたいでconnectionRef/activeConnectionRefを再利用できます。https://red.bigredcloud.com/mcp/copilotでは、会社は接続したことが確認済みの Microsoft ユーザーに紐付けられます。これらの Microsoft 所有の接続は、匿名接続やセッション接続とは別のものです。 - 確定前の検証。 接続ページで送信された会社の接続認証情報は、保存前に Big Red Cloud に対して検証されます。無効または期限切れの認証情報は保存されず、確定時に
failedCompaniesに表示されます。 - 認証情報の無効化。 保存済みの会社認証情報をクリアするのは、認証に失敗したことが確認された場合のみです。エンドポイント、検証、権限、タイムアウト、サーバーのエラーは、API キーの期限切れとして扱われません。
- ユーザー向けの表示。
connectionRef、セッション ID、その他の MCP 診断情報は、ツールの引数にのみ使用します。ユーザーが技術的な詳細を明示的に求めない限り、アシスタントは通常のユーザーにredconn_…の値や内部接続メタデータを表示してはいけません。 - 設定可能なセッション期間。 接続の有効期間は
BRC_API_KEY_TTL_MINUTESによって制御されます。ユーザー向けの文言(接続ページ、利用開始時の説明、接続ステータス)は、この値をもとに決まり、ハードコードされません。 - 書き込み時のリクエストルーティング。 作成、更新、削除、一括処理、メールの各ツールでは、対応するワークフロー用にリクエストルーターが発行した、有効かつ短期間のみ有効な
routeTokenが必要です。ルートトークンは投稿の許可を意味するものではなく、引き続きプレビューと確認が必要です。 - 書き込みには明示的な確認が必要です。 作成、更新、削除、一括処理の各アクションでは、投稿内容のプレビューを表示した後、明示的な確認フラグが必要です。メールツールでは、メールのプレビュー後に送信の明示的な確認が必要です。
- 投稿前にプレビューします。 書き込みツールの最初の呼び出しでは、アクションを実行する代わりに、ペイロードのプレビューが返されます。確認するまで Big Red Cloud に書き込まれることはありません。
- 読み取りと書き込みを分離します。 読み取り専用の検索と、データを変更するアクションは明確に区別されています。
- 監査ログ。 MCP セッションを通じて行われた書き込みはセッション監査ログに記録されます。読み取り専用の検索は、完了した変更として扱われません。アクティビティは現在接続されている会社に限定されます。ダウンロード可能なサポート診断情報は、一度に 1 社の接続会社について生成できます。生成は読み取り専用であり、Big Red Cloud への書き込みは行いません。
- デプロイメントフラグ。 更新、削除、メール、一括処理、オペレーター/開発用ツールは、それぞれデプロイメントごとに無効化できます。無効化されたスキルグループは、そのプロセスの MCP クライアントに登録されないため、ツールは呼び出し可能な状態ではなく、非表示になります。
売上請求書の安全チェック
売上請求書の処理には、次のチェックが含まれます。
- 総額の入力では、VAT が推測されないよう、
priceBasisにgrossまたはnetを明示する必要があります。 - 売上 VAT 税率のみを使用します。 売上請求書には売上 VAT カテゴリーを使用する必要があります。パーセンテージが一致していても、仕入 VAT 税率はブロックされます。
- プレースホルダーの商品 ID(
productIdの0と1)はプレースホルダーとして扱われ、プレビューおよび転記の前と転記時にブロックされます。 - 複数行の生成参照請求書(
brc_create_sales_invoice_gen_ref)では、各productTrans行に独自のacEntries分析配賦を含める必要があります。転記前に、行ごとの正味額/VAT/総額の照合、分析配賦の合計、ヘッダーの合計、必須の商品/VAT/分析フィールドが検証されます。エラーが発生した場合は、フィールド単位の構造化エラーが返されます。 noteは、明示的にメモが指定されない限り顧客名がデフォルトとなり、商品名が設定されることはありません。deliveryToは、配送先住所が明示的に指定された場合にのみ含まれます。- わかりやすい結果。 技術的な HTTP ステータスコードは、ユーザー向けのわかりやすいメッセージに変換されます。
アーキテクチャ
Red には、独自のツールレジストリを持つホスト型 MCP インターフェースが 2 つあります。
| インターフェース | アドレス | レジストリ |
|---|---|---|
| 通常の Red | https://red.bigredcloud.com/mcp | 作成、更新、削除、一括処理、メール送信を含む完全なツールレジストリ。ただし、これらはデプロイ環境で有効になっている場合に限ります |
| Microsoft 365 Copilot | https://red.bigredcloud.com/mcp/copilot | 読み取り専用の独立した会計ファサードに加え、ヘルプおよび会社管理のナビゲーション |
ローカル stdio(src/index.ts、node build/index.js)では、/mcp と同じ完全なレジストリを使用します。ホスト型 HTTP は src/remote.ts です。/mcp は完全なレジストリを登録し、リクエストのルーティング、routeToken のチェック、保護対象の書き込みに対するプレビュー後の転記確認を行います。/mcp/copilot は独自の読み取り専用ファサードのみを登録します。会計データの作成、更新、削除ツールは登録しません。
主な共有モジュール:
src/server.ts— MCP サーバーファクトリーと stdio シングルトンsrc/register_all_tools.ts— ツール登録の中核。無効化されたスキルグループのツールを除外し、書き込みツールをルーティングおよびプレビュー後の転記/確認処理でラップしますsrc/config/server_config.ts—BRC_ALLOW_*フラグによって制御されるデプロイ時のスキル制御src/config/mcp_config.ts— MCP サーバーの指示、接続の安全ルール、ヘルプ回答のルール、connectionRef の表示ルールsrc/routing/— リクエストの分類と、トランザクションツール向けの短期間有効なrouteTokenの発行/検証src/shared.ts— Big Red Cloud HTTP クライアント、接続処理、監査ログ、ヘルパーsrc/read_connection_metadata.ts— ツール応答に含める接続ステータスメタデータ(ホスト型クライアント向けのactiveConnectionRefを含む)src/auth/connection_presentation.ts— ユーザー向けの TTL 表現とアシスタントへの表示ヒントsrc/auth/credential_validation.ts— 会社の接続資格情報を保存する前に行う BRC 読み取り検証src/guards/— トランザクション、参照、VAT カテゴリー、商品行、書き込み確認に関する安全チェックsrc/auth/— 安全な接続フロー、接続ストア(メモリまたは Cosmos)、接続ページ、資格情報の永続化src/telemetry/— ホスト型運用テレメトリー向けの匿名クライアント/セッション ID とプラットフォーム検出src/brc-edu/— Freshdesk の記事、顧客向けドキュメント、ウェビナーの索引、スクリーンショット、統合ヘルプ検索src/edu/— ヘルプリソースの読み込み、拡充、ワークブックの解析、ストレージ設定の共有処理src/tools/edu/— 読み取り専用のヘルプツールsrc/tools/routing/— リクエストルーティングツールの登録
ドメインロジックは src/tools/ にあり、汎用的な作成/更新/削除/一覧表示/一括処理のヘルパーは src/tools/general/ にあります。
技術
- TypeScript / Node.js(ES モジュール)
@modelcontextprotocol/sdk- ツール入力の検証に Zod を使用
- ホスト型モードに Express + Streamable HTTP を使用
要件
- Node.js 24 以降(
package.jsonのengines。ホスト型 Linux アプリでは Node 24 を使用します)。 - npm(Node.js に同梱)。
インストール
npm install
npm run build
.env.example ファイルが用意されている場合は、.env にコピーして値を調整します。
cp .env.example .env
.env ファイルや実際の認証情報は、決してコミットしないでください。
実行
ホスト型 HTTP サーバー:
npm run start
# Serves the MCP endpoint at http://localhost:3000/mcp
ローカル stdio サーバー:
npm run start:local
MCP セッションなしでブラウザーから HTTP エンドポイントを開くと、エラーが返されます。これは想定された動作です。
Microsoft Copilot(任意)
ホスト型デプロイでは、Microsoft 365 Copilot 用のフェデレーションコネクタとして /mcp/copilot を公開できます。このパスでは Microsoft Entra サインインを使用します。会社の API キーは引き続き Red の接続ページで入力し、サインインした Microsoft ユーザーのために保存されます。設定方法については、docs/copilot-entra-sso.md を参照してください。
本番環境の Copilot アドレスは https://red.bigredcloud.com/mcp/copilot です。
Copilot コネクタは読み取り専用です。対応している Big Red Cloud のデータを検索および取得できますが、レコードの作成、更新、削除はできません。この制限は、Red に書き込みツールがないためではなく、現在の Microsoft フェデレーションコネクタに起因します。Microsoft がサポートした後、Copilot での作成、更新、削除にも対応する予定です。それまでは、これらの操作は ChatGPT、Claude、Mistral 用の /mcp で行ってください。
MCP クライアントの設定
ローカル stdio(クライアントがプロセスを起動):
{
"mcpServers": {
"red-mcp-server": {
"command": "node",
"args": ["build/index.js"],
"env": {
"BRC_API_BASE_URL": "https://app.bigredcloud.com/api"
}
}
}
}
ホスト型 HTTP(本番環境):
ホスト型 Big Red Cloud Red サービスを利用するお客様は、次の URL を使用してください。
https://red.bigredcloud.com/mcp
{
"mcpServers": {
"red-mcp-server": {
"url": "https://red.bigredcloud.com/mcp"
}
}
}
ホスト型 HTTP(ローカル開発):
{
"mcpServers": {
"red-mcp-server": {
"url": "http://localhost:3000/mcp"
}
}
}
開発と回帰テスト
| スクリプト | コマンド | 目的 |
|---|---|---|
| ビルド | npm run build | TypeScript を build/ にコンパイルします |
| HTTP 開発 | npm run dev | tsx を使ってソースから HTTP サーバーを実行します |
| stdio 開発 | npm run dev:local | tsx を使ってソースから stdio サーバーを実行します |
| すべてのテスト | npm test | ビルド後、テストスイート全体を実行します |
| ユニットテスト | npm run test:unit | ユニットテストのみを実行します |
| セキュリティテスト | npm run test:security | セキュリティに重点を置いたテストを実行します |
| 設定テスト | npm run test:config | デプロイと設定のテストを実行します |
| 統合テスト | npm run test:integration | 統合テストを実行します |
| 本番監査 | npm run audit:prod | 本番依存関係に対して npm audit を実行します |
テストでは、売上請求書のチェック、取引日の検証、安全な接続フロー(CSV 検証、部分的な確定、認証情報の無効化)、connectionRef の表示ルール、リクエストのルーティング、TTL の文言、応答の文言など、上記の安全対策を検証します。
環境変数
ホスト型 Red サービスのお客様は、その環境を設定する必要はありません。ChatGPT、Claude、Mistral では https://red.bigredcloud.com/mcp を使用します。Microsoft 365 Copilot では https://red.bigredcloud.com/mcp/copilot を使用します。
Red をセルフホストする運用者は、そのプロセスの環境変数を設定します。任意設定、プラットフォーム管理設定、シークレット設定の区分を含む正式な一覧は、docs/environment-variables.md を参照してください。.env.example はプレースホルダー用のテンプレートにすぎません。実際のシークレットは決してコミットしないでください。
/mcp では、デプロイ時のスキルフラグ(BRC_ALLOW_*)によって登録するツールグループを選択します。Copilot ファサードは独自の読み取り専用カタログを保持し、これらの書き込みフラグには従いません。brc_get_deployment_policy は、通常のレジストリにおけるお客様向けの利用可否を要約します。
会社の接続
お客様は、セキュアな Red 接続ページから会社を接続してください。会社接続の認証情報をチャットで送信してはいけません。認証情報を入力できるのはセキュアな Red 接続ページのみであり、チャットウィンドウには入力しません。
お客様は、Big Red Cloud の Administration → API Keys から会社の API キーを取得または再生成できます。
手順は次のとおりです。
- アシスタントに会社接続の開始を依頼します。セキュアな接続ページのリンクが返されます。
- そのページで、1 社を入力するか、複数の会社を手動で入力するか、CSV をアップロードして複数の会社を一度に登録します。会社接続の認証情報はチャットではなく、セキュアなページで入力します。
- サーバーは各認証情報を保存する前にBig Red Cloud に対して検証します。検証に失敗した認証情報は保存されません。
- チャットに戻り、成功ページに表示された確認コードを入力します。
- 確認後、接続に成功した会社と失敗した会社(ある場合)がアシスタントから報告されます。無効な認証情報はすぐに
failedCompaniesに表示されます。不正なキーを見つけるために、先に検索を実行する必要はありません。
接続リンクは一度だけ使用できます。切断するか接続の有効期限が切れない限り、接続した会社は設定されたセッション時間(BRC_API_KEY_TTL_MINUTES。たとえば 240 分なら約 4 時間)の間、引き続き利用できます。
ホスト型 HTTP と connectionRef
ホスト型 HTTP モード(Mistral/Vibe など)では、brc_confirm_company_connection はツールの JSON に不透明な connectionRef を返します。プラットフォームがセッション ID をローテーションする場合、MCP クライアントは後続のツール呼び出しで connectionRef / activeConnectionRef を保持し、表に出さず再利用してください。対応している場合、接続情報は MCP セッションのローテーション後も保持されます。これはクライアント向けの実装詳細です。アシスタントは connectionRef や redconn_… の値をエンドユーザーに表示してはいけません。ツールの応答には、このルールを徹底するための assistantInstruction / presentationHint フィールドが含まれます。
ヘルパーツール:
- セッション内の接続済み会社を一覧表示する
- 1 社の接続を解除する
- すべての会社の接続を解除する
プライバシーに配慮したテレメトリ
ホスト型デプロイでは、運用担当者が利用状況の概算を把握できるよう、Red が匿名の運用テレメトリを記録する場合があります。一般的なデータ項目には、匿名のクライアント識別子と接続セッション識別子、検出されたプラットフォーム、デプロイ環境、ツール名、接続済み会社数などがあります。
テレメトリには、API キー、認証情報、生の connectionRef 値、認証ヘッダー、リクエスト本文、請求書/顧客/仕入先のペイロードは含まれません。Big Red Cloud の呼び出しに失敗した場合、安全な識別子(company_id や record_id など)が含まれることがあります。匿名テレメトリは、検証済みの Big Red Cloud ユーザー ID ではありません。Microsoft 365 Copilot は、検証済みの Microsoft サインインを使用して、そのユーザーがアクセスできる会社を判定します。このサインインは、ここで説明する匿名テレメトリとは別のものです。
運用担当者および開発者向けの詳細:docs/TELEMETRY.md。
ツールの対応範囲
Red は、ドメイン別に整理された、厳選された MCP ツールを提供します。正確なツール名とエンドポイントの対応関係は、src/tools/ のソースコードに記載されており、開発者向けには docs/TOOLS.md にまとめられています。
- 会社のセットアップと準備状況 — 会社のセットアップ設定、会計年度、処理設定、準備状況のチェック、取引日の検証、勘定履歴の文書タイプの特定。
- 顧客と仕入先 — 一覧表示/取得/作成/更新/削除に加え、開始残高と勘定取引。
- 商品と営業担当者 — 一覧表示/取得/作成/更新/削除、および商品タイプ。
- 売上伝票 — 見積書、売上請求書、売上クレジットノート、売上仕訳。参照番号を自動生成する各種機能と、見積書から請求書を作成する機能も含みます。
- 仕入と支払い — 仕入、支払い、現金支払い、現金受領、銀行口座。
- VAT と分析用の参照情報 — VAT 税率、VAT カテゴリー、VAT タイプ、分析カテゴリー、勘定科目、および関連する参照データ。
- 名目勘定レポート — 名目勘定の一覧表示、およびグループ別/複数会社の名目勘定レポート。
- 監査とセッション — セッション接続の管理、セッション監査ログ、ダウンロード可能なサポート診断レポート。
- ヘルプとトレーニング — Freshdesk の記事、顧客向けドキュメント、録画済みウェビナー、今後開催されるウェビナー、スクリーンショットへのリンクを、読み取り専用のヘルプツール経由で提供します。会社への接続は不要です。
主要な作成ワークフローには一括処理版があり、単一レコード用のツールと同じ安全チェックが適用されます。
会社の準備状況チェック
brc_company_readiness_check は、接続中の会社全体の健全性を確認する読み取り専用ツールです。全体ステータスは次のとおりです。
readyready_with_warningsnot_readyconnection_problem
接続状況に加え、会計年度、取引日の位置、使用中の売上 VAT 税率、売上分析カテゴリー、商品、営業担当者など、関連するセットアップ項目を確認します。仕入先が登録されていない場合は仕入設定の警告として報告されますが、売上請求書を作成する準備状況の妨げにはなりません。参照番号の手動設定は、必ずしも処理を妨げるものではなく、警告または事前確認事項として扱われます。
特定の VAT が関係するワークフロー(売上請求書、仕入、現金受領、明細書)には、代わりに brc_check_transaction_settings を使用してください。このツールは個別のワークフローの処理設定を確認します。一方、準備状況チェックは会社全体の準備状況を評価します。brc_validate_transaction_date、brc_get_company_processing_settings、brc_get_company_reference_settings など、より範囲を絞ったヘルパーも引き続き利用できます。
サポート診断
brc_list_audit_log は、現在接続中の会社について、現在のセッションにおける Red の書き込み操作を表示します。読み取り専用の参照操作は、完了した変更として扱われません。
brc_generate_support_report は、接続中の会社 1 社の診断情報を、ダウンロード可能なプレーンテキスト形式で作成します。複数の会社を使用した場合は、会社ごとに個別のレポートを作成してください。レポートには、サポートに役立つ成功/失敗情報と相関情報が含まれます。認証情報、API キー、トークン、接続参照情報は含まれません。レポートの作成は読み取り専用で、Big Red Cloud への書き込みは行いません。
開発者向けの詳細: docs/TOOLS.md および docs/TELEMETRY.md。
前会計年度の日付の動作
現在の会計年度外の日付を指定した取引は、処理が不可能であることを示すものではなく、警告として扱われます。通常のプレビューと確認の後、Red はサポートされている操作のみを試みます。Big Red Cloud が操作または日付を拒否した場合、Red は実際の応答を報告します。過去の取引がすべて変更できるわけではありません。
取引の改善
- 見積もりの確認プレビュー、検証、および見積もりから請求書を生成する機能(
brc_generate_sales_invoice_from_quote)。 - 現金領収書の VAT 処理と、更新時の元帳の保持。
- 対応する現金支払いのフィールドは、更新ワークフローを通じて既存のレコードで修正できます。
- 口座履歴の明細は、書類固有の検索や変更を行う前に、正しい書類種別に解決する必要があります(
brc_resolve_book_transaction_type)。 - 取り消し、反対仕訳、修正のリクエストは、まず計画として扱います。別の取引を自動的に記帳する許可として扱うことはありません。
ヘルプとトレーニングのリソース
Red には、Big Red Cloud のヘルプやトレーニングに関する質問に対応する、読み取り専用の MCP ツールが含まれています。会社に接続する必要はありません。
主な機能:
- 公式記事、顧客向けドキュメント、録画済みウェビナー、今後開催予定のウェビナーを検索します。
- 選択したリソースの詳細全体を読み込みます。利用可能な場合は、手順ごとのガイダンスと関連するスクリーンショットへのリンクも含まれます。
- ヘルプパイプラインを通じて、予約済みのヘルプ形式の質問(
red-help//red-help形式のコマンドを含む)に回答します。
ヘルプの回答には、以下が含まれる場合があります。
- 公式の Freshdesk 記事。
- 顧客向けドキュメント。
- 関連するスクリーンショット。
- 録画済みの YouTube トレーニング動画。
- 今後開催予定のウェビナーへのリンク。
ヘルプリソースのインデックスは、デプロイ担当者によって提供されます。このリポジトリには、それらのインデックスの管理に使用する、担当者向けのアップロード、カタログ、同期の実装が含まれています。顧客がこのワークフローを設定する必要はありません。
既知の制限事項
- 一部の機能は、Big Red Cloud での会社の設定によって異なります。
- メール送信や一部の銀行関連の書き込み操作には、追加のテナント設定が必要な場合があり、デプロイフラグによって無効になっていることがあります。
- 生成される参照番号の動作は Big Red Cloud のテナント設定によって異なる場合があり、生成される書類のエンドポイントによっては、テナントの現在の取引日が適用されることがあります。現在の会計年度外の日付は警告の対象ですが、自動的に拒否されるわけではありません。Big Red Cloud からの応答が正式な判断となります。
- ツールの利用可否はデプロイポリシーによって異なる場合があります(無効になっているスキルグループは登録されません)。
- 匿名テレメトリで数えるのは、個人として確認された人数ではなく、おおよそのクライアント数です(例:ブラウザーやデバイスの Cookie)。
- クライアントから識別に十分な情報が提供されない場合、プラットフォームの判定は
unknownになることがあります。 - 公式にサポートされている顧客プラットフォームは、ChatGPT、Claude、Mistral/Vibe、Microsoft 365 Copilot です。Copilot はフェデレーションコネクターであり、Microsoft がそのコネクターでの書き込み操作をサポートするまでは読み取り専用です。その他の MCP クライアントは、サポート対象プラットフォームとして明示されていません。
メンテナー
このプロジェクトは Big Red Cloud のソフトウェア開発チームが保守しています。
ステータス
Red はベータ版です。 Red は Big Red Cloud 向けのオープンソース MCP 統合であり、現在も積極的に開発されています。ツールの利用可否や動作はリリースによって変わる場合があり、一部の機能はデプロイポリシーによって制限されます。
ライセンス
このプロジェクトは Apache License 2.0 の下でライセンスされています。詳細は LICENSE を参照してください。
サポートと責任ある脆弱性開示
セキュリティ上の問題を発見したと思われる場合は、Big Red Cloud のサポートチームにご報告ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。