에이전트를 위한 Helius

Helius MCP Server: 도구

Model Context Protocol(MCP)은 AI 모델이 외부 데이터 소스, 도구, API에 안전하게 연결되도록 Anthropic이 도입한 오픈 소스 표준입니다. 개별 맞춤형 통합을 범용 표준 인터페이스로 대체합니다. 

Helius MCP Server는 모든 MCP 클라이언트에 Helius와 Solana를 제공합니다.

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
• Webhooks: 이벤트 기반 알림 생성, 업데이트, 삭제
• 지갑 및 기록: 잔액, 전송, 트랜잭션 파싱, 지갑 식별, 자금 분석
• Solana 지식: SIMD, Agave 및 Firedancer 소스 참조, Helius 블로그 콘텐츠, 공식 Solana 문서 검색

빠른 설치

Claude Code에 Helius MCP Server를 추가하려면 다음을 실행하세요.

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"]
    }
  }
}

그런 다음 setHeliusApiKey 도구나 환경 변수(예: HELIUS_API_KEY)를 사용해 API 키를 설정하고 배포를 시작하세요.

신규 사용자의 경우 에이전트가 계정을 자율적으로 생성할 수 있습니다. 키 쌍을 생성하고 이메일과 이름으로 signup를 호출합니다. 이후 결제 링크를 통해 원하는 플랜을 결제하거나 자동 결제를 위해 키 쌍에 자금을 예치하면 됩니다. 

Helius Skills: 두뇌

MCP는 에이전트에 60개 이상의 도구를 제공합니다. 하지만 접근 권한만으로는 부족합니다. 도구 목록만 가진 에이전트는 문서 탭만 열어 둔 채 경험은 전혀 없는 개발자와 같습니다. 도구를 호출할 수는 있지만, 어떤 도구를 선택해야 하는지, 주어진 작업에 맞게 어떻게 조합해야 하는지, 어떤 실수를 피해야 하는지 알지 못합니다. 

Skills는 두뇌입니다. 라우팅 로직, 참조 파일, 규칙을 포함해 세심하게 설계한 전문가용 지침 세트로, 에이전트가 전문 Solana 개발자처럼 작업하도록 가르칩니다.

스킬이 로드되면 에이전트는 NFT 조회에 getProgramAccounts보다 searchAssets가 더 적합하고, 우선순위 수수료는 getPriorityFeeEstimates를 통해 동적으로 가져와야 하며, 가장 높은 랜딩률을 위해 트랜잭션을 Sender로 전송해야 한다는 사실을 압니다. Skills는 에이전트에 도메인 전문성을 제공합니다.

오늘 네 가지 주요 Helius Skills를 출시합니다.

Build

Build 스킬은 핵심 Solana 개발을 위한 스킬입니다. DAS, Sender, WebSockets, LaserStream, Webhooks, Enhanced Transactions, 지갑 분석, 온보딩에 적합한 도구를 연결합니다. Helius를 사용해 Solana에서 무엇이든 구축할 때 사용하는 기본 스킬입니다. 

DFlow

DFlow 스킬은 트레이딩 앱 구축을 위한 스킬입니다. DFlow API(현물 스왑, 예측 시장, 실시간 스트리밍, Proof KYC)와 Helius 인프라를 결합해 트랜잭션 제출, 수수료 최적화, 온체인 모니터링을 지원합니다. 

Phantom

Phantom 스킬은 Phantom Connect SDK로 프런트엔드 앱을 구축하기 위한 스킬입니다. 지갑 연결, 토큰 게이팅, NFT 민팅, 암호화폐 결제, 포트폴리오 표시, 안전한 프런트엔드 아키텍처를 다룹니다.

SVM

SVM 스킬은 에이전트가 Solana 프로토콜 내부 구조를 이해하도록 지원합니다. Helius 블로그, SIMD, Agave/Firedancer 소스 코드에서 최신 콘텐츠를 가져와 sBPF 바이트코드의 실행 방식, Alpenglow 설계 고려 사항, 검증인 경제학 등을 탐색합니다. API 키는 필요하지 않습니다.

Skills 작동 방식

Skills는 모델에 구애받지 않습니다. 각 스킬은 Claude뿐 아니라 모든 플랫폼에서 사용할 수 있도록 사전 구축된 시스템 프롬프트 변형을 함께 제공합니다.

OpenAI API에는 openai.developer.md, Claude API에는 claude.system.md, Cursor Rules, ChatGPT 맞춤 지침 또는 기타 도구에는 full.md를 사용하세요. 플랫폼별 설정은 Skills 개요를 참고하세요.

Helius Claude Code Plugin을 사용하면 Skills가 자동으로 설치됩니다. 독립형 스킬은 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가 도구를 제공한다면 Skills는 두뇌 역할을 합니다. Helius Claude Code Plugin은 이 모든 것을 하나로 연결하는 단일 설치 번들입니다. 설치 즉시 작동합니다.

플러그인에는 Helius MCP, DFlow MCP, 네 가지 스킬, 모든 Helius 제품에 관한 상세 참조 파일이 포함됩니다.

MCP를 수동으로 설정하거나 스킬을 별도로 구성할 필요가 없습니다.

한 번만 설치하면 에이전트가 단일 세션에서 구조화된 블록체인 접근 기능과 전문적인 Solana 지식을 모두 활용할 수 있습니다.

빠른 설치

Claude Code 마켓플레이스에서 Helius Plugin을 설치하는 방법은 다음과 같습니다.

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

이것으로 끝입니다. 플러그인은 두 MCP Server를 자동으로 시작하며 현재 네 가지 슬래시 명령을 제공합니다.

API 키 설정은 독립형 MCP와 동일합니다. 기존 키를 사용하거나, 자율 가입을 활성화하거나, Helius CLI를 사용하세요. 

실제 사용 모습

플러그인을 설치하면 프롬프트 하나만으로 작동하는 애플리케이션을 만들 수 있습니다. 예를 들면 다음과 같습니다.

“Toly의 지갑 주소 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY를 사용해 온체인 활동을 가져올 수 있는 세금 신고 CLI를 만들어 줘. 지난달인 2월부터 시작하고, 과세 대상 이벤트를 모두 정리한 CSV 파일을 출력해 줘. 어떤 지갑과 기간에도 작동하도록 만들어 줘.”

Claude가 한 번에 완성합니다.   

/helius:build 스킬이 작동해 Toly의 최근 활동을 기반으로 완전히 파싱된 트랜잭션 기록을 반환하도록 페이지네이션과 타임스탬프 필터링을 적용한 getTransactionsByAddress를 정확히 제안합니다.

도구를 수동으로 선택하거나 중간 프롬프트를 입력할 필요가 없습니다. 에이전트가 올바른 참조 파일을 읽고 적절한 MCP 도구를 호출해 모든 지갑과 날짜 범위를 지원하는 CLI를 생성합니다.

물론 에이전트는 트레이딩 봇처럼 더 복잡한 앱도 구축할 수 있습니다.

이 예시에서는 Helius Claude Code Plugin을 설치하고 Claude에 PumpFun 토큰을 실시간으로 추적하며 LaserStream을 통해 토큰 생성과 거래를 스트리밍하는 트레이딩 봇을 만들어 달라고 요청했습니다.

모의 거래를 할 수 있도록 시장 데이터를 표시하고 기본 차트 기능을 제공해 달라고도 요청했습니다. 이것이 전부입니다. Claude는 실시간 토큰 스트리밍과 거래 기능을 갖춘 이 트레이딩 봇을 10분도 안 되어 완성했습니다.

이것이 에이전트에 단순히 도구를 제공하는 것과 전문성을 제공하는 것의 차이입니다.

Helius CLI

Helius CLI는 계정 관리, Solana 조회, 트랜잭션 전송, webhook 관리, 실시간 스트리밍, 스테이킹, ZK Compression 등을 포괄하는 95개 이상의 CLI 명령을 갖춘 완전한 기능의 명령줄 인터페이스입니다.

AI 기반 워크플로에는 MCP를 권장합니다. 구조화된 도구 호출이 셸 인스턴스를 생성하고 출력을 파싱하는 방식보다 효율적이기 때문입니다. 하지만 셸 스크립트, CI/CD 파이프라인 구축 또는 MCP를 사용할 수 없는 환경에서는 CLI가 적합합니다. 모든 명령은 머신이 읽을 수 있는 출력을 위한 --json 옵션을 지원하고 구조화된 종료 코드를 반환하므로, 자동화 시스템이 프로그래밍 방식으로 오류를 처리할 수 있습니다.

빠른 설치

신규 사용자의 시작 절차는 간단합니다.

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

# Signup requires a valid email and name
helius signup --email you@example.com --first-name Jane --last-name Doe
# Pay via the printed link with any wallet, then:
helius signup --resume           # Finalize and 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는 먼저 서명을 가져온 뒤 트랜잭션을 가져오는 오래된 표준 2단계 패턴을 대체합니다. 서버 측 필터링, 시간 범위, 토큰 계정 지원을 한 번의 호출로 처리합니다. 

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는 이를 한 단계 더 발전시켜 초저지연 트랜잭션 제출에 최적화했습니다.

배칭, 페이지네이션, webhook 및 WebSockets를 통한 실시간 데이터, 증분 계정 가져오기, 오류 처리, 에이전트가 피해야 할 일반적인 문제는 TypeScript 모범 사례를 참고하세요. 

Rust SDK

Helius Rust SDK는 동일한 Helius 메서드에 대한 비동기 Rust 바인딩을 제공하므로 고성능 에이전트 워크플로에 적합합니다.

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 클라이언트: Claude Desktop, Cursor, VS Code, Codex 또는 Windsurf에 Helius MCP Server를 추가하세요.
• 셸 자동화: 스크립트와 CI/CD를 위해 Helius CLI를 설치하세요.
• API 통합: OpenAI API, Claude API 또는 ChatGPT에 스킬 시스템 프롬프트를 추가하세요.

문서를 읽고, GitHub 저장소를 살펴보고, 스킬 통합을 제안해 보세요. 궁금한 점이 있다면 지원팀에 문의하세요.