Helipod

Helipod MCP サーバーとスキル

AI コーディングツールから Helipod を利用できます。自然な言葉で指示するだけで、アプリやデータベースのデプロイ、VPS サーバーの実行、ドメインの購入や DNS の編集、メールの送信を行えます。

• MCP サーバー（helipod-mcp）：Container、Database、VPS、Domain、Email、Account、AI API に対応する 229 個のツールを提供します。Claude Code、Codex、Cursor、VS Code、Windsurf、Claude Desktop、その他の MCP クライアントで動作します。
• スキル（skills/）：Helipod が想定する手順（最初に価格を確認し、削除前に確認し、失敗した場合はビルドログを読む）で、エージェントがデプロイや価格確認、確認作業を行うためのステップごとの手順書です。

各ツールのステップごとのガイド（Claude Code、Codex、Cursor、VS Code、Gemini CLI、opencode、Windsurf、Claude Desktop、Cline など）：https://docs.helipod.io/docs/helipod/ai-agents

クイックスタート：サインイン（キー不要）

ホスト型サーバーを追加し、ブラウザーで Helipod にサインインします。利用を許可する製品（Container、VPS、Domain API）とプロジェクトを選択できます。また、Settings → API keys → Connected apps からいつでも接続を解除できます。

ツール	追加方法	サインイン
Claude Code	/plugin marketplace add helipodapp/mcp then /plugin install helipod@mcp (or claude mcp add --transport http helipod https://api.helipod.io/mcp)	/mcp → helipod → Authenticate
Codex	~/.codex/config.toml に [mcp_servers.helipod] url = "https://api.helipod.io/mcp" を記述	codex mcp login helipod
Cursor	~/.cursor/mcp.json に {"mcpServers":{"helipod":{"url":"https://api.helipod.io/mcp"}}} を記述	Settings → MCP → Needs login
opencode	{"mcp":{"helipod":{"type":"remote","url":"https://api.helipod.io/mcp"}}}	opencode mcp auth helipod
Gemini CLI	{"mcpServers":{"helipod":{"httpUrl":"https://api.helipod.io/mcp"}}}	/mcp auth helipod
VS Code	.vscode/mcp.json に {"servers":{"helipod":{"type":"http","url":"https://api.helipod.io/mcp"}}} を記述	サーバーの起動時にプロンプトが表示されます
Claude.ai, ChatGPT	URL https://api.helipod.io/mcp を指定してカスタムコネクターを追加	接続時にプロンプトが表示されます

キー、ローカルサーバー、または一覧にないツールを使いたい場合は、続きをお読みください。

1. キーを取得する

ダッシュボードでプロジェクトを開き、Settings → API keys に進みます。製品（Container API、Database API、VPS API、Domain API）とアクセス範囲（1 つのプロジェクト、またはアカウント全体）を選択します。Domain API にはアカウント全体を対象とするキーが必要です。キーは hel_ で始まります。

メール用ツールを使うには、キーで Email API を有効にします（または、Email API にチェックを入れてサインインします）。プロジェクトの Email セクションで取得したメールキーも、HELIPOD_EMAIL_API_KEY として引き続き使用できます。

export HELIPOD_API_KEY=hel_...
export HELIPOD_EMAIL_API_KEY=...   # optional: only if you use a separate email key

試用中は、まず 1 つのプロジェクトに限定したキーを使用してください。

2. ツールを接続する

サーバーは npm パッケージ helipod-mcp です（Node.js 18 以降）。以下の設定では、環境変数から HELIPOD_API_KEY を渡しながら、npx -y helipod-mcp（またはインストール済みの helipod-mcp コマンド）を実行します。

Claude Code

前述のプラグインは、サインインしてホスト型サーバーを使用します。代わりにローカルサーバーをキーで使用する場合：

claude mcp add helipod --env HELIPOD_API_KEY=$HELIPOD_API_KEY -- npx -y helipod-mcp

Codex

一度インストールします（Codex は MCP サーバーの起動を待たないため、インストール済みのサーバーなら最初のメッセージから利用できますが、npx では間に合わないことがあります）。

npm install -g helipod-mcp

~/.codex/config.toml：

[mcp_servers.helipod]
command = "helipod-mcp"
env_vars = ["HELIPOD_API_KEY", "HELIPOD_EMAIL_API_KEY"]

Cursor

~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1 つのプロジェクト）：

{
  "mcpServers": {
    "helipod": {
      "command": "npx",
      "args": ["-y", "helipod-mcp"],
      "env": { "HELIPOD_API_KEY": "${env:HELIPOD_API_KEY}" }
    }
  }
}

Gemini CLI

~/.gemini/settings.json：

{
  "mcpServers": {
    "helipod": {
      "command": "npx",
      "args": ["-y", "helipod-mcp"],
      "env": { "HELIPOD_API_KEY": "$HELIPOD_API_KEY" }
    }
  }
}

Gemini CLI は、信頼済みのフォルダー内でのみ MCP サーバーを起動します。

opencode

~/.config/opencode/opencode.json：

{
  "mcp": {
    "helipod": {
      "type": "local",
      "command": ["npx", "-y", "helipod-mcp"],
      "environment": { "HELIPOD_API_KEY": "{env:HELIPOD_API_KEY}" }
    }
  }
}

VS Code（Copilot エージェントモード）

.vscode/mcp.json：

{
  "inputs": [{ "id": "helipod-key", "type": "promptString", "description": "Helipod API key", "password": true }],
  "servers": {
    "helipod": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "helipod-mcp"],
      "env": { "HELIPOD_API_KEY": "${input:helipod-key}" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "helipod": {
      "command": "npx",
      "args": ["-y", "helipod-mcp"],
      "env": { "HELIPOD_API_KEY": "hel_..." }
    }
  }
}

その他のクライアント

環境変数に HELIPOD_API_KEY を設定して、stdio MCP サーバーとして npx -y helipod-mcp を実行します（メール用ツールを使うには Email API を有効にするか、HELIPOD_EMAIL_API_KEY を追加します）。

ホステッドサーバー（インストール不要）

URL で接続するクライアントは、https://api.helipod.io/mcp（Streamable HTTP）を Authorization: Bearer hel_... とともに使用できます（同じキーまたはサインインで Email API が有効になっていればメールツールも利用でき、X-Helipod-Email-Key も引き続き使用できます）。ツールは同じで、キーはリクエストごとに使用され、保存されることはありません。

claude mcp add --transport http helipod https://api.helipod.io/mcp --header "Authorization: Bearer $HELIPOD_API_KEY"

# Codex: ~/.codex/config.toml
[mcp_servers.helipod]
url = "https://api.helipod.io/mcp"
bearer_token_env_var = "HELIPOD_API_KEY"

他のエージェント向けのスキル

Claude Code ではプラグインによってスキルを利用できます。Codex、Cursor、Gemini CLI、opencode、GitHub Copilot、および SKILL.md ファイルを読み込む他のエージェントの場合：

npx skills add helipodapp/mcp -g

求められたらエージェントを選択してください（または -a codex cursor gemini-cli opencode -y を渡してください）。-g を指定しない場合、スキルは現在のプロジェクトのみにインストールされます。

3. 質問する

• 「このリポジトリを自分の Helipod プロジェクトにデプロイして、URL を教えてください。」
• 「このプロジェクト用の Postgres データベースを作成して、api サービスに接続してください。」
• 「最後のデプロイが失敗した理由を教えてください。」
• 「tokosaya.id は利用可能ですか？価格はいくらですか？」
• 「www.tokosaya.id を自分の Web サービスに向けてください。」
• 「2 GB の Ubuntu VPS を作成して、ポート 443 を開いてください。」
• 「[email protected] から自分宛てにテストメールを送信してください。」

ツール

分野	ツール
コンテナ	プロジェクトと環境（作成、名前変更、削除）、共有プロジェクト変数、サービス（イメージ、Git、または Dockerfile から作成、名前変更）、デプロイ、デプロイとビルドログ、再起動、変数、ドメインとそのポート、スケーリング、ボリューム（サイズ変更を含む）、関数コード、シークレットファイル、ログ、メトリクス、テンプレート、複数サービスのスタック
データベース	マネージド Postgres：作成、接続文字列、環境ごとのブランチ、コンピュート設定、プランのアップグレード、使用状況、リアルタイム統計、クレジット残高、テーブル、読み取り専用クエリ、SQL の分類と確認済みの書き込み
VPS	プラン、作成、名前変更、電源操作、再インストール、パスワード、ログイン情報、終了、更新、アップグレードオプションとアップグレード、自動更新、メトリクス、ファイアウォール、ポートフォワーディング、SSH キーと SSH のオン／オフ、スナップショット、バックアップ
ドメイン	検索、価格、所有者情報、登録、移管、更新（いずれもドライラン対応）、DNS レコード、ネームサーバー、子ネームサーバー、WHOIS プライバシー
メール	ステータス、プラン（ドライラン対応の購入、更新、変更、受信トレイのアドオン）、送信、送信ログ、送信ドメイン、テンプレート、連絡先、セグメント、トピック、一斉送信、抑制リスト、Webhook、受信トレイ
アカウント	ウォレットと取引、請求書、月次明細、通知、プロジェクトのアクティビティ、サポートチケット
AI	モデルと価格、残高、使用状況、メトリクス、AI キー（一覧、取り消し）、チャージと自動チャージ
その他	helipod_api_get を使って、ドキュメントに記載された他の任意のエンドポイントを読み取る（読み取り専用）

各ツールには読み取り専用、書き込み、または破壊的操作のいずれかが明示されているため、クライアントはリスクの高いツールを実行する前に確認できます。費用が発生する呼び出しはドライランに対応しており、サーバーはエージェントに価格を提示してユーザーの OK を待つよう指示します。

安全性

• エージェントが実行できるのは、キーで許可された操作のみです。プロジェクト限定のキーを使い、必要な製品のみを有効にしてください。
• 有料操作（新しいサービス、VPS、ドメイン、スケーリング、メールプラン、AI のチャージ）では Helipod ウォレットに請求されます。ツールはまずドライランを実行し、実際の呼び出しの前に確認を求めます。書き込みツールと破壊的操作を行うツールでは、ツールの承認を有効にしておいてください。
• ダッシュボードからいつでもキーを取り消せます。

設定

変数	デフォルト
HELIPOD_API_KEY	（コンテナ、VPS、ドメインで必須）
HELIPOD_EMAIL_API_KEY	（任意。Email API が有効な場合、メールツールは HELIPOD_API_KEY を使用します）
HELIPOD_API_URL	https://api.helipod.io/api
HELIPOD_EMAIL_API_URL	https://mail.helipod.io/api/email

開発

bun install
bun run typecheck
bun test                       # catalog tests; live tests need HELIPOD_TEST_KEY
bun run build                  # dist/stdio.js, dist/index.js, dist/http.js

ドキュメント：https://docs.helipod.io