Netrun

netrun-mcp

ウェブサイトや Telegram ボットを Netrun に公開できます。エディターからフォルダーをアップロードするだけで、URL を取得できます。

Netrun を AI エディターに接続して、「このボットを公開して」と頼むだけです。エージェントがコードフォルダーをアップロードし、リンクを返します。MCP は外部サービスを AI エディターに接続するための共通の方法です。Netrun を接続したら、プロジェクトをオンラインにしたいことをチャットでエージェントに伝えます。エージェントがコードフォルダーをアップロードし、コードにトークンが必要な場合は確認し、ビルドの完了を待ってリンクを返します。Cursor、Claude Code、Codex、Claude Desktop、VS Code、Windsurf のほか、ブラウザー上の ChatGPT や Claude でも動作します。

このボットを Netrun に公開して

あいさつ文を修正しました。プロジェクトを更新して

ボットが応答しないのはなぜ？ログを確認して

ボットのトークンを変更して再起動して

セットアップ（1 分）

1. netrun.io にサインインし、MCP（https://netrun.io/mcp）を開いて、アクセスキーを作成します。
2. エディターを接続します。MCP ページには、キーがあらかじめ設定されたボタンまたはコマンドが表示されます。汎用の設定形式は次のとおりです。

{
  "mcpServers": {
    "netrun": {
      "command": "npx",
      "args": ["-y", "netrun-mcp@latest"],
      "env": {
        "NETRUN_API_KEY": "nru_…"
      }
    }
  }
}

• Cursor — MCP ページで Add to Cursor をクリックするか、上記の JSON を ~/.cursor/mcp.json に記述します。
• Claude Code — claude mcp add netrun -s user -e NETRUN_API_KEY=nru_… -- npx -y netrun-mcp@latest
• Codex — codex mcp add netrun --env NETRUN_API_KEY=nru_… -- npx -y netrun-mcp@latest
• Claude Desktop、VS Code、Windsurf — 上記の JSON を MCP サーバーの設定に記述します。

Node.js をインストールする必要があります。通常、AI エディターには同梱されています。

ブラウザー上の ChatGPT、Claude — インストール不要、キー不要

Netrun はリモート MCP サーバーとしても動作します。https://api.netrun.io/v1/mcp（Streamable HTTP、OAuth サインイン）を使用します。チャットの設定で接続（Connectors または Apps）を開き、このアドレスでカスタム接続を追加して、Connect を押します。メールアドレスで Netrun にサインインします。キーは必要ありません。ChatGPT でカスタム接続を利用できるのは有料プランです。設定で開発者モードを有効にしてください。Claude ではすべてのプランで利用でき、無料プランでも 1 つ利用できます。エージェントは会話から直接コードを取得します。複数のファイルからなる大規模なプロジェクトは、エディターから公開するほうが簡単です。

エージェントでできること

ツール	機能
netrun_publish	プロジェクトフォルダーをアップロードしてオンラインにします。新しいプロジェクトにも、既存プロジェクトの新しいバージョンにも対応します。スタック（Python、Node、Go、Rust、PHP、静的 HTML、Docker、docker-compose）を検出し、不足しているシークレットを確認してからビルドの完了を待ち、URL または失敗の理由を返します。
netrun_status	プロジェクトが実行中かどうか、URL、公開を妨げている要因、設定済みのシークレット、最後の公開が失敗した理由を確認します。
netrun_logs	アプリケーション出力の最新行を表示します。ボットが応答しなくなったとき、まず確認する場所です。
netrun_set_secrets	トークンや API キーを環境変数として保存し（暗号化して保存）、アプリがそれらを反映できるように再公開します。
netrun_link	プロジェクトに公開 HTTPS アドレスを割り当てるかどうかを決定します。たとえば、バックグラウンドプログラムとして動かしていたボットを Webhook ボットにできます。プロジェクトを再公開し、インターネットからのリクエストにアプリが応答するとリンクが表示されます。
netrun_domains	独自ドメインをサイトに割り当て、レジストラーの設定が反映されたかを確認します。反映されるまでは、追加するレコードが表示されます。
netrun_control	プロジェクトを起動、停止、または再起動します。
netrun_list_projects	アカウント内のすべてのプロジェクトを、URL と状態とともに表示します。
netrun_whoami	プラン、利用可能なプロジェクト数、ボットに残っている無料稼働時間を確認します。

意図的にできないこと

• エージェントは支払い、プランの更新、枠の購入はできません。これらはダッシュボードで行います。
• プロジェクトや永続ストレージ内のファイルを削除することもできません。取り消せない操作はすべて、ユーザーが行います。
• コードにトークンやパスワードが必要な場合、公開前にエージェントが確認します。値を勝手に作ることはありません。
• アクセスキーはエディターの設定内にのみ保存され、接続したチャットはダッシュボードに一覧表示されます。どちらも、いつでもダッシュボードから取り消せます。

仕組み

このパッケージは薄い仲介役です。フォルダーを（.gitignore を尊重して）zip 形式に圧縮し、キーを使って Netrun API に送信して、ステータスとログを取得します。ビルド、実行、HTTPS、アドレスはすべて Netrun 上で処理されます。

環境変数：NETRUN_API_KEY（必須）、NETRUN_API_URL（デフォルト：https://api.netrun.io/v1）、NETRUN_APP_URL（デフォルト：https://netrun.io）。

• レジストリ：io.netrun/netrun
• ソース：https://github.com/netrun-io/netrun-mcp

MIT