Начало работы
ИИ-ассистенты и MCP
Как подключить документацию Ketmus к ChatGPT, Claude, Claude Code, Cursor, VS Code и Codex, чтобы ИИ сам написал интеграцию.
Документация Ketmus доступна в форматах, которые удобно читать языковым моделям. Подключите её к своему ИИ-ассистенту, и он будет писать код по актуальным методам API, а не по догадкам.
Меню «Копировать»
На каждой странице справа от заголовка есть кнопка Копировать. Она копирует страницу в Markdown, а стрелка рядом открывает меню: просмотр Markdown, открытие страницы в ChatGPT или Claude и подключение MCP-сервера.
MCP-сервер
MCP-сервер даёт ассистенту инструменты для поиска и чтения документации. Адрес сервера: https://docs.ketmus.com/mcp (транспорт Streamable HTTP, авторизация не нужна).
| Инструмент | Что делает |
|---|---|
search_docs | Ищет по документации и возвращает подходящие разделы со ссылками. |
get_page | Возвращает страницу целиком в Markdown по её slug, например create-invoice или telegram-bot. |
list_pages | Возвращает список всех страниц с описаниями. |
Claude Code
claude mcp add --transport http ketmus-docs https://docs.ketmus.com/mcpCodex
codex mcp add ketmus-docs --url https://docs.ketmus.com/mcpCursor
Добавьте сервер в .cursor/mcp.json в корне проекта или в глобальные настройки MCP.
{
"mcpServers": {
"ketmus-docs": {
"url": "https://docs.ketmus.com/mcp"
}
}
}VS Code
Выберите Подключиться к VSCode в меню «Копировать» или добавьте сервер в .vscode/mcp.json вручную.
{
"servers": {
"ketmus-docs": {
"type": "http",
"url": "https://docs.ketmus.com/mcp"
}
}
}Claude и ChatGPT
В Claude добавьте сервер в Settings → Connectors → Add custom connector с адресом https://docs.ketmus.com/mcp. В ChatGPT это делается в режиме разработчика через Settings → Connectors. Если подключать сервер не хочется, выберите в меню Открыть в ChatGPT или Открыть в Claude: ассистент откроет страницу и ответит по ней.
llms.txt и Markdown
- https://docs.ketmus.com/llms.txt — оглавление документации со ссылками на Markdown-версии страниц.
- https://docs.ketmus.com/llms-full.txt — вся документация одним файлом. Его можно приложить к чату целиком.
https://docs.ketmus.com/md/<slug>.md— любая страница в Markdown, например /md/create-invoice.md.
Пример запроса к ассистенту
Используя MCP-сервер ketmus-docs, добавь в моего Telegram-бота на aiogram 3 команду /buy:
- создавай счёт Ketmus на 9.99 USD с metadata.telegram_user_id;
- отправляй пользователю кнопку только с pay_url, даже для СБП — не используй payment_uri и ссылки qr.nspk.ru;
- прими вебхук, проверь подпись x-ketmus-signature и выдай доступ по invoice.paid один раз.
Ключи бери из переменных окружения KETMUS_API_KEY, KETMUS_WEBHOOK_SECRET и BOT_TOKEN.Не вставляйте ключи в чат
Ассистенту не нужен ваш API-ключ или секрет вебхуков. Храните их в переменных окружения и передавайте коду, а не модели.