mcp
POST /v1/mcp
The MCP JSON-RPC 2.0 protocol endpoint.
Аутентификација
Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X POST https://api.zinndigital.com/v1/mcp \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "jsonrpc": <string<2.0>>, "method": <string> }'Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
The Model Context Protocol endpoint (initialize, tools/list, tools/call, resources/list, resources/read, ping). Authenticated only by a zmcp_… connection token (Authorization: Bearer zmcp_…); a missing/invalid token returns 401 with a WWW-Authenticate challenge pointing at the resource-metadata document. Each call runs under the connecting org's RLS scope and is gated by the connection's RBAC scopes; a batch (JSON array) is accepted. The tool catalogue is additionally filtered by the connecting org's role (customer, reseller's client, agency, reseller, staff), in tools/list and tools/call alike — a role-hidden tool answers unknown tool, never forbidden. An entitlement refusal (a full plan, a feature not on the tier) is returned as a tool result carrying a structured upgrade offer, never as a JSON-RPC error.
Тело захтева
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
jsonrpc | string<2.0> | Да | — |
id | string | integer | Не | Request id (string or number); omit for a notification. |
method | string | Да | — |
params | object | Не | — |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
jsonrpc | string<2.0> | Да | — |
id | string | integer | null | Да | — |
result | object | Не | — |
error | object | Не | — |
Грешке које ова крајња тачка може вратити
401 · 429