認証とトークン

公開 API は個人アクセストークン（PAT）で認証します。1つのトークンはアカウントに紐付けられており、付与されたスコープの範囲内でアカウント内のすべてのエンティティへのアクセスを提供します。

トークンの作成

個人トークンは個人ページの個人トークンセクションで作成します。トークンの値は作成時に一度だけ表示されます。安全な場所に保存してください。サーバーにはハッシュ化された形式でのみ保存されており、復元はできません。紛失した場合は新しいトークンを発行し、古いものを削除してください。

すべての個人トークンは mbp_ プレフィックスで始まります。

トークンの送信

各リクエストで、Bearer スキームによる Authorization HTTP ヘッダーでトークンを送信します:

Authorization: Bearer mbp_YOUR_TOKEN

同じヘッダーはウェブキャビネットからのセッションアクセスにも使用されます（ここでは短命の JWT）。ただし、連携には必ず個人トークン mbp_… を使用してください。

スコープ（アクセス権）

トークンには リソース:アクション 形式のスコープのセットがあります。読み取りには :read サフィックスが、変更には :write が必要です。利用可能なスコープ:

bots:read、bots:write — ボット、設定、同期、ボットトークン。
reactions:read、reactions:write — リアクション、インポート、数式テスト、リンク、順序。
labels:read、labels:write — 購読者のラベル。
collections:read、collections:write — コレクションとレコード。
flows:read、flows:write — シナリオ（フロー）。
integrations:read、integrations:write — 連携、接続、認証情報。
media:write — メディアライブラリへのアップロード。
templates:read、templates:write — ボットテンプレート。
settings:read、settings:write — 設定。
subscribers:read — 購読者とダイアログ履歴（読み取り）。
broadcasts:write — 一斉配信の管理。
stats:read — 統計と分析。
billing:read — 残高とプラン（読み取り）。

特別なスコープ * はすべての公開エンドポイントへのフルアクセスを付与します。

トークンでできること・できないこと

個人トークンではコンストラクター用エンドポイント（「ボット構築を支援する」もの）のみにアクセスできます。PAT でアクセス不可（ウェブセッションのみ）: ログインと登録、モバイルエンドポイント、支払いと残高のチャージ、通知、監査ログ、オペレーターによるダイアログへのメッセージ送信、受信 Webhook と支払いコールバック、WebSocket。これらのルートに mbp_ トークンでアクセスすると 401 または 403 が返されます。

トークンに特定ルートに必要なスコープがない場合、403 が返されます。エラーコードの詳細はエラーガイドを参照してください。

次のステップ

API クイックスタート — トークンを使った最初のリクエスト。
エラー — 401 と 403 の意味。
MCP — エージェントインターフェース向けの同じトークン。