セーフティとトラブルシューティング

セキュリティ境界

• プロバイダーの token とカスタム OAuth シークレットは、ゲートウェイのクレデンシャルストアに保管されます。プロジェクトファイル、ブラウザストレージ、SQLite、ログには一切入りません。
• 接続済みアカウントはプロバイダーへのアクセスを許可しますが、全タスクへの一括アクセスを許可するわけではありません。必要なタスクに対してのみ Connector を有効にしてください。
• 書き込みは 1 つのアカウントに解決され、アクション固有の確認が保持されます。
• カスタム MCP ツールはデフォルトで無効になっており、使用のたびに確認が必要です。
• 証券取引の注文には、アカウント解決・プレビュー・新規確認・再検証・受領証が必要です。バックグラウンドタスクとサブ Agent は注文を送信できません。

接続ウィンドウが成功せずに閉じる

権限ダイアログに戻り、エラーが表示されていないか確認してください。OAuth ウィンドウが閉じられた場合、コールバックの有効期限が切れた場合、またはプロバイダーがアクセスを拒否した場合、Minara はローディング状態を終了します。

以下の手順を確認してください。

1. Minara サイトのポップアップを許可する。
2. 同じブラウザプロファイルでサインインを完了する。
3. コールバックが現在のゲートウェイに到達したことを確認する。
4. コネクターを管理 から再試行する。
5. ボタンが無効になっている場合は、詳細ビューで利用不可の理由を確認する。

以前の認証ウィンドウがまだ開いている間は、サインインを繰り返さないでください。

Connect が利用できない

現在のビルドに必要なプロバイダー接続が存在しない場合、プロバイダーがまだ統合を承認中の場合、またはプレビュー MCP サービスが有効化されていない場合があります。詳細ダイアログに理由が表示されます。利用できない Connector に対して、Minara は OAuth ステートの作成やウィンドウの表示を行いません。

接続後に権限が拒否される

サービスレベルと選択したアカウントを確認してください。読み取り権限では書き込み操作は実行できません。アクセスが期限切れまたは取り消されたアカウントは再接続が必要です。権限が引き下げられた場合、Minara は即座にその操作をブロックします。古いスコープをプロバイダー側で削除するには、再接続してください。

MCP ツールが見つからない

オフィス系の組み込み Connector は、プリフライトチェック時にアクションのルートを選択します。MCP ツールが存在せず、組み込みアダプターがそのアクションに対応している場合にのみ REST ルートが使用されます。ランタイムのタイムアウト、401、429、5xx、スキーマの不一致、または不明な結果が発生してもルートは切り替わりません。

カスタム MCP および証券取引 Connector には REST ルートがありません。MCP サーバーまたはその認証設定を修正してから再試行してください。

クラウドファイルの競合

Drive と OneDrive の更新では、eTag などのプロバイダーバージョンチェックが使用されます。ファイルを更新して新しいバージョンを確認してください。Minara は競合するクラウド編集を通知なしに上書きすることはありません。

クラウドへの公開が失敗する

Connector 経由での配信を行う場合、Minara は公開前にローカルのアーティファクトが正規のものであることを検証します。クラウドへの公開が失敗した場合でも、ローカルファイルは引き続き利用できます。アカウントまたは送信先を修正してから再度公開を試みてください。

注文結果が不明

同じ注文を再送信しないでください。Minara はまずローカルのインテント ID とプロバイダーの注文状態を照合します。重要なフィールド、推定コスト、アカウント状態、またはプレビューに変更があった場合は、再度確認を求めます。

ブローカーのスナップショットは、税務・会計・TWR・XIRR・監査レベルの過去実績に関する情報をサポートしていません。これらの用途にはブローカーまたはカストディアンから記録をエクスポートしてください。

有料 MCP が payment required を返す

x402 料金に exact、正規 USDC、EVM または Solana ネットワークがあることを確認します。未対応の方式や資産を通常のウォレット送金に置き換えることはありません。支払い後は同一の MCP 呼び出しを一度だけ再試行します。

直接接続で challenge_id が返らない場合、402 応答がプロトコルに準拠していない可能性があります。ホスト型 Broker では x402 ヘッダーの転送を確認してください。結果が不明な場合は状態を確認し、重複して支払わないでください。