Helius для агентов

Helius MCP Server: инструменты

Model Context Protocol (MCP) — это открытый стандарт от Anthropic, который позволяет AI-моделям безопасно подключаться к внешним источникам данных, инструментам и API. Он заменяет специализированные интеграции универсальным стандартизированным интерфейсом. 

Helius MCP Server открывает доступ к Helius и Solana для любого клиента MCP.

Без MCP агенту, который хочет проверить баланс кошелька, приходится открывать оболочку, составлять команду curl, отправлять ее, разбирать вывод JSON и надеяться, что эндпоинт и параметры указаны правильно.

Повторите это для каждого вызова API в рабочем процессе — и получите медленное, ненадежное и подверженное ошибкам взаимодействие, которое тормозит из-за необходимости запускать отдельный экземпляр оболочки для каждой команды.

С MCP ничего этого не происходит.

Агент вызывает getBalance как структурированный инструмент и получает типизированный ответ. Без оболочки. Без curl. Без разбора вывода — все просто работает.

То же относится к parseTransaction, getAssetsByOwner, createWebhook и всем остальным 60+ инструментам. Теперь агенты могут напрямую обращаться к Helius с правильными параметрами и получать структурированные данные. 

Helius MCP Server предоставляет инструменты для следующих задач:

• Автономная регистрация: создание аккаунтов, получение ключей API, переход на другой план и многое другое
• Актуальные данные блокчейна: RPC, DAS API, ZK Compression и другие возможности
• Потоковая передача данных:  WebSockets (стандартные и расширенные), LaserStream gRPC (задержка на уровне шредов)
• Отправка транзакций: Priority Fee API, переводы SPL и Sender
• Вебхуки: создание, обновление и удаление уведомлений на основе событий
• Кошельки и история: балансы, переводы, разбор транзакций, идентификация кошельков и анализ источников средств
• Знания о Solana: SIMD, ссылки на исходный код Agave и Firedancer, материалы блога Helius и поиск по официальной документации Solana

Быстрая установка

Чтобы добавить Helius MCP Server в Claude Code, выполните:

claude mcp add helius npx helius-mcp@latest

Для Codex выполните:

codex mcp add helius -- npx helius-mcp@latest

Для Cursor, VS Code или аналогичных инструментов добавьте в конфигурацию MCP:

{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Затем задайте ключ API с помощью инструмента setHeliusApiKey или переменной окружения (например, HELIUS_API_KEY) и приступайте к запуску проектов.

Если вы новый пользователь, агент может автономно создать для вас аккаунт: он сгенерирует пару ключей, вы пополните ее баланс, а затем вызовете agenticSignup, чтобы приобрести нужный план стоимостью от $1. 

Helius Skills: мозг

MCP предоставляет агентам доступ к более чем 60 инструментам. Но одного доступа недостаточно: агент с каталогом инструментов подобен разработчику с открытыми вкладками документации, но без опыта. Он может вызывать инструменты, но не знает, какой выбрать, как объединить их для конкретной задачи и каких ошибок избегать. 

Навыки — это мозг. Это экспертные наборы инструкций: тщательно составленные промпты с логикой маршрутизации, справочными файлами и правилами, которые учат агента работать как опытный разработчик Solana.

После загрузки навыка агент знает, что searchAssets лучше getProgramAccounts для поиска NFT, что приоритетные комиссии нужно получать динамически через getPriorityFeeEstimates, а транзакции следует отправлять через Sender для максимальной вероятности включения. Навыки дают агенту предметную экспертизу.

Сегодня мы запускаем четыре основных навыка Helius:

Build

Навык Build предназначен для основной разработки на Solana. Он направляет запросы к нужным инструментам для DAS, Sender, WebSockets, LaserStream, вебхуков, Enhanced Transactions, анализа кошельков и онбординга. Это навык по умолчанию для создания любых решений на Solana с помощью Helius. 

DFlow

Навык DFlow предназначен для создания торговых приложений. Он сочетает API DFlow — спотовые свопы, рынки прогнозов, потоковую передачу данных в реальном времени и Proof KYC — с инфраструктурой Helius для отправки транзакций, оптимизации комиссий и ончейн-мониторинга. 

Phantom

Навык Phantom предназначен для создания фронтенд-приложений с Phantom Connect SDK. Он охватывает подключение кошельков, ограничение доступа по токенам, выпуск NFT, криптоплатежи, отображение портфелей и безопасную архитектуру фронтенда.

SVM

Навык SVM помогает агентам разобраться во внутреннем устройстве протокола Solana. Узнавайте, как исполняется байт-код sBPF, какие факторы учитываются при проектировании Alpenglow, как устроена экономика валидаторов и многое другое, получая актуальные материалы из блога Helius, SIMD и исходного кода Agave/Firedancer. Ключ API не требуется.

Как работают навыки

Навыки не зависят от модели. Каждый из них поставляется с готовыми вариантами системных промптов для работы на всех платформах, а не только в Claude.

Используйте openai.developer.md для OpenAI API, claude.system.md для Claude API или full.md для Cursor Rules, пользовательских инструкций ChatGPT и любых других инструментов. Инструкции по настройке для разных платформ доступны в обзоре навыков.

Навыки устанавливаются автоматически при использовании Helius Claude Code Plugin. Отдельные навыки можно установить как Agent Skills: они вызываются автоматически, без слеш-команд.

# Clone our AI tooling repo
git clone https://github.com/helius-labs/core-ai.git

# Navigate to helius-skills
cd core-ai/helius-skills

# Install your desired skill
./helius/install.sh            # Build skill → ~/.claude/skills/helius/
./helius-dflow/install.sh      # DFlow skill → ~/.claude/skills/helius-dflow/
./svm/install.sh               # SVM skill   → ~/.claude/skills/svm/

С этими навыками агенты могут создавать практически любые приложения Solana — от торговых фронтендов и приложений для рынков прогнозов до обработчиков платежей в стейблкоинах — сразу применяя правильные подходы.

Helius Claude Code Plugin: полный комплект

MCP предоставляет инструменты, а навыки служат мозгом. Helius Claude Code Plugin объединяет их в одном пакете, который подключает все необходимое за одну установку. Все просто работает.

Плагин включает Helius MCP, DFlow MCP, все четыре навыка и подробные справочные файлы по каждому продукту Helius.

Никакой ручной настройки MCP. Никакой отдельной установки навыков.

Одна установка — и агент получает структурированный доступ к блокчейну и экспертные знания о Solana в рамках одного сеанса.

Быстрая установка

Вот как установить Helius Plugin из каталога Claude Code:

/plugin marketplace add helius-labs/core-ai
/plugin install helius@helius-labs

Готово. Плагин автоматически запускает оба сервера MCP и сейчас предоставляет четыре слеш-команды:

Ключ API настраивается так же, как и для отдельного MCP: используйте существующий ключ, включите автономную регистрацию или воспользуйтесь Helius CLI. 

Как это выглядит на практике

После установки плагина одного промпта достаточно, чтобы получить работающее приложение. Например:

«Создай для меня CLI для налоговой отчетности, чтобы я мог получить ончейн-активность Toly по адресу его кошелька 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY. Начни с прошлого месяца (февраля) и создай CSV-файл со всеми его налогооблагаемыми событиями. Сделай так, чтобы решение работало с любым кошельком и периодом времени».

Claude создает все за один запрос:   

Навык /helius:build подключается и правильно предлагает getTransactionsByAddress с пагинацией и фильтрацией по временным меткам, чтобы вернуть полностью разобранную историю транзакций на основе недавней активности Toly.

Не нужно вручную выбирать инструменты или отправлять промежуточные промпты. Агент читает нужные справочные файлы, вызывает правильные инструменты MCP и создает работающий CLI с поддержкой любого кошелька и диапазона дат.

Разумеется, агенты могут создавать и более сложные приложения, например торговых ботов:

В этом примере мы установили Helius Claude Code Plugin и попросили Claude создать торгового бота, который отслеживает токены PumpFun в реальном времени и передает данные о создании токенов и сделках через LaserStream.

Мы также попросили его отображать рыночные данные и строить базовые графики для виртуальной торговли. И это все. Claude создал этого торгового бота с потоковой передачей данных о токенах и торгах в реальном времени менее чем за 10 минут.

Вот чем отличаются инструменты для агента от полноценной экспертизы.

Helius CLI

Helius CLI — это полнофункциональный интерфейс командной строки с более чем 95 командами CLI. Они охватывают управление аккаунтами, запросы к Solana, отправку транзакций, управление вебхуками, потоковую передачу данных в реальном времени, стейкинг, ZK Compression и многое другое.

Для рабочих процессов с AI мы рекомендуем MCP: структурированные вызовы инструментов эффективнее запуска экземпляров оболочки и разбора вывода. Однако CLI лучше подходит для скриптов оболочки, создания конвейеров CI/CD и работы в средах, где MCP недоступен. Каждая команда поддерживает параметр --json для машиночитаемого вывода и возвращает структурированные коды завершения, поэтому автоматизированные процессы могут программно обрабатывать ошибки.

Быстрая установка

Для новых пользователей процесс прост:

# Install the CLI
npm install -g helius-cli
helius keygen                    # Generate keypair

# Fund wallet with ~0.001 SOL + 1 USDC
helius signup --json             # Create account, get API key
helius projects                  # List projects
helius apikeys <project-id>      # Get API keys

Существующим пользователям достаточно выполнить:

helius config set-api-key YOUR_API_KEY

SDK, оптимизированные для агентов

Для агентов, программно создающих приложения, мы опубликовали оптимизированную документацию по нашим TypeScript SDK и Rust SDK.

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

TypeScript SDK

Helius TypeScript SDK предоставляет типобезопасные методы для каждого вызова Helius API. Главное преимущество для агентов в том, что специализированные методы Helius сводят многоэтапные рабочие процессы Solana к одному вызову. 

Например, getTransactionsForAddress заменяет устаревшую стандартную двухэтапную схему, при которой сначала получают подписи, а затем транзакции. Все выполняется одним вызовом с серверной фильтрацией, диапазонами времени и поддержкой токен-аккаунтов: 

import { createHelius } from "helius-sdk";

const helius = createHelius({ apiKey: "YOUR_API_KEY" });

// Single call: full transaction history with token activity
const txs = await helius.getTransactionsForAddress([
  "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
  {
    transactionDetails: "full",
    limit: 100,
    filters: { tokenAccounts: "balanceChanged" },
  },
]);

Аналогично, sendSmartTransaction автоматически выполняет симуляцию, оценку вычислительных единиц, расчет приоритетных комиссий и подтверждение.

sendTransactionWithSender выводит это на новый уровень благодаря оптимизации для отправки транзакций с минимальной задержкой.

В рекомендациях по TypeScript описаны пакетная обработка, пагинация, получение данных в реальном времени через вебхуки и WebSockets, инкрементальная загрузка аккаунтов, обработка ошибок и распространенные проблемы, которых агентам следует избегать. 

Rust SDK

Helius Rust SDK предоставляет асинхронные привязки Rust с теми же методами Helius. Это оптимальный вариант для высокопроизводительных агентных рабочих процессов:

use helius::Helius;
use helius::types::*;

let helius = Helius::new("YOUR_API_KEY", Cluster::MainnetBeta)?;

// Same single-call pattern as TypeScript
let txs = helius.rpc().get_transactions_for_address(
    "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY".to_string(),
    GetTransactionsForAddressOptions {
        transaction_details: Some(TransactionDetails::Full),
        limit: Some(100),
        filters: Some(GetTransactionsFilters {
            token_accounts: Some(TokenAccountsFilter::BalanceChanged),
            ..Default::default()
        }),
        ..Default::default()
    },
).await?;

Rust SDK также предоставляет типизированные варианты ошибок (например, HeliusError::RateLimitExceeded), поэтому агенты могут напрямую сопоставлять ошибки вместо разбора строк.

В рекомендациях по Rust описаны те же подходы для Rust: пакетная обработка, пагинация, Sender, стратегии повторных попыток и распространенные проблемы. 

Начало работы

Helius предоставляет агентам самый полный набор инструментов для создания готовых к продакшену приложений на Solana. Вот как начать работу:

• Самый быстрый способ: установите Claude Code Plugin 
• Любой клиент MCP: добавьте Helius MCP Server в Claude Desktop, Cursor, VS Code, Codex или Windsurf
• Автоматизация в оболочке: установите Helius CLI для скриптов и CI/CD
• Интеграция API: добавьте системный промпт навыка в OpenAI API, Claude API или ChatGPT

Прочитайте нашу документацию, изучите репозиторий GitHub, предложите интеграцию навыка и обратитесь в нашу службу поддержки, если у вас возникнут вопросы.