操作ごとにアクセスを確認してください。読み取りには対応する権限、レコード変更にはプレビューと再試行キー、送信には責任者が確認した有効なポリシーが必要です。同意、配信停止、ライセンス、法域も確認してください。
リスク階層は何ですか
| 階層 | アクション | 管理 |
|---|---|---|
| R0 | workspace.context、workspace.capabilities | スコープworkspace:read。スコープ付与時は常時一覧表示されます。 |
| R1 | companies.*、trade.*、contacts.*、leads.list、campaigns.list | 対応する読み取り権限とワークスペースの利用資格。 |
| R2 | leads.create、campaigns.draft | 作成権限、dry_run プレビュー。実際の書き込みには idempotency_key が必要です。 |
| R3 | email.send、sms.send | 送信権限、責任者が確認した有効な policy_id、dry_run プレビュー。実際の送信には idempotency_key が必要です。 |
tools/list で接続に利用できるツールを確認してください。利用範囲は付与された権限とワークスペースの利用資格によって異なります。読み取り権限から始め、不足する権限は管理者に確認してください。広範な権限を要求しないでください。
常設ポリシーと確認はどのように動作しますか
送信を有効にする前に、責任者が対象者、送信者、メッセージの主張、同意、配信停止、適用法域、ライセンス、予算上限を確認してください。許可された送信には有効な常設ポリシーの policy_id を使用し、dry_run: true でプレビューしてください。常設ポリシーは複数の送信を許可する場合があり、各メッセージを人が個別に承認するという意味ではありません。対象の適格性や権限が不明な場合は作業を停止してください。
ドライランと冪等キーをどのように使用しますか
- すべてのR2／R3アクションでは最初に
dry_run: trueを送信します。サーバーはレコード書き込みやメッセージ送信を行わずにスコープ、ポリシー、引数を検証します。 - 意図した書き込みごとにUUIDの
idempotency_keyを1件生成し、再試行時も再利用します。繰り返されたキーは重複するリード、下書き、送信を作成せず、元の結果を返します。 - タイムアウトした書き込みを再試行する際に新しいキーを生成しないでください。キーは自身のログで
request_idとともに保存します。 - 実際の書き込みや送信には必須です。同じ引数で同じ操作を再試行する場合は同じ UUID を使用してください。
適用されるクォータは何ですか
リクエストと使用量の上限は、ワークスペースの利用資格と操作によって異なります。現在の使用量は管理者に確認してください。quota_exceeded では Retry-After と返されたリセット時刻に従い、回数を制限して待機時間を延ばしながら再試行してください。並列再試行、追加クライアント、新しいポリシーで上限を回避しないでください。
quota_exceededにはreset_atとretry_afterが含まれます。Retry-Afterに従い、制限付きバックオフで再試行してください。429に対して並列再試行を行わないでください。
アクセスを取り消し、活動を確認する方法
POST /oauth/revokeで取り消すか、Settings → IntegrationsでOAuthクライアントを削除します。取り消しはそのトークンのMCPとRESTエージェント呼び出しの両方を停止します。- ポリシー確認、送信、ポリシー変更についてワークスペース監査イベントを確認します。
- 上限引き上げや新規クライアント追加の前に、日次と期間内の使用量を確認します。
- ログ、スクリーンショット、チケットに現れたトークンは入れ替えてください。トークンをサポートに送らないでください。マスクした
request_id、タイムスタンプ、ツール名、エラーコードを送ってください。