> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Интеграция с AI

> Подключите документацию Raydium в своего кодирующего агента или LLM-воркфлоу — MCP-сервер, индекс llms.txt, копирование по страницам и готовые файлы контекста.

<Info>
  **Эта страница переведена с помощью ИИ. За эталон принимается английская версия.**

  [Открыть английскую версию →](/sdk-api/ai-integration)
</Info>

<Info>
  Эта документация разработана для использования как AI-инструментами, так и людьми. Если вы работаете с кодирующим агентом (Claude Code, Cursor, Windsurf, Continue и т. д.) или запускаете RAG над документацией, приведённые ниже поверхности позволяют подключить документацию Raydium без необходимости в пользовательском скрейпинге.
</Info>

## Что доступно

| Поверхность                      | URL-паттерн                                                                                  | Когда использовать                                                                                                                  |
| -------------------------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **MCP-сервер**                   | `https://docs.raydium.io/mcp`                                                                | Вы хотите, чтобы ваш AI-редактор (Claude Code, Cursor, Windsurf и т. д.) мог запрашивать и цитировать документацию Raydium нативно. |
| **Индекс `llms.txt`**            | `https://docs.raydium.io/llms.txt`                                                           | Вы строите RAG-пайплайн и вам нужен плоский индекс всех страниц.                                                                    |
| **Тело `llms-full.txt`**         | `https://docs.raydium.io/llms-full.txt`                                                      | Вы хотите весь корпус документов в виде одного объединённого файла для офлайн-индексирования.                                       |
| **Меню копирования по странице** | Кнопка `Copy page` в верхней части каждой страницы контента                                  | Вы копируете одну страницу в чат с LLM.                                                                                             |
| **Глубокие ссылки по странице**  | `View as Markdown`, `Open in ChatGPT`, `Open in Claude`, `Open in Cursor`, `Open in VS Code` | Одноклик переход со страницы документации в выбранный инструмент.                                                                   |

Кнопка `Copy page` и меню глубоких ссылок находятся в верхнем правом углу каждой страницы (рядом с названием страницы). Оба работают на основе контекстного меню платформы документации.

## MCP-сервер

MCP (Model Context Protocol) сервер позволяет AI-клиентам запрашивать документацию Raydium как инструмент. После настройки ваш агент может попросить «search Raydium docs for `addLiquidity` parameters» и получить авторитетные ответы со ссылками.

### Claude Code

```bash theme={null}
claude mcp add --transport http raydium-docs https://docs.raydium.io/mcp
```

После добавления попросите Claude Code «search the Raydium docs for X» и он будет использовать инструмент.

### Cursor

Добавьте в настройки Cursor (`Cmd/Ctrl + ,` → MCP):

```json theme={null}
{
  "mcpServers": {
    "raydium-docs": {
      "url": "https://docs.raydium.io/mcp"
    }
  }
}
```

### Windsurf, Continue, универсальные клиенты

Любой MCP-совместимый клиент может указывать на `https://docs.raydium.io/mcp`. Если ваш клиент требует манифеста, он находится по адресу `https://docs.raydium.io/mcp/.well-known/mcp.json`.

### Что предоставляет сервер

MCP-сервер документации Raydium предоставляет один основной инструмент, `search_docs(query: string)`, который возвращает наиболее релевантные отрывки для запроса вместе с их каноническими URL. Агент отвечает за цитирование использованного URL; мы не отслеживаем и не ограничиваем количество запросов на одного агента.

## `llms.txt` для RAG

`llms.txt` — это развивающийся стандарт для «машиночитаемого индекса документации». Raydium публикует:

* `https://docs.raydium.io/llms.txt` — плоский список каждой страницы с названием и однострочной аннотацией, организованный по главам.
* `https://docs.raydium.io/llms-full.txt` — полное Markdown-тело каждой страницы, объединённое, с сохранением границ страниц в виде заголовков.

Вариант `full` пересоздаётся при каждом развёртывании документации. Извлекайте его по расписанию (раз в день достаточно) или по требованию.

```bash theme={null}
# Поместите весь корпус документов в ваш RAG-пайплайн.
curl -sSL https://docs.raydium.io/llms-full.txt -o raydium-docs.md
```

## Меню передачи по странице

На каждой странице контента есть контекстное меню (верхний правый угол, рядом с названием) со следующими быстрыми действиями:

* **Copy** — скопировать страницу как обычный Markdown.
* **View as Markdown** — открыть исходный `.md` в новой вкладке, чтобы вы могли его сохранить.
* **Open in ChatGPT / Claude / Perplexity** — предзагрузить содержимое страницы в приглашение чата для названного инструмента.
* **Open in Cursor / VS Code** — открыть буфер в названном редакторе с содержимым страницы.

Это правильная поверхность, когда вы хотите задать модели вопрос об одной странице без настройки MCP.

## Готовые файлы контекста для кодирующих агентов

Если вы интегрируетесь с Raydium и хотите, чтобы ваш агент с самого начала имел правильные базовые знания, поместите эти файлы в свой проект:

### `.cursorrules` / `.windsurfrules` / системное приглашение агента

```text theme={null}
You are integrating with Raydium, a Solana DeFi protocol with five product
surfaces: AMM v4, CPMM, CLMM, Farm, and LaunchLab. Authoritative docs live
at docs.raydium.io. The official SDK is `@raydium-io/raydium-sdk-v2` (pin
the version you've verified against). For server-built swaps, prefer the
Trade API at transaction-v1.raydium.io. Always:

- Pass a `Connection` and `cluster` that match.
- Keep all amounts as `BN` instances; never call `.toNumber()` on amounts.
- Pre-fund the user's wallet for ATA creation rent.
- Pass an explicit `computeBudgetConfig` for any tx that may compete in
  high-volume windows.
- Re-fetch `poolInfo` immediately before high-value transactions; cached
  state goes stale.

When uncertain about an instruction's accounts list, defer to
`docs.raydium.io/products/<product>/accounts` and the on-chain IDL.
```

Сохраните как `.cursorrules` (Cursor), `.windsurfrules` (Windsurf) или `CLAUDE.md` (Claude Code) — или вставьте в системное приглашение вашего агента. Точное имя файла и расположение варьируются в зависимости от версии инструмента, поэтому проверьте документацию параметров вашего инструмента, если он не подхватит файл автоматически.

### Список закреплённого контекста

Для кодирующих агентов, которые принимают список «всегда включаемых» страниц, этот список — минимальный полезный контекст для большинства интеграций Raydium:

```text theme={null}
https://docs.raydium.io/sdk-api/typescript-sdk
https://docs.raydium.io/sdk-api/trade-api
https://docs.raydium.io/products/cpmm/instructions
https://docs.raydium.io/products/clmm/instructions
https://docs.raydium.io/integration-guides/priority-fee-tuning
https://docs.raydium.io/reference/program-addresses
https://docs.raydium.io/reference/error-codes
```

Отрегулируйте на основе того, какие продукты вы интегрируете.

## Рецепт индексирования

Если вы строите собственное RAG и не хотите использовать `llms-full.txt`, вот канонический рецепт:

```ts theme={null}
import { fetch } from "undici";

const INDEX_URL = "https://docs.raydium.io/llms.txt";
const BASE      = "https://docs.raydium.io";

const index    = await (await fetch(INDEX_URL)).text();
const pageUrls = [...index.matchAll(/^- \[(.+?)\]\((.+?)\)/gm)].map(m => m[2]);

for (const path of pageUrls) {
  const md = await (await fetch(`${BASE}${path}.md`)).text();
  // ingest md into your vector store, keyed by path
}
```

Каждая страница предоставляется по её каноническому пути с добавленным суффиксом `.md` (например, `/sdk-api/typescript-sdk` → `/sdk-api/typescript-sdk.md`).

## Предостережения

* **Не вставляйте приватное состояние в приглашения.** MCP-сервер знает только то, что находится в публичной документации. Ключи кошельков, учётные данные RPC и подобные секреты никогда не должны попадать в контекст агента.
* **Вывод AI не является авторитетным.** Модели галлюцинируют адреса программ, названия инструкций и списки аккаунтов с тревожной лёгкостью. Всегда проверяйте против документации и IDL перед тем, как доверять сгенерированным агентом транзакциям.
* **Дрейф версий.** SDK v2 является пред-1.0; агенты, обученные на более старых релизах, могут выдавать код, который не компилируется против вашей закреплённой версии. Включите закреплённую версию SDK в системное приглашение вашего агента.

## Ссылки

* [`sdk-api/typescript-sdk`](/ru/sdk-api/typescript-sdk) — основной справочник SDK.
* [`sdk-api/trade-api`](/ru/sdk-api/trade-api) — сервер-построенные транзакции свопов, идеальны для интеграций, дружественных агентам.
* [`reference/program-addresses`](/ru/reference/program-addresses) — проверенные ID программ.
* [Model Context Protocol](https://modelcontextprotocol.io) — спецификация MCP.
* [`llms.txt` proposal](https://llmstxt.org) — информация о стандарте индекса.

Источники:

* [Mintlify MCP and llms.txt support](https://mintlify.com/docs/ai/llms).
* Развёртывание документации Raydium.