Перейти к содержанию

Для ИИ-агентов

Документация устроена так, чтобы ИИ-ассистент — Claude, ChatGPT, Cursor, Codex — мог прочитать её целиком и написать интеграцию без догадок. Есть три способа.

1. Markdown-версия любой страницы

Добавьте .md к адресу страницы — получите её исходный Markdown с примерами кода:

HTML Markdown
/quickstart/ /quickstart.md
/en/signing/ /en/signing.md
/ /index.md

В шапке каждой страницы есть кнопка «Скопировать как Markdown» и меню «Спросить в ChatGPT / Claude» — ассистент откроется со ссылкой на страницу.

2. llms.txt

  • /llms.txt — список всех страниц на двух языках с однострочным описанием, по стандарту llms.txt.
  • /llms-full.txt — вся документация одним файлом. Удобно вставить в контекст целиком.

3. MCP-сервер документации

MCP-сервер даёт ассистенту инструменты поиска и чтения документации. Только чтение, без авторизации.

Инструмент Что делает
search_docs(query, lang) Поиск по документации, возвращает разделы с цитатами
get_page(path, lang) Страница целиком в Markdown
list_pages(lang) Все страницы с описаниями
get_api_operation(operation_id) Метод API из спецификации OpenAPI: createPayment, getPayment, getProject
get_code_example(language, topic) Проверенный пример: curl, php, python, node, go × sign_request, verify_callback, create_sbp_payment, generate_key, callback_receiver

Страницы доступны и как ресурсы MCP: docs://ru/quickstart, docs://en/signing.

Адрес сервера: /mcp — на том же хосте, что и документация (транспорт Streamable HTTP).

claude mcp add --transport http payment-api-docs /mcp

Файл .cursor/mcp.json в проекте или ~/.cursor/mcp.json:

{
  "mcpServers": {
    "payment-api-docs": { "url": "/mcp" }
  }
}

Файл ~/.codex/config.toml:

[mcp_servers.payment-api-docs]
url = "/mcp"

В ChatGPT: Settings → Apps & Connectors → Advanced → Developer mode, затем Create и укажите адрес сервера, авторизация — No authentication. ChatGPT подключается только к публичному https://-адресу: для локальной копии документации используйте туннель.

Подсказка для ассистента

Скопируйте в начало разговора:

Ты помогаешь интегрировать платёжный API. Источник правды — документация:
/mcp (MCP) или llms.txt. Правила:
- Каждый POST подписывается по RFC 9421 Ed25519: возьми готовую функцию
  get_code_example(<язык>, "sign_request") и не пиши подпись с нуля.
- Проверь функцию на проверочном примере со страницы signing.
- merchant_payment_id — ключ идемпотентности: при повторе тот же номер, новая подпись.
- Callback проверяй HMAC-SHA256 по сырому телу: get_code_example(<язык>, "verify_callback").
- Адрес API {{base_url}} (свой у песочницы и боя) держи в настройке, не в коде.