---
title: "MCP-endpoint (JSON-RPC 2.0, Streamable HTTP)"
method: POST
path: "/mcp"
tags: ["misc"]
---

# MCP-endpoint (JSON-RPC 2.0, Streamable HTTP)

`POST /mcp`

## Request

- Base URL: `https://maketa.pro/maketa/api`
- URL: `https://maketa.pro/maketa/api/mcp`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-maketa-key`

Model Context Protocol для ИИ. Авторизация Bearer: OAuth 2.1-токен (полный per-user доступ, discovery /.well-known/oauth-authorization-server), проектный ключ mk_pk_ (headless, рамки своей доски — boardId обязателен в аргументах; push-only: maketa_list_screens, maketa_push_code_screen, maketa_list_branches, maketa_get_parent, остальные → JSON-RPC error {code:403, message:"forbidden_for_project_key: …", data:{tool, allowed, hint}}) или песочный ключ mk_sb_ (headless, доски песочницы, все инструменты). Ключи принимаются и в заголовке x-maketa-key. Начните с tools/list; инструменты maketa_*. Правка дерева — maketa_add_node, maketa_update_node, maketa_move_node, maketa_remove_node; чтение структуры — maketa_get_tree (вложенный вид) и maketa_get_screen (как лежит на диске). Инструментов *_element больше нет: в v2 узел не двигают в координаты, его переносят к другому родителю. Предел тарифа в инструменте записи — JSON-RPC error {code:402, message:"plan_limit: …", data:{limit, used, max, plan, upgrade, hint}}.

## Request body

- object: JSON-RPC 2.0 запрос или батч

## Response `200`

JSON-RPC ответ

## Other responses

- `401`: invalid_token

---

[API](https://skmtc.dev/maketa/apis/maketa-api.md) · [All operations](https://skmtc.dev/maketa/apis/maketa-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maketa/apis/maketa-api/revisions/ef044d6259d8?raw)