> ## 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. # Máy chủ Helius MCP > Máy chủ MCP cho Helius — 9 công cụ định tuyến cùng expandResult giúp các trợ lý AI truy vấn Solana, gửi giao dịch, quản lý webhook, truyền phát và phân tích ví. [Máy chủ Helius MCP](https://www.npmjs.com/package/helius-mcp) cung cấp cho các công cụ AI quyền truy cập trực tiếp vào API Helius thông qua **10 công cụ công khai** — 9 công cụ miền được định tuyến bao quát toàn bộ chức năng của Helius và Solana, cùng `expandResult` để phân trang qua các phản hồi lớn. Các công cụ được nhóm theo miền (`heliusWallet`, `heliusAsset`, `heliusTransaction`, …) — mọi thao tác Helius đều có thể được truy cập thông qua một trong các công cụ này Tạo tài khoản Helius từ công cụ AI — thanh toán qua liên kết được lưu trữ hoặc tự động thanh toán bằng USDC từ một cặp khóa cục bộ Đăng ký Enhanced WebSockets và LaserStream gRPC trực tiếp từ công cụ AI Hoạt động với Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex và mọi công cụ tương thích với MCP ## MCP là gì? [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) là một tiêu chuẩn nguồn mở do Anthropic giới thiệu, cho phép các mô hình AI kết nối an toàn với các nguồn dữ liệu, công cụ và API bên ngoài. Giao thức này sử dụng kiến trúc máy khách-máy chủ, trong đó một máy chủ lưu trữ (như Claude) kết nối với máy chủ MCP, cho phép AI truy vấn cơ sở dữ liệu, gọi API hoặc thực thi hành động thông qua một giao diện phổ quát, được chuẩn hóa. **Tại sao điều này quan trọng đối với Helius:** MCP cung cấp cho Claude quyền truy cập trực tiếp vào dữ liệu Solana trực tiếp và cơ sở hạ tầng Helius — số dư, siêu dữ liệu tài sản, giao dịch đã phân tích, quản lý webhook, truyền phát và nhiều chức năng khác. Nếu không có MCP, Claude phải đoán phản hồi API hoặc thực hiện nhiều yêu cầu curl để thu thập ngữ cảnh. MCP cho phép Claude thực sự tương tác với Solana thông qua Helius bằng các lệnh gọi công cụ có cấu trúc. Trang tài liệu Helius tại [helius.dev/docs](https://www.helius.dev/docs) cũng cung cấp một máy chủ MCP riêng do Mintlify tự động tạo. Máy chủ đó chỉ dành cho việc tìm kiếm tài liệu. `helius-mcp` được trình bày tại đây là máy chủ toàn diện, bao quát toàn bộ chức năng của Helius và Solana. ## Bắt đầu nhanh ```bash theme={"system"} claude mcp add helius npx helius-mcp@latest ``` Hoặc thêm vào cấu hình máy chủ MCP của bạn (Claude Desktop, Cursor, Windsurf, VS Code, v.v.): ```json theme={"system"} { "mcpServers": { "helius": { "command": "npx", "args": ["helius-mcp@latest"] } } } ``` **Nếu bạn đã có khóa:** ```bash theme={"system"} export HELIUS_API_KEY=YOUR_API_KEY ``` Hoặc thiết lập khóa bên trong Claude bằng cách gọi thao tác `setHeliusApiKey` trên `heliusAccount`. Khóa API được phân giải theo thứ tự sau: 1. Lệnh gọi thao tác `setHeliusApiKey` trong phiên 2. Biến môi trường `HELIUS_API_KEY` 3. `~/.helius/config.json` (được thiết lập qua [Helius CLI](/docs/vi/agents/cli)) **Nếu bạn cần tài khoản mới:** Xem phần [Đăng ký](#đăng-ký) bên dưới. Đặt câu hỏi bằng tiếng Anh thông thường — công cụ và thao tác phù hợp sẽ được chọn tự động: * "Ví này sở hữu những NFT nào?" * "Phân tích giao dịch này: `5abc...`" * "Lấy số dư của `Gh9ZwEm...`" * "Gửi 1 SOL đến `7xKp...`" * "Tạo webhook cho địa chỉ này" ## Kết nối với máy chủ Helius MCP Chạy lệnh sau: ```bash theme={"system"} claude mcp add helius npx helius-mcp@latest ``` Hoặc thêm vào `.mcp.json` của dự án: ```json theme={"system"} { "mcpServers": { "helius": { "command": "npx", "args": ["helius-mcp@latest"] } } } ``` Xác minh bằng: ```bash theme={"system"} claude mcp list ``` Muốn cài đặt kỹ năng + MCP trong một bước? Hãy cài đặt [plugin Helius](/docs/vi/agents/claude-code-plugin). Chạy hai lệnh sau riêng biệt: ``` /plugin marketplace add helius-labs/core-ai ``` ``` /plugin install helius@helius-labs ``` Mở **Settings > Developer > Edit Config** và thêm máy chủ: ```json theme={"system"} { "mcpServers": { "helius": { "command": "npx", "args": ["helius-mcp@latest"] } } } ``` Khởi động lại Claude Desktop để áp dụng. Mở bảng lệnh (`Cmd/Ctrl + Shift + P`), tìm kiếm **MCP: Add Server** và nhập: * **Tên:** `helius` * **Lệnh:** `npx helius-mcp@latest` Hoặc thêm vào `.cursor/mcp.json` của dự án: ```json theme={"system"} { "mcpServers": { "helius": { "command": "npx", "args": ["helius-mcp@latest"] } } } ``` Tạo tệp `.vscode/mcp.json` trong thư mục gốc của dự án: ```json theme={"system"} { "servers": { "helius": { "command": "npx", "args": ["helius-mcp@latest"] } } } ``` Yêu cầu tiện ích [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) đã bật hỗ trợ MCP. Mở bảng lệnh (`Cmd/Ctrl + Shift + P`), tìm kiếm **Configure MCP Servers** và thêm: ```json theme={"system"} { "mcpServers": { "helius": { "command": "npx", "args": ["helius-mcp@latest"] } } } ``` Chạy lệnh sau: ```bash theme={"system"} codex mcp add helius -- npx helius-mcp@latest ``` Hoặc thêm vào `~/.codex/config.toml` của bạn (hoặc `.codex/config.toml` nếu chỉ áp dụng cho dự án): ```toml theme={"system"} [mcp_servers.helius] command = "npx" args = ["helius-mcp@latest"] ``` Xác minh bằng: ```bash theme={"system"} codex mcp list ``` ## Danh sách công cụ công khai Helius MCP cung cấp **10 công cụ công khai**: 9 công cụ miền được định tuyến cùng `expandResult`. Mọi thao tác Helius và Solana đều có thể được truy cập dưới dạng đối số `action` trên công cụ định tuyến tương ứng. | Công cụ | Phạm vi | | ------------------- | -------------------------------------------------------------------------------- | | `heliusAccount` | Thiết lập tài khoản, xác thực, gói dịch vụ, thanh toán | | `heliusWallet` | Số dư ví, tài sản nắm giữ, lịch sử, danh tính | | `heliusAsset` | Tài sản, NFT, bộ sưu tập, người nắm giữ token | | `heliusTransaction` | Phân tích giao dịch và lịch sử giao dịch của ví | | `heliusChain` | Trạng thái chuỗi, tài khoản token, khối, trạng thái mạng, tài khoản chương trình | | `heliusStreaming` | CRUD webhook và cấu hình đăng ký (WebSockets, LaserStream) | | `heliusKnowledge` | Tài liệu, hướng dẫn, giá, khắc phục sự cố, mã nguồn, blog, SIMD | | `heliusWrite` | Chuyển khoản — token SOL và SPL | | `heliusCompression` | Bằng chứng Merkle cho NFT nén | | `expandResult` | Mở rộng đầu ra ưu tiên bản tóm tắt theo `resultId` | Mọi thao tác được nhóm theo công cụ định tuyến, kèm chi tiết về cấu trúc lệnh gọi và cách sử dụng `expandResult` ### Cấu trúc lệnh gọi công cụ định tuyến Mỗi công cụ trong số 9 công cụ định tuyến đều có cấu trúc chung: * `action` — tên thao tác Helius cần chạy, chẳng hạn như `getBalance` hoặc `createWebhook` * các tham số dành riêng cho miền — ví dụ `address`, `signatures` hoặc `webhookURL` * `detail` tùy chọn — `summary`, `standard` hoặc `full` * các trường đo từ xa — `_feedback`, `_feedbackTool`, `_model` Lệnh gọi mẫu: ```json theme={"system"} { "name": "heliusWallet", "arguments": { "action": "getBalance", "address": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr", "_feedback": "initial balance check", "_feedbackTool": "heliusWallet.getBalance", "_model": "your-model-id" } } ``` ### Phản hồi ưu tiên bản tóm tắt và `expandResult` Các phản hồi lớn sẽ **ưu tiên bản tóm tắt**. Công cụ định tuyến trả về một bản tóm tắt ngắn gọn cùng `resultId` khi phản hồi đầy đủ có kích thước lớn hoặc khi `detail: "summary"` được yêu cầu. Sử dụng `expandResult` với `resultId` đó để tìm nạp một phần, phạm vi, trang hoặc lát dữ liệu tiếp theo cụ thể theo yêu cầu. Cách này giúp giảm mức sử dụng token cho các truy vấn thăm dò, đồng thời vẫn cho phép tác nhân xem sâu vào toàn bộ tải trọng khi cần. ## Đăng ký Tạo tài khoản Helius từ công cụ AI thông qua liên kết thanh toán được lưu trữ hoặc bằng cách thanh toán USDC trực tiếp từ một cặp khóa cục bộ. Quy trình đăng ký chạy qua công cụ định tuyến `heliusAccount`: AI gọi `heliusAccount` với `action: "generateKeypair"` — thao tác này tạo một ví Solana và trả về địa chỉ. AI gọi `heliusAccount` với `action: "signup"` và `mode: "link"` — trả về `paymentUrl` (ví dụ: `https://dashboard.helius.dev/pay/`) để người dùng mở và thanh toán bằng bất kỳ ví nào. Hoặc truyền `mode: "autopay"` để tự động gửi USDC từ cặp khóa cục bộ (ví phải có khoảng 0,001 SOL + số tiền của gói dịch vụ bằng USDC). Sau khi thanh toán qua liên kết, AI gọi `heliusAccount` với `action: "signup"` và `mode: "resume"` — thăm dò ý định thanh toán, hoàn tất việc cấp tài khoản và tự động cấu hình khóa API. **Thông tin liên hệ:** mọi lượt đăng ký mới — bao gồm cả gói Agent — đều yêu cầu `email`, `firstName` và `lastName`. `upgradePlan` cũng yêu cầu các thông tin tương tự. Hoặc thực hiện tương tự từ terminal bằng [Helius CLI](/docs/vi/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 ``` ## Cấu hình mạng Máy chủ MCP mặc định sử dụng **mainnet-beta**. Chuyển sang devnet qua biến môi trường: ```bash theme={"system"} export HELIUS_NETWORK=devnet ``` Hoặc gọi thao tác `setNetwork` trên `heliusAccount` trong một phiên. ## Lời nhắc hệ thống Gói `helius-mcp` đi kèm các lời nhắc hệ thống dựng sẵn, hướng dẫn mô hình AI cách sử dụng hiệu quả các công cụ Helius. Chúng nằm trong `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 ``` Mỗi lời nhắc có ba biến thể: * `openai.developer.md` — dành cho OpenAI Responses/Chat Completions API (thông báo `developer`) * `claude.system.md` — dành cho Claude API (lời nhắc hệ thống) * `full.md` — độc lập, với tất cả tham chiếu được nhúng trực tiếp (Cursor Rules, ChatGPT, v.v.) Xem hướng dẫn tích hợp [`helius-skills/SYSTEM-PROMPTS.md`](https://github.com/helius-labs/core-ai/blob/main/helius-skills/SYSTEM-PROMPTS.md) để biết các ví dụ mã. ## Kỹ năng Kỹ năng là các bộ hướng dẫn chuyên môn giúp Claude định tuyến yêu cầu của bạn đến đúng thao tác MCP và tệp tham chiếu. Chúng không chỉ cung cấp quyền truy cập công cụ thô — chúng còn bao gồm logic định tuyến, các mẫu SDK chính xác và quy tắc ngăn ngừa những lỗi phổ biến. Có sáu kỹ năng: Build (phát triển Solana nói chung), Phantom (dApp giao diện người dùng), Jupiter (DeFi), DFlow (ứng dụng giao dịch), OKX (giao dịch và thông tin chuyên sâu) và SVM (cơ chế nội bộ của giao thức) ## Tìm hiểu thêm Cài đặt MCP + kỹ năng chỉ bằng một lần nhấp Quản lý tài khoản bằng dòng lệnh Tìm hiểu về tiêu chuẩn Model Context Protocol Chi tiết gói và lịch sử phiên bản Lịch sử phiên bản và ghi chú phát hành Hướng dẫn đóng góp cho `helius-mcp`