에이전트를 위한 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(샤드 수준 지연 시간)
• 트랜잭션 전송: 우선순위 수수료 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 키를 설정하고 배포를 시작하세요.

신규 사용자의 경우 에이전트가 자율적으로 계정을 생성할 수 있습니다. 키 쌍을 생성하고 자금을 입금한 다음 agenticSignup을 호출하면 $1부터 원하는 요금제를 구매할 수 있습니다. 

Helius Skills: 두뇌

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

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

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

오늘 네 가지 주요 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 키가 필요하지 않습니다.

스킬 작동 방식

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

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

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 전문 지식을 갖게 됩니다.

빠른 설치

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를 권장합니다. 셸 인스턴스를 생성하고 출력을 파싱하는 것보다 구조화된 도구 호출이 더 효율적입니다. 반면 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은 먼저 서명을 가져온 뒤 트랜잭션을 가져오는 오래된 표준 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 저장소를 살펴보세요. 스킬 통합을 제안하거나 궁금한 점이 있으면 지원팀에 문의하세요.