> ## Documentation Index > Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Сервер Helius MCP > Сервер MCP для Helius — 9 маршрутизируемых инструментов и expandResult предоставляют ИИ-ассистентам возможности отправки запросов к Solana, отправки транзакций, работы с вебхуками и потоковой передачей данных, а также анализа кошельков. [Сервер Helius MCP](https://www.npmjs.com/package/helius-mcp) предоставляет инструментам ИИ прямой доступ к API Helius через **10 общедоступных инструментов**: 9 маршрутизируемых инструментов, сгруппированных по предметным областям и охватывающих все функции Helius и Solana, а также `expandResult` для постраничного просмотра больших ответов. Инструменты, сгруппированные по предметным областям (`heliusWallet`, `heliusAsset`, `heliusTransaction`, …): каждое действие Helius доступно через один из них Создайте учетную запись Helius из своего инструмента ИИ: оплатите через размещенную платежную ссылку или настройте автоматическую оплату в USDC с помощью локальной пары ключей Подключайтесь к Enhanced WebSockets и LaserStream gRPC непосредственно из своего инструмента ИИ Работает с Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex и любым инструментом, совместимым с MCP ## Что такое MCP? [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) — это представленный Anthropic стандарт с открытым исходным кодом, который позволяет моделям ИИ безопасно подключаться к внешним источникам данных, инструментам и API. Он использует клиент-серверную архитектуру, в которой хост (например, Claude) подключается к серверу MCP, позволяя ИИ выполнять запросы к базам данных, вызывать API или выполнять действия через универсальный стандартизированный интерфейс. **Почему это важно для Helius:** MCP предоставляет Claude прямой доступ к актуальным данным Solana и инфраструктуре Helius: балансам, метаданным активов, разобранным транзакциям, управлению вебхуками, потоковой передаче данных и многому другому. Без него Claude приходится угадывать содержимое ответов API или многократно выполнять запросы curl для получения контекста. MCP позволяет Claude фактически взаимодействовать с Solana через Helius с помощью структурированных вызовов инструментов. Сайт документации Helius по адресу [helius.dev/docs](https://www.helius.dev/docs) также предоставляет отдельный сервер MCP, автоматически созданный Mintlify. Этот сервер предназначен только для поиска по документации. Описанный здесь `helius-mcp` — это комплексный сервер, охватывающий все функции Helius и Solana. ## Быстрый старт ```bash theme={"system"} claude mcp add helius npx helius-mcp@latest ``` Или добавьте сервер в конфигурацию хоста MCP (Claude Desktop, Cursor, Windsurf, VS Code и т. д.): ```json theme={"system"} { "mcpServers": { "helius": { "command": "npx", "args": ["helius-mcp@latest"] } } } ``` **Если у вас уже есть ключ:** ```bash theme={"system"} export HELIUS_API_KEY=YOUR_API_KEY ``` Или задайте его в Claude, вызвав действие `setHeliusApiKey` инструмента `heliusAccount`. Ключи API определяются в следующем порядке: 1. Вызов действия `setHeliusApiKey` в рамках сеанса 2. Переменная среды `HELIUS_API_KEY` 3. `~/.helius/config.json` (задается через [Helius CLI](/docs/ru/agents/cli)) **Если вам нужна новая учетная запись:** см. раздел [Регистрация](#регистрация) ниже. Задавайте вопросы на естественном языке — нужные инструмент и действие выбираются автоматически: * «Какие NFT принадлежат этому кошельку?» * «Разбери эту транзакцию: `5abc...`» * «Получи баланс `Gh9ZwEm...`» * «Отправь 1 SOL на `7xKp...`» * «Создай вебхук для этого адреса» ## Подключение к серверу Helius MCP Выполните следующую команду: ```bash theme={"system"} claude mcp add helius npx helius-mcp@latest ``` Или добавьте в файл `.mcp.json` своего проекта: ```json theme={"system"} { "mcpServers": { "helius": { "command": "npx", "args": ["helius-mcp@latest"] } } } ``` Проверьте с помощью: ```bash theme={"system"} claude mcp list ``` Хотите установить навыки и MCP за один шаг? Вместо этого установите [плагин Helius](/docs/ru/agents/claude-code-plugin). Выполните эти команды по отдельности: ``` /plugin marketplace add helius-labs/core-ai ``` ``` /plugin install helius@helius-labs ``` Откройте **Settings > Developer > Edit Config** и добавьте сервер: ```json theme={"system"} { "mcpServers": { "helius": { "command": "npx", "args": ["helius-mcp@latest"] } } } ``` Перезапустите Claude Desktop, чтобы применить изменения. Откройте палитру команд (`Cmd/Ctrl + Shift + P`), найдите **MCP: Add Server** и укажите: * **Имя:** `helius` * **Команда:** `npx helius-mcp@latest` Или добавьте в файл `.cursor/mcp.json` своего проекта: ```json theme={"system"} { "mcpServers": { "helius": { "command": "npx", "args": ["helius-mcp@latest"] } } } ``` Создайте файл `.vscode/mcp.json` в корневом каталоге проекта: ```json theme={"system"} { "servers": { "helius": { "command": "npx", "args": ["helius-mcp@latest"] } } } ``` Требуется расширение [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) с включенной поддержкой MCP. Откройте палитру команд (`Cmd/Ctrl + Shift + P`), найдите **Configure MCP Servers** и добавьте: ```json theme={"system"} { "mcpServers": { "helius": { "command": "npx", "args": ["helius-mcp@latest"] } } } ``` Выполните следующую команду: ```bash theme={"system"} codex mcp add helius -- npx helius-mcp@latest ``` Или добавьте в `~/.codex/config.toml` (либо в `.codex/config.toml` для области проекта): ```toml theme={"system"} [mcp_servers.helius] command = "npx" args = ["helius-mcp@latest"] ``` Проверьте с помощью: ```bash theme={"system"} codex mcp list ``` ## Общедоступные инструменты Helius MCP предоставляет **10 общедоступных инструментов**: 9 маршрутизируемых инструментов, сгруппированных по предметным областям, и `expandResult`. Каждое действие Helius и Solana доступно в виде аргумента `action` соответствующего маршрутизируемого инструмента. | Инструмент | Область применения | | - | - | | `heliusAccount` | Настройка учетной записи, аутентификация, тарифы, выставление счетов | | `heliusWallet` | Балансы кошельков, активы, история, идентификация | | `heliusAsset` | Активы, NFT, коллекции, держатели токенов | | `heliusTransaction` | Разбор транзакций и история транзакций кошелька | | `heliusChain` | Состояние блокчейна, счета токенов, блоки, состояние сети, счета программ | | `heliusStreaming` | CRUD-операции с вебхуками и конфигурация подписок (WebSockets, LaserStream) | | `heliusKnowledge` | Документация, руководства, цены, устранение неполадок, исходный код, блог, SIMD | | `heliusWrite` | Переводы токенов SOL и SPL | | `heliusCompression` | Доказательства Меркла для сжатых NFT | | `expandResult` | Развертывание результатов, сначала представленных в виде сводки, по `resultId` | Все действия, сгруппированные по маршрутизируемым инструментам, с подробным описанием формата вызовов и использования `expandResult` ### Формат вызова маршрутизируемого инструмента Все 9 маршрутизируемых инструментов имеют общий формат: * `action` — имя запускаемого действия Helius, например `getBalance` или `createWebhook` * параметры предметной области — например, `address`, `signatures` или `webhookURL` * необязательный `detail` — `summary`, `standard` или `full` * поля телеметрии — `_feedback`, `_feedbackTool`, `_model` Пример вызова: ```json theme={"system"} { "name": "heliusWallet", "arguments": { "action": "getBalance", "address": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr", "_feedback": "initial balance check", "_feedbackTool": "heliusWallet.getBalance", "_model": "your-model-id" } } ``` ### Ответы со сводкой в начале и `expandResult` Объемные ответы **сначала содержат сводку**. Маршрутизируемые инструменты возвращают компактную сводку и `resultId`, если полный ответ слишком велик или если запрошен `detail: "summary"`. Используйте `expandResult` с этим `resultId`, чтобы по запросу получить определенный раздел, диапазон, страницу или следующий фрагмент. Это сокращает расход токенов при исследовательских запросах, при этом позволяя агентам при необходимости изучать полную полезную нагрузку. ## Регистрация Создайте учетную запись Helius из своего инструмента ИИ через размещенную платежную ссылку или оплатите USDC непосредственно с помощью локальной пары ключей. Процесс регистрации выполняется через маршрутизируемый инструмент `heliusAccount`: ИИ вызывает `heliusAccount` с `action: "generateKeypair"` — создается кошелек Solana и возвращается его адрес. ИИ вызывает `heliusAccount` с `action: "signup"` и `mode: "link"` — возвращается `paymentUrl` (например, `https://dashboard.helius.dev/pay/`), который пользователь открывает для оплаты с любого кошелька. Или передайте `mode: "autopay"`, чтобы автоматически отправить USDC из локальной пары ключей (на кошельке должно быть около 0,001 SOL и сумма тарифа в USDC). После оплаты по ссылке ИИ вызывает `heliusAccount` с `action: "signup"` и `mode: "resume"` — проверяется статус платежного намерения, завершается подготовка учетной записи и автоматически настраивается ключ API. **Контактные данные:** для каждой новой регистрации, включая тариф Agent, требуются `email`, `firstName` и `lastName`. Кошелек используется только для оплаты. Для `upgradePlan` требуются те же данные. То же самое можно сделать из терминала с помощью [Helius CLI](/docs/ru/agents/cli): ```bash theme={"system"} npx helius-cli@latest keygen npx helius-cli@latest signup --plan agent --email you@example.com --first-name Jane --last-name Doe # Print hosted payment link # (pay in browser, then:) npx helius-cli@latest signup --resume # Finalize account # Or autopay from the local keypair: npx helius-cli@latest signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe ``` ## Конфигурация сети По умолчанию сервер MCP использует **mainnet-beta**. Переключитесь на devnet с помощью переменной среды: ```bash theme={"system"} export HELIUS_NETWORK=devnet ``` Или вызовите действие `setNetwork` инструмента `heliusAccount` в рамках сеанса. ## Системные промпты Пакет `helius-mcp` поставляется с готовыми системными промптами, которые обучают модели ИИ эффективно использовать инструменты Helius. Они находятся в `system-prompts/`: ``` system-prompts/ ├── helius/ # Core Helius skill ├── helius-phantom/ # Phantom frontend skill ├── helius-jupiter/ # Jupiter DeFi skill ├── helius-dflow/ # DFlow trading skill ├── helius-okx/ # OKX trading & intelligence skill └── svm/ # SVM architecture skill ``` Каждый из них содержит три варианта: * `openai.developer.md` — для API OpenAI Responses/Chat Completions (сообщение `developer`) * `claude.system.md` — для API Claude (системный промпт) * `full.md` — автономный вариант со всеми встроенными ссылочными материалами (Cursor Rules, ChatGPT и т. д.) Примеры кода см. в руководстве по интеграции [`helius-skills/SYSTEM-PROMPTS.md`](https://github.com/helius-labs/core-ai/blob/main/helius-skills/SYSTEM-PROMPTS.md). ## Навыки Навыки — это наборы экспертных инструкций, которые обучают Claude направлять ваши запросы к нужным действиям MCP и справочным файлам. Они не ограничиваются доступом к инструментам: в них входят логика маршрутизации, правильные шаблоны SDK и правила, предотвращающие распространенные ошибки. Доступно шесть навыков: Build (общая разработка для Solana), Phantom (интерфейсные dApp), Jupiter (DeFi), DFlow (торговые приложения), OKX (торговля и аналитика) и SVM (внутреннее устройство протокола) ## Дополнительные сведения Установка MCP и навыков одним действием Управление учетной записью из командной строки Узнайте больше о стандарте Model Context Protocol Сведения о пакете и история версий История версий и примечания к выпускам Руководство по внесению изменений в `helius-mcp` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.