mcp

GET `/v1/mcp/connections/{connectionId}`

Get an MCP connection.

認証

ベアラートークンとして API キーを送信します。このエンドポイントでは仕様に特定の権限が記載されていないため、キーに必要な最小限の権限を付与し、推測するのではなくレスポンスを確認してください。

このエンドポイントは組織IDを受け付けません。お使いのキーによって所属する組織がすでに特定されており、レスポンスはその組織にスコープされます。

アングルブラケット内のすべてをご自身の値に置き換え、キーのプレースホルダーをご利用中のダッシュボードのキーに置き換えてください。

curl -X GET https://api.zinndigital.com/v1/mcp/connections/{connectionId} \
  -H "Authorization: Bearer zdk_live_…"

ログインしていますか？ダッシュボード内のAPIコンソールでは、実際の組織IDやお客様ご自身のキーが自動入力され、ライブAPIに対してリクエストが実行されるため、実際のレスポンスを確認することができます。 API コンソールでこのエンドポイントを開く

Returns one non-revoked connection's metadata (never the token). RBAC + RLS scoped.

名前	タイプ	必須	これがその内容です
`connectionId (path)`	`Uuid`	はい	The MCP connection's id.

名前	タイプ	必須	これがその内容です
`id`	`Uuid`	はい	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`name`	`string`	はい	—
`client`	`McpClient`	はい	The AI client a connection is for (informational).
`prefix`	`string`	はい	The token's public lookup prefix (not a secret).
`scopes`	`string[]`	はい	The RBAC permission keys this connection's token may exercise.
`sandbox`	`boolean`	はい	—
`spend_cap_minor`	`integer \| null`	いいえ	Optional per-window budget (integer minor units, CLAUDE.md §2.8) for AI-triggered paid actions. Null = no cap.
`spend_currency`	`CurrencyCode`	いいえ	ISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
`spend_window_seconds`	`integer`	はい	The rolling window the spend cap applies over.
`last_used_at`	`string \| null`	いいえ	—
`revoked_at`	`string \| null`	いいえ	—
`created_at`	`string`	はい	—

401 · 403 · 404 · 429