mcp

GET /v1/mcp/connections/{connectionId}

Get an MCP connection.

Tutti gli endpoint mcp

Autenticazione

Invia una chiave API come bearer token. Questo endpoint non specifica un permesso specifico nella specifica, quindi assegna alla tua chiave i permessi minimi necessari e verifica la risposta invece di fare supposizioni.

Questo endpoint non richiede alcun ID organizzazione. La tua chiave identifica già l'organizzazione a cui appartiene e la risposta è limitata ad essa.

Provalo

Sostituisci qualsiasi elemento tra parentesi angolari con i tuoi valori e il segnaposto key con una chiave dalla tua dashboard.

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

Hai effettuato l'accesso? La console API nella tua dashboard inserisce il tuo ID organizzazione reale e la tua chiave personale, ed esegue la richiesta sull'API live in modo da poter vedere la risposta effettiva. Apri questo endpoint nella console API

Dettagli

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

Parametri

NomeTipoObbligatorioChe cos'è
connectionId (path)UuidThe MCP connection's id.

Risposta

NomeTipoObbligatorioChe cos'è
idUuidUUIDv7 identifier — sortable by creation time (docs/02 §8).
namestring
clientMcpClientThe AI client a connection is for (informational).
prefixstringThe token's public lookup prefix (not a secret).
scopesstring[]The RBAC permission keys this connection's token may exercise.
sandboxboolean
spend_cap_minorinteger | nullNoOptional per-window budget (integer minor units, CLAUDE.md §2.8) for AI-triggered paid actions. Null = no cap.
spend_currencyCurrencyCodeNoISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
spend_window_secondsintegerThe rolling window the spend cap applies over.
last_used_atstring | nullNo
revoked_atstring | nullNo
created_atstring

Errori che questo endpoint può restituire

401 · 403 · 404 · 429