hosting

POST `/v1/sites/{siteId}/ide-mcp`

The platform MCP server, reached from inside the site's web editor.

Autenticazione

Questo endpoint è pubblico. Non richiede credenziali né alcuna organizzazione: è ciò che leggono il nostro sito di marketing e i nostri motori di risposta basati su IA.

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 POST https://api.zinndigital.com/v1/sites/{siteId}/ide-mcp \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc": <string<2.0>>, "method": <string> }'

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

A JSON-RPC 2.0 MCP endpoint — the **same** server, registry, write gate, confirmation guard, audit trail and spend caps as `/v1/mcp`, reached through a different door. What differs is only the credential: this one accepts the editor's own signed grant, so the editor can be shipped with our MCP server already connected without a customer's hosting jail ever holding an `McpConnection` token. The editor's own MCP client is seeded to point at the session gate on the hosting box; the gate attaches the grant and relays here. One request, one response — a notification (no `id`) answers `202` with no body, and a JSON array is accepted as a batch. **Deliberately narrower than a connection a customer mints themselves.** An MCP token can never out-scope the human who created it, and an editor grant carries that person's name rather than their permissions — so this connection is scoped to what the editor already is: the customer's sites, their control panels and their cache. Opening an editor is not a privilege escalation.

Parametri

Nome	Tipo	Obbligatorio	Che cos'è
`siteId (path)`	`Uuid`	Sì	Site ID (UUIDv7).

Corpo della richiesta

Nome	Tipo	Obbligatorio	Che cos'è
`jsonrpc`	`string<2.0>`	Sì	—
`id`	`string \| integer`	No	Request id (string or number); omit for a notification.
`method`	`string`	Sì	—
`params`	`object`	No	—

Risposta

Nome	Tipo	Obbligatorio	Che cos'è
`jsonrpc`	`string<2.0>`	Sì	—
`id`	`string \| integer \| null`	Sì	—
`result`	`object`	No	—
`error`	`object`	No	—

Errori che questo endpoint può restituire

404 · 422

POST /v1/sites/{siteId}/ide-mcp