Nippy

@nippyhost/cli

ターミナル、CI、または Claude から、ウェブサイトを nippy.host に公開できます。フォルダーを渡すだけでリンクを取得できます。写真はギャラリーに、ファイルはダウンロードページになり、サイトはそのまま動作します。リンクの有効期限はありません。

npx @nippyhost/cli login                       # one-time: approve in your browser, done
npx @nippyhost/cli deploy ./dist --site demo   # → https://demo.nippy.site

実行ファイル名は nippy なので、グローバルインストールすると短いコマンド名を使えます。

npm i -g @nippyhost/cli
nippy deploy ./photos --site henderson-wedding

コマンド

コマンド	説明
nippy login	ブラウザーで nippy.host を開き、CLI の使用を承認します（OAuth、コピー＆ペースト不要）。取得したスコープ付きトークンは ~/.config/nippy/ に保存されます（chmod 600）。ヘッドレス環境や SSH マシンでは --paste を使用します
nippy deploy [path] --site <name>	フォルダー、単一ファイル、または zip を公開します。サイトが存在する場合は 同じ URL のまま更新し、存在しない場合は作成します。--new で新しいサイトを強制的に作成し、スクリプトでは --json を使用します
nippy sites / nippy sites info <name>	サイトの一覧表示／指定したサイトのファイルを表示
nippy open <name>	https://<name>.nippy.site を開きます
nippy whoami	有効な認証情報と、その動作状況を確認します
nippy mcp install [--client …]	Claude Desktop、Claude Code、または Cursor に MCP サーバーを追加します
nippy mcp serve	stdio で MCP サーバーを実行します（アシスタントが呼び出します）

Claude から使用する（MCP）

claude.ai（またはリモート MCP サーバーに対応した任意のクライアント）では、インストール不要です。 URL https://api.nippy.host/mcp を指定してカスタムコネクターを追加してください。承認には nippy login と同じ OAuth 同意画面を使用します（Streamable HTTP、OAuth 2.1 + PKCE、動的クライアント登録）。リモートサーバーでは同じツールに加えて、あらゆる種類とサイズのファイルに対応する start_upload / start_revision / finalize_upload / abort_upload も利用できます。

Claude Desktop、Claude Code、または Cursor（ローカル、stdio）：

npx nippy-mcp                       # Claude Desktop
npx nippy-mcp --client claude-code  # Claude Code
npx nippy-mcp --client cursor      # Cursor

あとは「このページを Nippy に公開して」と頼むだけです。ツールには publish_site、update_site（同じ URL のまま、対象ファイルのみ変更）、list_sites、list_permanent_sites、read_site_file、check_site_name のほか、パスワード、SEO メタデータ、検索インデックス登録、訪問者分析のための有料プラン向けツールが含まれます。小さなバイナリ（画像、PDF、フォント）は encoding: "base64" でインライン送信できます（1 ファイルあたり最大 4 MB、1 回の呼び出しあたり最大 12 MB）。それより大きなファイルには nippy deploy を使用してください。

プレビュー

アシスタントは試行錯誤を繰り返し、多くの下書きは使い捨てです。そのため、公開には 2 つの動詞があります。publish_preview を使うと、下書きを <slug>.preview.nippy.site に公開できます。有効期限は最終更新から 24 時間後で、インデックス登録されず、サイト枠も消費しません。update_preview で更新すると有効期限がリセットされ、list_previews で残り時間とともに有効なプレビューを確認でき、discard_preview で破棄できます。

下書きを残す価値がある場合は、promote で新しいサイトとして恒久化するか、既存サイトのコンテンツを置き換えます。プレビュー URL は無効になりません。サイトへの恒久的なリダイレクトになるため、すでに共有したリンクも引き続き機能します。

publish_site の動作は変わらず、「恒久公開し、プランの上限にカウントされる」ことを意味します。無料アカウントでは、一度に有効にできるプレビューは 5 件です。有料プランでは無制限です。

CI で使用する

# any CI — the token comes from a secret
- run: NIPPY_TOKEN=${{ secrets.NIPPY_TOKEN }} npx @nippyhost/cli deploy ./dist --site docs --json

NIPPY_TOKEN は常に保存済みのログイン情報より優先されます。

トークンとセキュリティ

• nippy login は Nippy の AI コネクターと同じ OAuth 同意画面を使用します。ログインは Settings → API & MCP の Connected apps に表示され、いつでも接続を解除できます。CI では、代わりにここでトークンを作成してください。無料アカウントで利用できます（有効なサイト 1 件、25 MB、カード不要）。
• トークンには スコープ（deploy/read/manage/analytics）が設定され、いつでも取り消せます。サイトの削除、請求情報へのアクセス、アカウント管理はできません。これらにはダッシュボードが必要です。
• プランの上限はサーバー側で適用され、正確に通知されます。上限に達すると、その上限の内容が明確に示されます。

注意事項

• index.html を含まないフォルダーは、画像のみの場合はギャラリーに、ファイルが混在している場合は見やすいダウンロードページに自動的になります。
• ZIP ファイルはアップロード前にローカルで展開されます。
• サイト名は nippy.site のサブドメインです。使用できるのは小文字のアルファベット、数字、ハイフンです。名前がすでに使われている場合は、次に空いているサフィックスが返されます。

MIT · nippy.host · ヘルプ

---

このリポジトリについて

これは @nippyhost/cli と nippy-mcp のソースミラーです。開発は Nippy モノレポ（API クライアントの生成とテストスイートの実行を行う場所）で行われます。このソースは、閲覧、課題報告、リリースのために公開されています。

• cli/ — nippy コマンドと MCP サーバー（@nippyhost/cli）
• sdk/ — 公開用 SDK：初期化 → 事前署名付きアップロード → 確定の一連の処理
• upload-rules/ — プラットフォームと共有するクライアント側の検証ルール

バグ報告や機能リクエスト → 課題。