Настройка MCP-сервера
Подключи htmlkin.ru по протоколу MCP — и агент будет публиковать и обновлять HTML-страницы, PDF-документы и текстовые статические сайты прямо из диалога.
Что это
MCP (Model Context Protocol) — открытый протокол, по которому ИИ-ассистенты подключают внешние инструменты. MCP-сервер htmlkin.ru уже развёрнут на нашей стороне и доступен по адресу https://htmlkin.ru/mcp — устанавливать и запускать ничего не нужно, достаточно добавить адрес в настройки ассистента и указать API-ключ.
Что нужно
- API-ключ htmlkin.ru — создаётся в личном кабинете на странице «API-ключи»
- MCP-клиент — Claude, Cursor или другой ассистент с поддержкой MCP.
Подключение
Адрес сервера — https://htmlkin.ru/mcp. API-ключ передаётся заголовком Authorization: Bearer; если клиент не умеет задавать заголовки — добавь ключ прямо в адрес: https://htmlkin.ru/mcp?key=hk_твой_ключ.
claude mcp add --transport http htmlkin https://htmlkin.ru/mcp \
--header "Authorization: Bearer hk_твой_ключ"Settings → Connectors → Add custom connector, в поле URL укажи адрес с ключом: https://htmlkin.ru/mcp?key=hk_твой_ключ.
Любой клиент с поддержкой HTTP-транспорта подключается таким конфигом:
{
"mcpServers": {
"htmlkin": {
"type": "http",
"url": "https://htmlkin.ru/mcp",
"headers": {
"Authorization": "Bearer hk_твой_ключ"
}
}
}
}Ключ в адресе (?key=) может оседать в истории и логах клиента — где возможно, предпочитай заголовок. Если ключ скомпрометирован, отзови его и выпусти новый в личном кабинете.
Инструменты
После подключения ассистенту доступны четыре инструмента:
| Инструмент | Назначение |
|---|---|
| htmlkin_publish | Опубликовать HTML, PDF или набор текстовых файлов сайта и получить адрес. |
| htmlkin_update | Полностью заменить сайт (HTML, PDF или files) и/или изменить PIN. |
| htmlkin_get | Получить адрес, размер, число файлов, entrypoint, срок жизни и PIN. |
| htmlkin_delete | Удалить сайт; привязанный домен остаётся в аккаунте. |
Просто попроси ассистента: «опубликуй этот сайт на htmlkin.ru» — он вызовет htmlkin_publish и вернёт ссылку. Полное описание параметров и коды ошибок — в документации REST API.
В htmlkin_publish и htmlkin_update можно передать параметр files: массив объектов { path, content }. Допускается до 20 текстовых файлов и до 2 МБ UTF-8 суммарно; в корне обязателенindex.html. Поддерживаются HTML, CSS, JS, JSON, SVG, XML, Markdown и другие текстовые расширения из описания инструмента.
Update всегда полностью заменяет текущий сайт. Если обновить многофайловый сайт однимhtml_content, он станет single-file. Binary-файлы и большие сайты не передавай base64 через arguments: загрузи ZIP в REST API (site_archive) или используй браузер.