misc

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

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}}.

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

Request body

object required

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

Response

JSON-RPC ответ

Changes

No recorded changes to this operation across all 1 revision of this API.