hosting
POST /v1/sites/{siteId}/ide-mcp
The platform MCP server, reached from inside the site's web editor.
Autenticação
Este endpoint é público. Ele não requer credenciais nem organização — é o que nosso próprio site de marketing e os mecanismos de resposta de IA leem.
Este endpoint não requer um ID de organização. Sua chave já identifica a organização à qual pertence, e a resposta é delimitada a ela.
Experimente
Substitua qualquer item entre colchetes por seus próprios valores e o espaço reservado para a chave por uma chave do seu painel.
curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/ide-mcp \
-H "Content-Type: application/json" \
-d '{ "jsonrpc": <string<2.0>>, "method": <string> }'Conectado? O console da API no seu painel preenche o ID da sua organização real e a sua própria chave, e executa a requisição contra a API de produção para que você possa ver a resposta real. Abra este endpoint no console da API
Detalhes
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.
Parâmetros
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
siteId (path) | Uuid | Sim | Site ID (UUIDv7). |
Corpo da requisição
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
jsonrpc | string<2.0> | Sim | — |
id | string | integer | Não | Request id (string or number); omit for a notification. |
method | string | Sim | — |
params | object | Não | — |
Resposta
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
jsonrpc | string<2.0> | Sim | — |
id | string | integer | null | Sim | — |
result | object | Não | — |
error | object | Não | — |
Erros que este endpoint pode retornar
404 · 422