AI クライアントの接続
MCP サーバーのエンドポイントは次の場所で利用できます:x-cdata-authtoken ヘッダーを使用します。authtoken を生成するには、ユーザーロールページで対象ユーザーのAPI アクセスタブにあるEnable Authtoken Access をチェックし、システムが生成したauthtoken をコピーします。
Authtoken を安全に保管する
以下のクライアント設定例では、authtoken を設定ファイル内にインライン値として記載しています。これでも動作しますが、共有ワークステーション上の設定ファイルは他のローカルユーザーに読み取られたり、誤ってバージョン管理にコミットされたりする可能性があります。トークンをOS の環境変数に保存すれば、設定ファイル自体にトークンを含めずに済みます。 Linux およびmacOS シェルのプロファイル(~/.bashrc、~/.zshrc、または~/.profile)に次の行を追加し、再読み込みします:
クライアント設定ファイルでの変数の参照
GitHub Copilot CLI とOpenAI Codex のどちらのクライアントも、ターミナルから起動され、システム環境全体を継承するため、システム環境変数を直接読み取ることができます。それぞれの安全な設定方法は、以下の各セクションに記載しています。 Claude Desktop は、ターミナルから起動されるプロセスのようにシステム環境全体を継承しないため、設定JSON 内の環境変数参照は機能しません。代わりに、以下のClaude Desktopセクションで説明する--header-file の方法を使用してください。
以下のいずれかの設定を保存したら、AI クライアントのセッションを再起動してください。
Claude Desktop
Claude Desktop はstdio 経由でMCP サーバーと通信します(ローカルサブプロセスを起動し、stdin/stdout でやり取りします)。そのため、Arc のリモートHTTP エンドポイントに直接接続することはできません。mcp-remote npm パッケージがこのギャップを埋めます。これはClaude Desktop が通信するローカルstdio プロセスとして実行され、リクエストをArc のHTTP エンドポイントに転送します。
--transport http-only フラグは、Arc と通信する際にプレーンなストリーム可能HTTP を使用するようmcp-remote に指示し、SSE(Server-Sent Events)の交渉を試みないようにします。mcp.rsc エンドポイントはSSE をサポートしていないため、このフラグによって不要なフォールバックの遅延や接続エラーを回避できます。
次の内容をClaude Desktop の設定ファイル(Settings > Developer > Edit Config)に追加します:
Windows を使用している場合は、
"command": "cmd" を使用し、"npx" の前に"cmd", "/c" プレフィックスを追加してください。--header-file を使用した代替のトークン参照方法
Claude Desktop の設定JSON は、サブプロセスの起動時にシェルが介在しないため、環境変数の参照をサポートしていません。authtoken を設定ファイルに含めないようにするには、代わりにmcp-remote の--header-file フラグを使用します。
Claude Desktop がアクセスできる任意の場所(/home/<username>/.cdata/arc-mcp-headers.txt など)にプレーンテキストファイルを作成します。次の行を追加します:
--header の代わりに--header-file を使用します:
Windows を使用している場合は、
"command": "cmd" を使用し、"npx" の前に"cmd", "/c" プレフィックスを追加して、C:\Users\<username>\.cdata\arc-mcp-headers.txt のようなWindows パスを使用してください(JSON 文字列では、バックスラッシュごとに\ を使用します)。arc-mcp サーバーを有効にします。
GitHub Copilot CLI
Claude Desktop とは異なり、GitHub Copilot CLI はリモートMCP サーバーに直接HTTP 経由で接続するため、mcp-remote ブリッジは不要です。代わりに、Arc のエンドポイントを直接指定します。MCP 設定ファイルの場所はOS によって異なります:
ファイルを編集し、次の内容を追加します:
環境変数による安全なトークン保管
GitHub Copilot CLI は、headers フィールドで${VAR} 置換をサポートしています。インラインのauthtoken 値を、ARC_AUTHTOKEN 変数への参照に置き換えます:
ARC_AUTHTOKEN をシステムまたはユーザーの環境変数として設定しておく必要があります。設定手順については、Authtoken を安全に保管するを参照してください。
保存したら、新しいCopilot CLI セッションを開始してarc-mcp サーバーを読み込ませます。
OpenAI Codex
Copilot CLI と同様に、OpenAI Codex もリモートHTTP MCP サーバーを直接サポートしているため、ブリッジは不要です。Arc のエンドポイントに直接接続します。設定ファイルの場所はOS によって異なります:
この設定は、Codex CLI、Codex IDE 拡張機能、Codex Desktop で共有されます。ファイルを編集し、次の内容を追加します:
環境変数による安全なトークン保管
OpenAI Codex には、インライン値の代わりにヘッダー名を環境変数名にマッピングする、別個のenv_http_headers フィールドがあります。http_headers をenv_http_headers に置き換えます:
ARC_AUTHTOKEN をシステムまたはユーザーの環境変数として設定しておく必要があります。設定手順については、Authtoken を安全に保管するを参照してください。
保存したら、Codex を再起動する(または新しいセッションを開始する)と、arc-mcp サーバーが読み込まれます。
相関Id
Arc は、単一のエントリポイント(インバウンドHTTP リクエスト、AS2 またはSFTP セッション、スケジュールされたトリガー、フローAPI 呼び出しなど)で開始される作業に相関Id を付与し、それを結果として生じるトランザクション、アプリケーションログエントリ、リクエストログエントリ、サービスログセッションに至るまで保持します。以下の診断ツールのいくつかは、利用可能な場合にこのId を返すため、同一の作業単位に関連する証跡をまとめて追跡できます。利用可能なツール
診断ツール
以下の15個のツールは読み取り専用であり、Arc インスタンス上のデータや状態を変更しません。| ツール | 説明 |
|---|---|
find_workspaces | Arc のワークスペースを一覧表示および検査します。コネクタの概要や、直近のトランザクション数・エラー数も含まれます。 |
find_connectors | ワークスペースまたはタイプごとにコネクタを閲覧し、コネクタの設定、フロー接続、参照されている証明書、エラー率を掘り下げます。 |
find_messages | コネクタ、ステータス、方向、時間範囲、またはメッセージId でトランザクションメッセージを検索します。ヘッダーやトランザクションログの内容を含むメッセージの詳細を取得します。 |
find_files | Send、Receive、またはSent フォルダ内のコネクタメッセージファイルを検索します。名前でファイルの内容を取得します。 |
find_logs | 重大度レベル、時間範囲、またはメッセージテキストでアプリケーションログを検索します。利用可能な場合は相関Id フィールドを返し、ログエントリを関連するトランザクションやサービスログセッションに結び付けます。 |
find_requests | 監査やトラブルシューティングのためにAPI リクエストログを調べます(メソッド、URL、ユーザー、IP、または時間範囲でフィルタ)。利用可能な場合は相関Id フィールドを返します。 |
find_certificates | 証明書を検索し、有効期限を確認し、コネクタでの使用状況やカテゴリ(Public またはPrivate)でフィルタします。 |
find_vault_entries | 名前、タイプ、またはタグでvault エントリを検索します。暗号化された値は公開されません。 |
find_reports | レポート定義を閲覧し、スケジュール、カラム、フィルタ、E メール受信者の設定を調べます。 |
find_flow_apis | フローAPI の定義を調べたり、API のリクエストおよびレスポンスの設定を取得したりします。 |
find_service_logs | コネクタのサービスログ(AS2、AS4、GISB、RNIF、FTP Server、OFTP、SFTP Server、TCP Server、AMQP、IDoc、MQTT)を検索し、1つのログの内容を取得します。トランザクション記録を残さなかった接続、リスナー、プロトコルレベルの障害の調査に役立ちます。 |
diagnose_message | メッセージId またはトランザクションId で特定のトランザクションメッセージを診断します。完全なメッセージの詳細(ヘッダーとトランザクションログの内容)を返します。相関Id が存在する場合は、そのメッセージに関連するリクエストログエントリ、アプリケーションログエントリ、サービスログの証跡も返します。 |
trace_message_flow | メッセージId、またはファイル名とコネクタの組み合わせが与えられた場合に、フロー内のコネクタをまたいで移動するメッセージをエンドツーエンドで追跡します。 |
check_health | Arc インスタンスの健全性スナップショットを取得します:エラー数、期限切れ間近の証明書、ライセンスステータス、メモリおよびディスクの警告、コネクタごとの失敗率とメッセージの滞留状況。 |
describe_profile | Arc のプロファイル設定(Application、AS2、SFTP など)をセクションごとにまとめて表示します。秘密情報の値はマスクされます。 |
アクションツール
18個のツールのうち3個は、単にデータを読み取るだけでなく、Arc インスタンスに対して実際の操作を実行します。これら3個のツールはいずれも、実行前にAI クライアントが明示的な確認を要求します。次のガードレールが3個すべてに適用されます:- 確認が必須です。 AI クライアントは、まずユーザーから明示的な確認を得なければ操作を実行できません。
- 既存の権限が適用されます。 ユーザーは、自分のArc 権限ですでに許可されているリソースに対してのみ、トリガー、再キュー、またはクリーンアップを実行できます。読み取り専用アクセス権しかないユーザーは、アクションツールを一切呼び出せません。
- 対象を明示する必要があります。 すべてのアクションは、それが影響するワークスペースとコネクタを正確に指定します。何も推測や憶測で決定されることはありません。
- アクションは監査されます。 各操作は、何が実行されたか、どのコネクタに対して実行されたか、結果を記録した監査レコードを書き込みます。
| ツール | 説明 |
|---|---|
trigger_connector | コネクタの受信または送信操作を実行します。必要に応じて特定のファイルまたはメッセージを対象にできます。 |
requeue_message | 以前に処理されたメッセージを再キューし、コネクタに再度処理させます。トランザクションタブの再キューアクションと同等です。 |
cleanup_files | 1つのコネクタ、1つのワークスペース、またはすべてのワークスペースを対象に、設定済みの一括クリーンアップを実行し、指定した日数より古いデータをアーカイブまたは削除します。 |
プロンプトの例
Arc とは、AI クライアントを通じて自然言語でやり取りします。診断プロンプトの例を次に示します:- 「メッセージEDIFACT1-20260513-123047000-wxcU の失敗を分析し、修正方法を提案してください。」
- 「過去24時間のエラーログのうち、AS2 に言及しているものをすべて表示してください。」
- 「今後30日以内に期限切れとなる証明書は何ですか?」
- 「メッセージAS2_Inbound-20260623-001 のフローを追跡してください。」
- 「本番ワークスペースの健全性を確認してください。」
- 「すべてのSFTP コネクタを一覧表示してください。」
- 「今朝のセッションについて、SFTP Server のサービスログを表示してください。」
- あなた: Production ワークスペースのAS2_Outbound コネクタで、メッセージAS2_Outbound-20260814-001 を再キューしてください。
- AI クライアント: Production ワークスペースのAS2_Outbound コネクタで、メッセージAS2_Outbound-20260814-001 を再キューします。これにより、コネクタはメッセージを再度処理します。続行しますか?
- あなた: はい。
- AI クライアント: 完了しました。メッセージが再キューされました。
セキュリティに関する注意事項
- MCP サーバーはArc の既存の認証および認可を尊重します。ユーザーは、アクセス権限を持つデータのみを閲覧できます。
- 常にHTTPS 経由で接続してください。
x-cdata-authtokenはすべての呼び出しでリクエストヘッダーとして送信されます。プレーンなHTTP 経由では、通信中に公開されてしまいます。http://はlocalhostに対するテスト時にのみ使用してください。 - 秘密情報の値(パスワード、トークン、秘密鍵)はツールのレスポンスでマスクされます。
- 暗号化されたvault エントリの値は決して返されません。
- authtoken は、クライアント設定ファイルにインライン値として記載するのではなく、OS の環境変数に保存してください。Authtoken を安全に保管するを参照してください。
- アクションツールは、操作の実行前に必ずユーザーの明示的な確認を必要とし、すべてのアクションが監査されます。読み取り専用アクセス権のユーザーはアクションツールを呼び出せません。
このリリースにおける既知の制限事項
- 詳細モードで返される大きなメッセージペイロードはサイズが大きくなる場合があり、AI クライアントでのトークン使用量に影響することがあります。
- サービスログはセッション単位で取得されます。1つのセッションが複数のファイルにまたがる場合、
diagnose_messageが返す関連証跡には同じセッション内の他のファイルが含まれることがあります。これは想定された動作です。 - 相関Id は主要なメッセージ処理パスをカバーします。一部のパス(特定のスケジュールされたリトライワーカーなど)では、相関Id が付与されない場合があります。