> ## 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 サーバー

> Helius 用の MCP サーバー — AI アシスタントに Solana のクエリ、トランザクション送信、Webhook、ストリーミング、ウォレット解析、自動アカウントサインアップへのフルアクセスを提供する 10 のルーティングツール。

[Helius MCP サーバー](https://www.npmjs.com/package/helius-mcp)は、AI ツールに **10 の公開ツール** を通じて Helius API への直接アクセスを提供します — すべての Helius および Solana 機能をカバーする 9 つのルーティングドメインツールと、大きなレスポンスをページングするための `expandResult` を含みます。

<CardGroup cols={2}>
  <Card title="9 つのルーティングツール" icon="bolt">
    ドメインごとにグループ化されたツール (`heliusWallet`, `heliusAsset`, `heliusTransaction`, …) — すべての Helius アクションはこれらのいずれかを通じてアクセス可能です
  </Card>

  <Card title="アカウントサインアップ" icon="robot">
    AI ツールから Helius アカウントを作成します — ホストリンク経由で支払うか、ローカルキーの USDC を自動支払い
  </Card>

  <Card title="リアルタイムデータ" icon="signal-stream">
    Enhanced WebSockets と LaserStream gRPC に AI ツールから直接登録します
  </Card>

  <Card title="任意の MCP クライアント" icon="plug">
    Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex, および MCP 対応ツールで動作します
  </Card>
</CardGroup>

## MCPとは?

[モデルコンテキストプロトコル (MCP)](https://modelcontextprotocol.io/) は、Anthropic が導入したオープンソース標準で、AI モデルが外部データソース、ツール、API に安全に接続できるようにします。これは、ホスト（例：Claude）が MCP サーバーに接続するクライアントサーバーアーキテクチャを使用し、AI がデータベースを照会したり、API を呼び出したり、ユニバーサルで標準化されたインターフェイスを通じてアクションを実行できます。

**Helius にとっての重要性:** MCP は、Claude に Solana のライブデータと Helius インフラストラクチャへの直接アクセスを提供します — 残高、資産メタデータ、解析されたトランザクション、Webhook 管理、ストリーミングなど。これがなければ、Claude は API のレスポンスを推測するか、繰り返し curl リクエストを行ってコンテキストを得る必要があります。MCP は、Claude が構造化されたツールコールを使用して Helius 経由で Solana と実際に対話できるようにします。

<Note>
  Helius ドキュメントサイト [helius.dev/docs](https://www.helius.dev/docs) は、Mintlify によって自動生成された別の MCP サーバーも公開しています。そのサーバーはドキュメント検索のみに限定されています。ここで記載されている `helius-mcp` は、すべての Helius および Solana 機能を網羅する包括的なサーバーです。
</Note>

## クイックスタート

<Steps>
  <Step title="MCP サーバーの追加">
    ```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"]
        }
      }
    }
    ```
  </Step>

  <Step title="API キーの構成">
    **キーをすでに持っている場合:**

    ```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](/ja/agents/cli) 経由で設定)
       **新しいアカウントが必要な場合:** 下記の[サインアップ](#signup) を参照してください。
  </Step>

  <Step title="ツールの使用開始">
    簡単な英語で質問します — 適切なツールとアクションが自動的に選択されます:

    * "このウォレットが所有するNFTは何ですか？"
    * "このトランザクションを解析してください: `5abc...`"
    * "`Gh9ZwEm...` の残高を取得してください"
    * "`7xKp...` に1 SOLを送信"
    * "このアドレスのWebhookを作成する"
  </Step>
</Steps>

## Helius MCP サーバーへの接続

<Tabs>
  <Tab title="Claude Code">
    次のコマンドを実行します:

    ```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
    ```

    <Tip>
      スキル + MCP を一度に取得したい場合? [Helius プラグイン](/ja/agents/claude-code-plugin)をインストールしてください:

      ```bash theme={"system"}
      claude plugin install helius @claude-plugins-official
      ```

      または、Helius マーケットプレイスから:

      ```
      /plugin marketplace add helius-labs/core-ai
      /plugin install helius@helius-labs
      ```
    </Tip>
  </Tab>

  <Tab title="Claude Desktop">
    **設定 > 開発者 > 設定を編集** を開きサーバーを追加します:

    ```json theme={"system"}
    {
      "mcpServers": {
        "helius": {
          "command": "npx",
          "args": ["helius-mcp@latest"]
        }
      }
    }
    ```

    Claude Desktop を再起動して適用します。
  </Tab>

  <Tab title="Cursor">
    コマンドパレットを開き（`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"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="VS Code">
    プロジェクトのルートに `.vscode/mcp.json` ファイルを作成します:

    ```json theme={"system"}
    {
      "servers": {
        "helius": {
          "command": "npx",
          "args": ["helius-mcp@latest"]
        }
      }
    }
    ```

    MCP サポートが有効な[GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)拡張機能が必要です。
  </Tab>

  <Tab title="Windsurf">
    コマンドパレットを開き（`Cmd/Ctrl + Shift + P`）、 **MCP サーバーの構成** を検索して追加します:

    ```json theme={"system"}
    {
      "mcpServers": {
        "helius": {
          "command": "npx",
          "args": ["helius-mcp@latest"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Codex">
    次のコマンドを実行します:

    ```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
    ```
  </Tab>
</Tabs>

## 公開ツールのサーフェス

Helius MCP は **10 の公開ツール** を公開しています: 9 つのルーティングドメインツールと `expandResult`。すべての Helius および Solana アクションは、適切なルーティングツールにおける `action` 引数としてアクセス可能です。

| ツール                 | 範囲                                                     |
| ------------------- | ------------------------------------------------------ |
| `heliusAccount`     | アカウントの設定、認証、プラン、請求                                     |
| `heliusWallet`      | ウォレットの残高、保有、履歴、アイデンティティ                                |
| `heliusAsset`       | 資産、NFT、コレクション、トークン保有者                                  |
| `heliusTransaction` | トランザクションの解析とウォレットのトランザクション履歴                           |
| `heliusChain`       | チェーンの状態、トークンアカウント、ブロック、ネットワークの状態、プログラムアカウント            |
| `heliusStreaming`   | Webhook の CRUD とサブスクリプションの構成 (WebSockets, LaserStream) |
| `heliusKnowledge`   | ドキュメント、ガイド、価格、トラブルシューティング、ソース、ブログ、SIMD                 |
| `heliusWrite`       | トランスファー — SOL および SPL トークン                             |
| `heliusCompression` | 圧縮 NFT のための Merkle 証明                                  |
| `expandResult`      | `resultId` によるサマリー第一のアウトプットを展開                         |

<Card title="完全なツールカタログ" icon="bolt" href="/ja/agents/mcp/tools">
  ルーティングツールごとにグループ化されたすべてのアクション、呼び出しの詳細と `expandResult` の使用
</Card>

### ルーティングツール呼び出し形状

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`

大規模なレスポンスは **サマリー先行** です。ルーティングツールは、コンパクトなサマリーと、レスポンス全体が大きくなる場合や `detail: "summary"` が要求された場合に `resultId` を返します。その `resultId` を用いて要求に応じて特定のセクション、範囲、ページ、または継続スライスをフェッチします。

これにより、探索的クエリのためのトークン使用量が低く抑えられ、必要に応じてエージェントが完全なペイロードにドリルダウンできるようになります。

## サインアップ

ホストされた支払いリンクまたはローカルキーから直接USDCを支払うことで、AIツールからHeliusアカウントを作成します。サインアップフローは、`heliusAccount` ルーティングツールを通じて実行されます:

<Steps>
  <Step title="キーの作成">
    AIは `heliusAccount` を `action: "generateKeypair"` で呼び出します — これにより Solana ウォレットが作成され、アドレスが返されます。
  </Step>

  <Step title="支払い意図の作成">
    AI は `heliusAccount` を `action: "signup"` と `mode: "link"` で呼び出します — `paymentUrl` (例: `https://dashboard.helius.dev/pay/<id>`) を返し、ユーザーは任意のウォレットで支払うことができます。または、`mode: "autopay"` を渡してUSDCをローカルキーから自動的に送信します（ウォレットは約0.001 SOL + プラン金額のUSDCを保持する必要があります）。
  </Step>

  <Step title="支払い後の再開">
    リンクで支払った後、AI は `heliusAccount` を `action: "signup"` と `mode: "resume"` で呼び出します — 支払い意図をポーリングし、アカウントのプロビジョニングを最終化し、APIキーを自動的に設定します。
  </Step>
</Steps>

<Note>
  **連絡先情報:** 新規サインアップ — エージェントプランを含む — には、すべて `email`, `firstName`, および `lastName` が必要です。`upgradePlan` も同様です。
</Note>

または、ターミナルから[Helius CLI](/ja/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
```

または、セッション内で `heliusAccount` 上で `setNetwork` アクションを呼び出します。

## システムプロンプト

`helius-mcp` パッケージには、AI モデルが 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
```

各プロンプトには 3 つのバリアントが含まれています:

* `openai.developer.md` — OpenAI Responses/Chat Completions API 用 (`developer` メッセージ)
* `claude.system.md` — Claude API 用 (システム プロンプト)
* `full.md` — すべての参照をインライン化した自己完結型 (Cursor Rules, ChatGPTなど)

コード例は [`helius-skills/SYSTEM-PROMPTS.md`](https://github.com/helius-labs/core-ai/blob/main/helius-skills/SYSTEM-PROMPTS.md) 統合ガイドを参照してください。

## スキル

スキルは、リクエストを適切な MCP アクションと参照ファイルにルーティングする方法を Claude に教える専門の指示セットです。生のツールアクセスを超えて、ルーティングロジック、正しい SDK パターン、一般的な間違いを防ぐルールなどが含まれています。

<Card title="スキルの概要" icon="brain" href="/ja/agents/skills/overview">
  6 つのスキルが利用可能です: 開発 (一般的な Solana 開発)、Phantom (フロントエンド dApps)、Jupiter (DeFi)、DFlow (取引アプリ)、OKX (取引とインテリジェンス)、SVM (プロトコル内部)
</Card>

## 詳細を学ぶ

<CardGroup cols={2}>
  <Card title="Claude Code プラグイン" icon="puzzle-piece" href="/ja/agents/claude-code-plugin">
    MCP + スキルのワンクリックインストール
  </Card>

  <Card title="Helius CLI" icon="terminal" href="/ja/agents/cli">
    コマンドラインのアカウント管理
  </Card>

  <Card title="MCP 仕様" icon="book" href="https://modelcontextprotocol.io/">
    モデルコンテキストプロトコル標準について学ぶ
  </Card>

  <Card title="npm の helius-mcp" icon="npm" href="https://www.npmjs.com/package/helius-mcp">
    パッケージの詳細とバージョン履歴
  </Card>

  <Card title="Changelog" icon="list" href="https://github.com/helius-labs/core-ai/blob/main/helius-mcp/CHANGELOG.md">
    バージョン履歴とリリースノート
  </Card>

  <Card title="貢献" icon="github" href="https://github.com/helius-labs/core-ai/blob/main/helius-mcp/CONTRIBUTING.md">
    `helius-mcp` の貢献ガイド
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Claude Code Plugin" icon="puzzle-piece" href="/ja/agents/claude-code-plugin">
    One-click install of MCP + skills
  </Card>

  <Card title="Helius CLI" icon="terminal" href="/ja/agents/cli">
    Command-line account management
  </Card>

  <Card title="MCP Specification" icon="book" href="https://modelcontextprotocol.io/">
    Learn about the Model Context Protocol standard
  </Card>

  <Card title="helius-mcp on npm" icon="npm" href="https://www.npmjs.com/package/helius-mcp">
    Package details and version history
  </Card>

  <Card title="Changelog" icon="list" href="https://github.com/helius-labs/core-ai/blob/main/helius-mcp/CHANGELOG.md">
    Version history and release notes
  </Card>

  <Card title="Contribute" icon="github" href="https://github.com/helius-labs/core-ai/blob/main/helius-mcp/CONTRIBUTING.md">
    Contribution guide for `helius-mcp`
  </Card>
</CardGroup>