Generate device code for CLI/MCP authentication

POST

/auth/device/code

• Staging
• Production (planned)

CLI や MCP Server からのデバイス認証フローを開始する。 発行された userCode をユーザーがブラウザで承認することで API Key を取得できる。

Request Body ^required

object

client

required

認証を要求するクライアント種別

string

Allowed values: cli mcp

callbackUrl

Localhost callback URL for CLI OAuth flow (http://localhost:PORT/… only)

string

Example

http://localhost:12345/callback

Responses

200

デバイスコード発行成功

object

deviceCode

ポーリング時に使用するデバイスコード (秘密)

string

userCode

ユーザーが入力する人間可読コード (例: ABCD-EFGH)

string

verificationUrl

ユーザーが認証するための URL

string format: uri

verificationUrlComplete

UserCode 埋め込み済みの完全な認証 URL

string format: uri

expiresIn

コードの有効期限 (秒)

integer

interval

ポーリング推奨間隔 (秒)

integer

400

バリデーションエラー

object

error

object

code

string

Example

VALIDATION_ERROR

message

string

Example

Invalid request body

status

integer

Example

400

upgradeUrl

URL to upgrade plan (only present for plan limit errors)

string

Example

https://app.manako.dev/billing

429

レート制限超過

object

error

object

code

string

Example

VALIDATION_ERROR

message

string

Example

Invalid request body

status

integer

Example

400

upgradeUrl

URL to upgrade plan (only present for plan limit errors)

string

Example

https://app.manako.dev/billing