# Zolotenkov MRP для разработчиков

> Документация публичного API и подключения ИИ-агентов к Zolotenkov MRP. Основной язык документации — русский.

## Документация

- [Портал для разработчиков](https://developer.zolotenkov.ru/): точка входа, возможности и быстрый старт.
- [Полное руководство](https://developer.zolotenkov.ru/guide/): ключи, права, запросы, ограничения, сценарии, MCP и вебхуки.
- [Полное руководство в Markdown](https://developer.zolotenkov.ru/guide.md): та же документация без интерфейса сайта.
- [Подключение ИИ-агента](https://developer.zolotenkov.ru/mcp/): готовая конфигурация MCP и правила безопасной выдачи прав.
- [Интерактивный справочник API](https://mrp.zolotenkov.ru/api/external/v1/docs/): ручки, параметры, тела запросов и схемы ответов.
- [OpenAPI 3.1](https://mrp.zolotenkov.ru/api/external/v1/openapi.json): машиночитаемый источник истины для всех ручек и схем.

## Точки подключения

- REST API: https://mrp.zolotenkov.ru/api/external/v1
- MCP, streamable HTTP: https://mrp.zolotenkov.ru/api/external/v1/mcp
- Выпуск и отзыв ключей: https://mrp.zolotenkov.ru/settings/api

## Обязательные правила

- Передавайте ключ только сервером в заголовке Authorization: Bearer <ключ>.
- Выдавайте агенту минимальный набор прав и короткий срок действия.
- Для каждой операции записи передавайте Idempotency-Key; при повторе используйте прежнее значение.
- Сохраняйте X-Request-Id из ответа для диагностики.
- Полный и актуальный перечень действий всегда берите из OpenAPI, а не из этого файла.