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

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

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

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

| HTML | Markdown |
| --- | --- |
| `/quickstart/` | `/quickstart.md` |
| `/en/signing/` | `/en/signing.md` |
| `/` | `/index.md` |

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

## 2. llms.txt { #llms-txt }

- <a href="/llms.txt"><code>/llms.txt</code></a> — список всех страниц на двух языках с однострочным
  описанием, по [стандарту llms.txt](https://llmstxt.org/).
- <a href="/llms-full.txt"><code>/llms-full.txt</code></a> — вся документация одним файлом.
  Удобно вставить в контекст целиком.

## 3. MCP-сервер документации { #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 Code"

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

=== "Cursor"

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

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

=== "Codex"

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

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

=== "ChatGPT"

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

## Подсказка для ассистента { #prompt }

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

```text
Ты помогаешь интегрировать платёжный 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}} (свой у песочницы и боя) держи в настройке, не в коде.
```