> ## 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>
  **このページは AI による自動翻訳です。すべての内容は英語版を正とします。**

  [英語版を表示 →](/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`                                | オフラインインデックス作成用に、完全なコーパスを単一の連結ファイルとして取得したい場合。                                  |
| **ページごとのコピーメニュー**       | すべてのボディページの上部にある「ページをコピー」ボタン                                           | 1 つのページを LLM との会話に貼り付けたい場合。                                                   |
| **ページごとのディープリンク**       | 「Markdown として表示」、「ChatGPT で開く」、「Claude で開く」、「Cursor で開く」、「VS Code で開く」 | ドキュメントページから選択したツールへのワンクリックハンドオフが必要な場合。                                        |

「ページをコピー」ボタンとディープリンクメニューは、すべてのページの右上（ページタイトルの隣）に配置されています。両方ともドキュメントプラットフォームのコンテキストメニューによって実現されています。

## MCP サーバー

MCP（Model Context Protocol）サーバーは、AI クライアントが Raydium ドキュメントをツールとしてクエリできるようにします。設定後、エージェントは「Raydium ドキュメントで `addLiquidity` パラメータを検索」と要求でき、引用された権限ある回答を取得できます。

### Claude Code

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

追加後、Claude Code に「Raydium ドキュメントで 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` で利用できます。

### サーバーが公開するもの

Raydium ドキュメント MCP サーバーは、1 つのプライマリーツール `search_docs(query: string)` を公開します。これはクエリの最上位のパッセージを正規 URL とともに返します。エージェントは使用した URL を引用する責任がある。トラッキングやエージェントごとのレート制限は行いません。

## RAG 用の `llms.txt`

`llms.txt` は、「機械可読ドキュメントインデックス」の新興標準です。Raydium は以下を公開しています：

* `https://docs.raydium.io/llms.txt` — すべてのページのフラットリスト（タイトルと 1 行の要約付き）、チャプター別に整理。
* `https://docs.raydium.io/llms-full.txt` — すべてのページの完全な Markdown ボディを連結したもので、ページ境界は見出しとして保存。

`full` バリアントはドキュメント構築のたびに再生成されます。スケジュール（毎日で十分）に従って pull するか、オンデマンドで fetch してください。

```bash theme={null}
# 完全なコーパスを RAG インジェスチョンパイプラインにドロップします。
curl -sSL https://docs.raydium.io/llms-full.txt -o raydium-docs.md
```

## ページごとのハンドオフメニュー

すべてのボディページには、タイトルの隣の右上にコンテキストメニューがあり、これらのワンクリックアクション を提供します：

* **コピー** — ページをプレーン Markdown としてコピー。
* **Markdown として表示** — ソース `.md` を新しいタブで開き、保存できるようにします。
* **ChatGPT / Claude / Perplexity で開く** — 指定されたツールのチャットプロンプトにページコンテンツを事前に読み込みます。
* **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`](/ja/sdk-api/typescript-sdk) — プライマリー SDK リファレンス。
* [`sdk-api/trade-api`](/ja/sdk-api/trade-api) — サーバー構築スワップトランザクション、エージェント向け統合に最適です。
* [`reference/program-addresses`](/ja/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 ドキュメント構築。