Claude Code MCP 設定 どこに書く?Coolify連携とVPSデプロイ
MarkdownCoolifyのインストール、GitHubへの接続、Next.jsのデプロイ、ドメインとHTTPS、MCP、VPSの要件、トラブルシューティング。ドル建ての技術料金と元記事に記載された制限。
記事の全文を読む
Ailootドキュメント — サービスを利用するための参考資料。
2026年のプラットフォームの制限と支払い条件
重要なポイント
無料プランは最初の上限超過までは使えますが、それ以降は海外発行のカードが必要です。Herokuは2022年にすべてのユーザー向け無料プランを終了し、2026年2月に維持管理モードへ移行しました。Coolifyをセルフホストすれば、サーバーは自分のものです。ユーザー単位の課金も、ベンダーロックインもありません。
2026年によくあるバイブコーダーのシナリオです。CursorやClaude Codeで一晩かけてMVPを作り、GitHubリポジトリに移して、vercel.comを開く → リポジトリを接続する → サブスクリプション画面に進む → カード情報を入力する → Transaction declined と表示される。
これはバグでも一時的な障害でもありません。
Railway、Render、Herokuも同じ状況です。Herokuは実際に2022年にすべてのユーザー向け無料プランを終了し、2026年2月にはプロジェクトが維持管理モードに移行しました。新機能も新しいEnterprise契約もありません。利用できないカードしか持たないユーザーにとって、これは「ドアは閉まった。20%の手数料を取る仲介業者を通って迂回しろ」という意味です。
カザフスタンのバーチャルVisaカードや法人向け決済サービスを使って支払うことはできます。しかし、価格に20%が上乗せされ、取引ごとに30分余計にかかり、決済処理業者に国の不一致を検知されてアカウントがブロックされるリスクもあります。
元の例には、Vercel Pro、Railway、Renderでの3つの試行が含まれていました。
Coolifyとは?セルフホスト型プラットフォームの仕組み
重要なポイント
Coolifyは、オープンソースでセルフホスト可能なPaaSであり、Heroku、Vercel、Netlifyの直接的な代替サービスです。Ubuntuを実行するどのVPSにも、curlコマンド1つでインストールできます。内部ではDocker + Traefikをリバースプロキシに、Let's EncryptをHTTPSに使用します。GitHub連携、自動デプロイ用Webhook、S3バックアップ、280以上のワンクリックサービス(PostgreSQL、Redis、MinIO)に対応しています。セルフホスト版は永久に無料で、制限はありません。GitHubで55,800スターを獲得しており、ライセンスはApache-2.0です。
CoolifyはLaravel + Dockerで構築されたオープンソースプロジェクトで、何も入っていないVPSをアプリケーションのデプロイプラットフォームに変えます。Coolifyを一度インストールすれば、あとはすべてWebインターフェースで操作できます。GitHubを接続し、リポジトリを選んで、Deployをクリックするだけです。
公式ドキュメントでは、簡潔かつ正確にこう説明されています。
Coolifyは、Heroku / Netlify / Vercelなどに代わる、オープンソースのセルフホスト可能なサービスです。
内部では、Coolifyは4つの部分で構成されています。
- Laravel 12 + Livewire 3 + Tailwind v4で構築されたWebインターフェース — アプリケーションを管理するダッシュボードです。
- Docker + Docker Compose — 各アプリケーションはコンテナ内で実行され、ほかのアプリケーションから分離されます。
- リバースプロキシ(TraefikまたはCaddy) — HTTP/HTTPSの受信トラフィックを受け取り、コンテナに振り分けます。
- Let's Encrypt連携 — すべてのドメインのSSL証明書を自動で発行・更新します。
Coolifyを機能面でVercelに匹敵させる主な機能は次のとおりです。
| 機能 | Vercel | Coolify |
|---|---|---|
| git push時の自動デプロイ | ✅ | ✅(GitHub webhook経由) |
| 無料HTTPS | ✅ | ✅(Let's Encrypt) |
| PRのプレビュー環境 | ✅ | ✅(GitHub App経由) |
| 環境変数のUI | ✅ | ✅ |
| データベースのバックアップ | ❌(独自のデータベースなし) | ✅(S3互換ストレージへ) |
| PostgreSQL / Redis / MongoDB | 月額$20以上/各 | ✅ ワンクリック、無料 |
| スケジュールタスク(cron) | ❌ | ✅(cron構文) |
| ユーザー単位の課金 | 月額$20/シート | なし |
| ベンダーロックイン | 高い(Edge Functions、ISR) | なし(自分のDocker) |
| グローバルCDN | ✅ | ❌(自分のVPSのみ) |
Coolifyに標準で含まれていないのは、グローバルCDNだけです。これが正直な答えです。プロジェクトが世界中にユーザーを持ち、米国や欧州のユーザーの遅延を減らしたい場合は、Cloudflareを前段に配置してください。静的コンテンツなら無料です。
価格:セルフホスト版は永久に無料で、アプリケーション、サーバー、デプロイの数に制限はありません。Coolify Cloudは2台のサーバーで月額$5、追加のサーバー1台ごとに$3で利用できます。ただし、サーバー自体は引き続き自分のものです。Coolify Cloudがホストするのはダッシュボードだけです。
最新リリースは、2026年5月18日のv4.1.0です。新機能には、ベータ版のRailpackビルドパック、監査ログ、デプロイ間の設定差分、読み取り専用のネイティブMCPエンドポイントが含まれます。出典:GitHubのリリース。
2026年にCoolifyを使うなら、どのVPSを選ぶべき?
重要なポイント
Coolifyの最低要件は、2 vCPU、2 GB RAM、30 GB SSD、Ubuntu LTS(20.04、22.04、または24.04)です。この構成のVPSなら、Vibeコーディングで作ったプロジェクトを3〜5個、並行して無理なく実行できます。
Coolifyの最低要件は公式ドキュメントに記載されています。
| パラメーター | 最低要件 | 推奨 |
|---|---|---|
| CPU | 2コア | 2〜4コア |
| RAM | 2 GB | 4 GB(ビルド用の余裕を含む) |
| ストレージ | 30 GB | 50〜80 GB(イメージ + データベース用) |
| アーキテクチャ | AMD64またはARM64(64ビット) | AMD64 |
| OS | Ubuntu LTS 20.04 / 22.04 / 24.04 | 22.04 LTS |
| root | 必須 | パスワードではなくSSHキー経由 |
最低要件の2 GB RAMは絶対的な下限です。1 GBの場合、インストーラーはDockerのところまで進みますが、OOM(メモリ不足)が発生して停止します。RAMをケチらないでください。
価格の出典:Timeweb Cloud、FirstVDS、Selectel。
さらに大きな性能が必要な場合(100 GBのデータベース、複数のPostgresインスタンスなど)は、Aeza Dedicatedを利用してください。
選んではいけないもの:
- RAMが512 MB〜1 GBの共有VPS — Coolifyを動かすにも足りません。これはnginxで静的サイトを動かすためのもので、PaaS向けではありません。
デプロイの設定だけでなく、Claudeの信頼性を高めるセットアップも構築したいですか?Coolifyは実行ツールですが、構造化されたコンテキスト(CLAUDE.md、セカンドブレイン、コンテキストエンジニアリング)がなければ、長いタスクでClaudeは依然として幻覚を起こします。完全なセットアップには、AIクローン + セカンドブレイン + コンテキストエンジニアリングの3つすべてが含まれます。この組み合わせによって、Claudeは「幻覚を起こすアシスタント」から信頼できるツールに変わります。
Coolifyを5分でインストールする方法
重要なポイント
インストールには、ドキュメントに記載されたcurlコマンドを1つ実行します。起動すると、ポート8000にWebインターフェースが表示されます。そこで最初の管理者ユーザーを作成すると、空のダッシュボードが表示されます。Ubuntuの初期状態からCoolifyが動作するまで実際にかかる時間は5〜7分で、そのうち3〜4分はapt-get install dockerにかかります。スクリプトが必要な依存関係を取得してDockerを設定するので、完了するまで待つだけです。
手順1. SSHでVPSに接続します。
プロバイダーでVPSを作成すると、サーバーのIPアドレスとrootパスワードがメールまたはコントロールパネルに表示されます。ローカルマシンから接続します。
ssh root@1.2.3.4
プロバイダーからパスワードではなくSSHキーを受け取った場合は、-i path/to/keyを指定して接続します。ここからは、新規インストールしたUbuntu 22.04または24.04 LTSを使っているものとします。
手順2. Coolifyのインストールコマンドを実行します。
公式ドキュメントにあるコマンドを1つ実行します。
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash
スクリプトは次の3つを実行します。
- システムを確認する(Ubuntu LTSか、rootか、AMD64か)
- まだインストールされていない場合はDockerとDocker Composeをインストールする
- Coolifyのイメージ(
coolify/coolify、coolify/realtime、traefik)をダウンロードし、docker-compose経由でバックグラウンド実行する
この処理には3〜5分かかります。apt-getのログが流れ、その後docker pullが表示されます。Coolify v4.1.0 is now runningと表示されたら、手順3に進みます。
手順3. Webインターフェースを開きます。
ブラウザーで次のURLを開きます。
http://1.2.3.4:8000
Coolifyのセットアップウィザードが表示されます。最初のユーザーを作成するフォームです。メールアドレスとパスワードを入力して保存してください。このユーザーは自動的に管理者になるので、まだほかのユーザーを作る必要はありません。
保存すると、空のダッシュボードが表示されます。左側にResources / Projects / Servers / Sources / Notifications / Settingsのサイドバーがあり、中央に「最初のリソースを追加」という案内が表示されます。
手順4. プロバイダーのファイアウォールでポートを開きます(UFWではありません)。
Coolifyはすでに動作していますが、外部からアクセスできるのはダッシュボード用のポート8000だけです。ユーザーがアプリケーションにアクセスできるよう、ポート80(HTTP)と443(HTTPS)を開く必要があります。
| ポート | 用途 |
|---|---|
| 22 | サーバーへのSSH接続 |
| 80 | HTTPトラフィックを受信。Let's Encryptの検証に必要 |
| 443 | ユーザーのHTTPSトラフィックを受信 |
| 8000 | Coolifyダッシュボード(ダッシュボードに独自ドメインを設定した後で閉じます) |
公式ドキュメントに記載された重要な注意点です。
DockerはNATベースのiptablesルールを使用しており、UFWなど従来のLinuxファイアウォールを迂回することがあります。
つまり、UFWを有効にしてすべてのポートを閉じても、Dockerはiptables経由でコンテナを公開します。この環境ではUFWは役に立ちません。解決策は、UFWではなくプロバイダーのコントロールパネルでポートを開閉することです。Timeweb / Selectel / Aezaでは、Webコンソールの「Network → Firewall」から設定します。
手順5(任意)。ダッシュボードを独自ドメインに紐付けます。
http://1.2.3.4:8000ではなくhttps://coolify.example.comで開くには、DNS Aレコードcoolify.example.com → 1.2.3.4を作成し、CoolifyのSettings → Instance Settings → Instance Domainに進んでサブドメインを入力し、保存します。CoolifyがLet's Encrypt証明書を要求し、1分ほど後にダッシュボードをHTTPSで再読み込みします。
その後、ファイアウォールでポート8000を閉じても構いません。ダッシュボードには標準ポート443のHTTPSでアクセスできます。
GitHubへの接続方法:AppとPATのどちらを使う?
重要なポイント
CoolifyはGitHubへの接続方法として、GitHub App(推奨)とPersonal Access Token(PAT)の2つに対応しています。GitHub Appを使ってください。ウィザードを使えば設定は5分で完了し、PRプレビューが動作し、リポジトリ単位で権限を細かく設定できます。PATは従来のケース向けの古い方式です。プレビュー環境には対応せず、すべてのリポジトリにグローバルアクセスを許してしまうリスクがあります。公式ドキュメントには、「ユーザーの95%にとって、GitHub Appが正解です」と明記されています。
CoolifyでSources → + Add → GitHub Appに進みます。3画面のウィザードが表示されます。
- Name & description — ソース名(
github-main)を入力し、必要に応じて説明を追加します。 - Configure on GitHub — GitHub.comに移動し、正しい権限が設定されたGitHub Appの作成フォームを自動で開くボタンです。
- Confirm — GitHubから戻ったら「Save」をクリックします。
2つ目の手順で、GitHubからCoolifyが要求する権限の確認を求められます。
| 権限 | レベル | 用途 |
|---|---|---|
| Contents | 読み取り専用 | リポジトリのクローン |
| Pull Requests | 読み書き | プレビュー環境を作成し、PRにコメントする |
| Email addresses | 読み取り専用 | コミットを識別する |
| Metadata | 読み取り専用 | リポジトリを一覧表示する |
これらは最低限の権限です。GitHub Appは秘密鍵を閲覧できず、mainに書き込めず、明示的に接続していないリポジトリにもアクセスできません。
公式ドキュメントより:
Personal Access Token(PAT)は古い方法なので、使用しないことをおすすめします。欠点は次のとおりです。
- すべてのリポジトリ(プライベートのものも含む)へのグローバルアクセスを許可する
- GitHub App専用の機能であるPRプレビューが動作しない
- トークンの有効期間が長い(90日、1年、または無期限)ため、漏えいすると危険
セキュリティポリシーでGitHub Appが禁止されていて、回避手段がない組織のリポジトリを扱う場合に限り、PATを使ってください。
Coolifyでソースを保存すると、接続済みリポジトリの一覧とともにGitHub Appがダッシュボードに表示されます。新しいアプリケーションを作成するときは、一覧からワンクリックで選べます。
Claude CodeからNext.jsプロジェクトを6ステップでデプロイする方法
重要なポイント
Claude Codeの初期状態からサイト公開までの流れは次のとおりです。1) 空のフォルダーでclaudeを実行し、プロジェクトを説明するとClaudeがコードを生成する。2) git init && git remote addを実行する(Claudeがスラッシュコマンドで実行することもできます)。3) GitHubにpushする。4) Coolifyで「+ New Resource → Application」を選び、リポジトリを選択する。5) 環境変数を追加する。6) Deployする。CoolifyはNext.jsだと検出してNixpacksビルドパックを選び、3〜5分でDockerイメージをビルドし、一時ドメインを用意します。
手順1. 空のフォルダーでClaude Codeにプロジェクトを説明します。
mkdir my-vibe-app
cd my-vibe-app
git init
claude
セッションで次のように入力します。
Build a Next.js 14 app router project:
- a home page with a list of users
- /api/users endpoint returns an array from the database
- Postgres via Prisma
- Tailwind for styles
- .env.example with DATABASE_URL
- README.md with instructions for running the project
Claudeはファイル構成、package.json、prisma/schema.prisma、.env.exampleを生成します。次のようにも依頼してください。
Create a Dockerfile for production builds and a .dockerignore.
これは任意です。DockerfileがなくてもCoolifyはNixpacksでビルドできます。ただし、Dockerfileを用意すると処理を制御でき、大規模なプロジェクトでは高速になります。
手順2. GitHubリポジトリを作成してpushします。
GitHub UIから手動で作成してgit remote add origin ...を実行することもできますが、Claude Codeに任せることもできます。
/commit-push-pr Initial Next.js app generated with Claude Code
または、「すべてコミットして、私のアカウントにmy-vibe-appという新しいリポジトリを作ってpushして」と伝えてください。Claudeはgh CLIを使ってプライベート(またはパブリック)リポジトリを作成し、最初のpushを行います。出典:Claude Codeの公式コマンド。
手順3. CoolifyでApplicationを作成します。
Coolifyのダッシュボードで+ New → Applicationをクリックします。フォームが表示されます。
- Source — 前のH2で接続したGitHub Appである
github-mainを選択します。 - Repository — 一覧から
my-vibe-appを選択します。 - Branch —
main - Build Pack — Coolifyが自動で判定します。Dockerfileがあれば
dockerfileを使い、なければnixpacksを使います。手動で上書きできます。 - Domain — ひとまず提案された値をそのまま使います。一時的なものなので、後で独自のものに置き換えます。
- Port — Next.jsのデフォルトである
3000
保存します。
手順4. 環境変数を追加します。
作成したアプリケーションでEnvironment Variablesタブを開きます。変数を1つずつ追加します。
DATABASE_URL=postgresql://user:pass@db-host:5432/mydb
NODE_ENV=production
ANTHROPIC_API_KEY=sk-ant-...
データベースがない場合は、Coolifyで直接作成します。+ New → Database → PostgreSQLに進んでください。Coolifyは30秒でPostgresコンテナを起動し、postgresql://postgres@postgres-xyz:5432/postgres形式の内部DATABASE_URLを表示します。これをアプリケーションに設定します。
すべての変数はCoolifyのデータベース内で暗号化され、ビルドログには表示されません。
手順5. Deployをクリックします。
右上に青色のDeployボタンがあります。Logsタブにライブログが表示されます。
[stage: clone] Cloning '<repository-url-from-github>'
[stage: build] Detected Next.js, using Nixpacks
[stage: build] Installing Node 20, npm 10
[stage: build] npm install (245s)
[stage: build] npm run build (87s)
[stage: deploy] Creating container my-vibe-app-xyz
[stage: deploy] Container started, health check passed
[stage: proxy] Traefik routing configured for <TEMP_DOMAIN>
[stage: ssl] Let's Encrypt cert issued for <TEMP_DOMAIN>
最初のビルドには3〜5分かかります(Nodeのベースイメージを取得して依存関係をインストールするため)。以降のビルドはDockerレイヤーキャッシュのおかげで60〜90秒です。
Runningになったら、CoolifyのDomainsに表示されたアプリURLをコピーし、正確なURLを開きます。以下の<app-url-from-coolify>にはその値を使います。山括弧の表記はプレースホルダーで、実在のアドレスではありません。HTTPSも最初から有効で、ホームページが表示されるはずです。無料のワイルドカードDNSサービスは、IPアドレスを含む任意のサブドメインを名前解決します。Coolifyは一時ドメインにこれを使うので、独自のDNSを設定しなくてもすぐにサイトを開けます。
手順6. すべて動作するか確認します。
上のアプリURLに/api/usersを付けて開きます。例は<app-url-from-coolify>/api/usersで、スラッシュを重複させません。これが手順1のJSONエンドポイントで、ルートURLはホームページです。500エラーが出たら、Logsタブでスタックトレースを確認できます。初回デプロイで最もよくある問題は、DATABASE_URLが存在しないデータベースを指していることです。CoolifyでPostgreSQLインスタンスを作成し(上の手順4を参照)、DATABASE_URLを置き換えてください。
VPSを注文した時点から15分です。元の例では、新規サーバーでこの流れに12〜18分かかりました。
独自ドメインとHTTPSの設定方法
重要なポイント
独自ドメインは3ステップで接続できます。DNS AレコードでサーバーのIPを指定し、Coolifyの設定で一時ドメインの代わりに独自ドメインを入力し、Automatic HTTPSを有効にしてRedeployをクリックします。DNSの反映後、Let's Encryptが2〜3分でSSL証明書を自動発行します(通常5〜30分)。重要なのは、Redeployをクリックする時点ですでにDNSが名前解決できることです。そうでないとLet's Encryptの検証に失敗し、次の試行まで12分待つことになります。
手順1. ドメイン登録業者のコントロールパネルでDNS Aレコードを作成します。
元の例では、Reg.ru、Beget、Timewebでホストされているドメインを使っています。手順は同じです。
| レコード種別 | 名前 | 値 |
|---|---|---|
| A | app(ルートドメインの場合は@) | 1.2.3.4(サーバーのIP) |
保存してコンソールを開き、確認します。
dig app.example.com +short
# 1.2.3.4 が返るはずです
何も返らないか、異なるIPが返る場合は、まだDNSが反映されていません。5〜30分待ってください。
手順2. Coolifyにドメインを入力します。
アプリケーションでConfiguration → Generalタブを開きます。Domainsで、Coolifyからコピーした一時アプリURLを、自分で設定したドメインのhttps://app.example.comに置き換えます。Automatic HTTPSを有効にします(通常はデフォルトで有効です)。
保存してRedeployをクリックします。
手順3. Let's Encrypt証明書を待ちます。
ビルドログに次のように表示されます。
[stage: ssl] Requesting Let's Encrypt cert for app.example.com
[stage: ssl] HTTP challenge sent to /.well-known/acme-challenge/xxx
[stage: ssl] Validation passed, cert issued
[stage: ssl] Cert installed, HTTPS enabled
2〜3分後、アドレスバーに緑色の鍵マークが表示された状態で、https://app.example.comからサイトにアクセスできます。
Let's Encryptで起きる可能性がある問題(公式トラブルシューティングガイドによる上位3項目):
- ファイアウォールでポート80が閉じている。 Let's EncryptはHTTPチャレンジで検証します。
http://app.example.com/.well-known/acme-challenge/xxxにリクエストを送るため、ポート80が閉じていると検証できません。プロバイダーのファイアウォールで開いてください。 - Cloudflareのプロキシが有効(オレンジ色の雲)。 Let's Encryptのリクエストを横取りして独自のプレースホルダーページを返すため、検証に失敗します。「DNS only」(灰色の雲)に切り替えるか、Cloudflare API経由でDNS-01チャレンジを設定してください。
- DNSがまだ反映されていない。 Aレコードを作成して30秒後にすぐRedeployをクリックしても、Let's Encryptはドメインを認識できません。サーバー間でDNSが伝播するまで5〜30分待ってください。
Let's Encryptのレート制限は、1ドメインにつき1時間に失敗5回で、12分ごとに1回分回復します。上限に達した場合、Redeployを続けて10回クリックしないでください。ログを確認し、問題を修正して、12分後に再試行してください。
Claude Code MCP 設定 JSONでCoolifyに接続する方法
重要なポイント
Model Context Protocol経由でClaude CodeからCoolify APIに直接アクセスできるため、「このアプリケーションをデプロイして」と伝えてビルドを開始したり、ステータスを確認したり、ログを読んだり、環境変数を更新したりできます。選択肢は3つです。forsonny/Coolify-MCP-Server(基本機能、7カテゴリの操作)、dazeb/coolify-mcp-enhanced(15以上の追加ツールとワンクリックのデータベースデプロイ)、ajmcclary/Coolify-Manager(公式CLIを使ったClaude Skill)です。v4.1.0(2026年5月18日)からはCoolifyがサードパーティーサーバー不要のネイティブMCPエンドポイントを提供していますが、現時点では読み取り専用です。
Model Context Protocol(MCP)は、Claude Codeが外部システムと通信するためのAnthropicの標準規格です(詳しくはMCPサーバーのガイドを参照)。MCPサーバーを接続すると、Claudeが呼び出せる一連のツールが使えるようになります。Coolify向けの既製サーバーが3つあり、ネイティブの選択肢も1つあります。
選択肢1. forsonny/Coolify-MCP-Server-for-Claude-Code — 基本機能。
できること:
- Applications: 作成、起動、停止、再起動
- Services: 一覧表示、作成、起動/停止/再起動
- Deployments: 実行中のデプロイを表示、UUIDで取得
- Teams & Members: 一覧表示、情報の取得
- SSH Keys: 一覧表示、作成
- Environment Variables: アプリとサービスの変数をすべて作成・読み取り・更新・削除
- Server Insights: サーバーごとのドメイン、健全性、バージョン
インストール:
git clone '<OFFICIAL_URL>'
cd Coolify-MCP-Server-for-Claude-Code
npm install
npm run build
# In .env:
# COOLIFY_BASE_URL=https://coolify.example.com
# COOLIFY_API_TOKEN=[Coolify Settings → API Tokens から取得]
npm run setup # automatically configures Claude Code
その後、Claude Codeで次のように入力できます。
Show the status of the my-vibe-app application in Coolify and the 3 latest deployments.
Claudeが表を返します。
選択肢2. dazeb/coolify-mcp-enhanced — 拡張版(推奨)。
基本セットに追加される機能:
- PostgreSQL / Redis / MinIOのワンクリックデプロイ — 「Postgresをセットアップして」と頼むと、AIがコンテナを作成しDATABASE_URLを返します。
- リアルタイム監視 + リソース使用量 — アプリケーションごとのCPU/RAMをリアルタイムで表示
- 複数の環境設定を一括更新 — 1つのコマンドで20個の変数を更新
- Docker Compose対応 — 複数サービスのアプリケーションをデプロイ
Claude Codeの設定(プロジェクトルートの.mcp.json):
{
"mcpServers": {
"coolify-enhanced": {
"command": "node",
"args": ["/path/to/coolify-mcp-enhanced/dist/index.js"],
"env": {
"COOLIFY_ACCESS_TOKEN": "your-token-here",
"COOLIFY_BASE_URL": "https://coolify.example.com"
}
}
}
}
選択肢3. ajmcclary/Coolify-Manager — CLIを使ったClaude Skill。
MCPサーバーではなく、公式Coolify CLIをラップするClaude Code Skillです。次の機能が含まれます。
- サービスとコンテナの健全性診断
- SSL証明書の診断
- 複数インスタンスへの対応(Coolifyサーバーを複数持つ場合)
- トラブルシューティングの手順
インストール:Skillをダウンロードし、~/.claude/skills/coolify-manager/に配置します。Claude Codeが認識し、関連タスクで使用を提案します。
選択肢4(2026年5月の新機能)。Coolify v4.1.0のネイティブMCP。
2026年5月18日付のv4.1.0変更履歴には、次のように記載されています。
CoolifyのリソースとAPI/UI用の読み取り専用ツールを備えた、インスタンス単位のMCPサポートを追加。
Coolifyが独自のMCPエンドポイントを提供するため、サードパーティーサーバーを使わずClaude Codeを直接接続できます。現時点では読み取り専用(アプリケーション一覧、ステータス、設定)で、変更操作には対応していません。ただし、「インフラについて教えて」といった多くのタスクには十分です。
.mcp.jsonで接続します。
{
"mcpServers": {
"coolify-native": {
"url": "https://coolify.example.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer <your-api-token>"
}
}
}
}
ネイティブMCPで書き込みが可能になるのはv4.2またはv4.3まで待ちましょう。Coolifyチームは2026年末までの提供を約束しています。
初回デプロイでよくある5つの落とし穴とその回避方法
重要なポイント
初回デプロイでよくあるエラーは、RAM不足、ポート80が閉じている、CloudflareのプロキシがLet's Encryptの検証を妨げる、UFWがDockerを保護できない、PATをGitHub Appの代わりに選ぶ、の5つです。すべて公式ドキュメントに記載されていますが、実際に経験がないと遭遇しやすい問題です。以下は、Coolifyを初めてインストールした際の実体験に基づく5項目のチェックリストです。
落とし穴1:RAMが2 GB未満だと、OOMでインストールに失敗する。
症状:curl install.shがdocker pull coolify/coolifyまで進み、70%で止まった後、Killed (signal 9)でプロセスが終了します。dmesg | tailのログにはOut of memory: Killed processと表示されます。
対処法:
# 4 GBのスワップファイルを作成して、一時的に問題を解決する
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
長期的にはRAMを4 GBに増やしてください。Coolifyはスワップを使って動作しますが、大規模なNext.jsプロジェクトのビルドには失敗することがあります。
落とし穴2:UFWを有効にしても、Dockerがポートを開放する。
症状:UFWを有効にし、22以外のポートをすべて閉じたのに、インターネットからアプリケーションのランダムなポート(3000など)にアクセスできます。
公式ドキュメントによる理由:
CoolifyはDocker上で動作します。DockerはNATベースのiptablesルールを使用し、UFWなど従来のLinuxファイアウォールを迂回することがあります。
対処法:UFWではなく、プロバイダーのコントロールパネルにあるファイアウォールを使います。Timeweb / Selectel / Aezaでは「Firewall」または「Network → Firewall」から仮想ネットワークレベルのルールを設定します。これらはパケットがDockerに届く前に適用されます。
別の方法として、Dockerとの互換性を得るためにUFWへパッチを適用するスクリプトufw-dockerがあります。ただし、コントロールパネルでクリックして設定するより複雑です。
落とし穴3:Cloudflareのプロキシ(オレンジ色の雲)がLet's Encryptを妨げる。
症状:Redeploy後、ログにLet's Encrypt validation failed - challenge returned 403と表示されます。
理由:CloudflareがLet's EncryptのHTTPリクエストをプロキシし、チャレンジファイルの代わりに独自のページを返します。
対処法は次の2つです。
- 「DNS only」(Cloudflareの灰色の雲)に切り替える。 欠点は、Cloudflare CDNと保護機能が使えなくなることです。
- Cloudflare API経由でDNS-01チャレンジを設定する。 CoolifyでSettings → SSL Configurationに進み、Cloudflareプロバイダーを選択します。Zone:ReadおよびDNS:Edit権限を持つAPIトークンを入力してください。Let's EncryptはHTTPではなくTXTレコードで検証します。
2つ目の方法は設定が複雑ですが、Cloudflareのプロキシを維持できます。
落とし穴4:GitHub AppではなくPATを使うと、PRプレビューが動作しない。
症状:Personal Access TokenでGitHubを接続すると、ほかはすべて動作するのに、PR用のプレビュー環境が作成されません。GitHubでPRを開いてもCoolifyに何も表示されません。
理由:PRプレビューはGitHub App専用の機能です。PATはWebhook経由でpull_requestイベントを受け取りません。
対処法:Appを使ってGitHubに再接続します。Sources → Add → GitHub Appに進み、ウィザードを完了してください。古いPATソースは削除できます。
落とし穴5:「Coolify = Vercel」とは言い切れない。
Coolifyが標準でできないこと:
| 機能 | Coolify | 対応方法 |
|---|---|---|
| グローバルCDN | なし | Cloudflareを前段に配置(静的コンテンツなら無料) |
| Incremental Static Regeneration | なし | revalidatePathは自分のサーバーでのみ動作 |
| 画像最適化 | なし | ローカルローダーまたはCloudflare Imagesでnext/imageを使う |
| ピーク時の自動スケーリング | なし | 手動でスケールし、VPSをアップグレードする |
| Edge Functions | なし | 通常のAPIルートを使う |
プロジェクトが世界中にユーザーを持ち、世界全体で< 100 msの遅延を求める高トラフィックのSaaSなら、Coolifyは適していません。Vercel Enterpriseを選んでください。1日100〜1,000人のユーザーでMVPをテストしているVibeコーダーなら、Coolifyですべて対応できます。
率直なセルフホスト分析より:
この記事のタイトルにある15分は、初めて1つのプロジェクトをデプロイする場合の最短ルートを指します。監視、バックアップ、アラートを備えたインフラ全体の設定には、1〜2晩かかります。現実的に考えてください。
Vercelと比べて1年間でいくら節約できる?
重要なポイント
初期設定には5〜10時間、メンテナンスには毎月1〜2時間かかる場合があります。
以下のVercel金額は2026年5月のシナリオ見積もりで、現在の提示価格ではなく比較の片側です。自前Coolifyはライセンス料がなくても、VPS、バックアップ、保存、通信、運用には費用がかかります。上の要件を満たす実際の見積もりを取得してください。VPSの数値価格がないため、固定額の節約は主張できません。
CをVPS、バックアップ保存、追加通信、監視、有料管理画面を含む月額インフラ費、rを同じ通貨の運用時間単価とします。重複して数えません。記事の作業見積もりは初期5〜10時間と月1〜2時間で、初年度17〜34時間、翌年以降12〜24時間です。
| シナリオ | Vercel見積もり/月 | Vercel/年 | Coolifyインフラ/月 | Coolify初年度TCO | 初年度の差額 |
|---|---|---|---|---|---|
| 月100,000訪問の試作1つ | $20 + 約$5 = $25 | $300 | C | 12C + (17〜34)r | $300 − 12C − (17〜34)r |
| VPS1台で5プロジェクト | $20 + $30帯域・機能 = $50 | $600 | C | 12C + (17〜34)r | $600 − 12C − (17〜34)r |
| 開発者3人、5プロジェクト | $60席 + $30帯域 = $90 | $1,080 | C | 12C + (17〜34)r | $1,080 − 12C − (17〜34)r |
サーバー規模が違うなら各シナリオに別のCを使います。初年度の月額換算はC + (17〜34)r/12、翌年以降の年額TCOは12C + (12〜24)rです。Vercel側にも同等の運用費を加えてください。差額が負なら自前のほうが高くなります。rに人件費が入るなら同じ担当者の給与を再加算しません。
切り替え前に実際の提供者の見積もりとバックアップ計画でCを埋め、rを決め、1か月の利用を比較します。未入力なら、示せるのは費用モデルで、金額の節約ではありません。
最大の利点は金額ではありません。Coolifyに移行すると、「他社の支払いポリシーに依存する」という区分がなくなります。20%の手数料がかかるバーチャル中継カードも必要ありません。
Coolifyは安価なVercelではありません。異なるカテゴリーの製品です。インフラを自分で所有し、その責任を引き受け、複雑さを受け入れることで費用を節約します。
Claude Codeで生成した後、プロトタイプをデプロイすることが最初のタスクなら、環境(env、秘密情報、スケジュールタスク、バックアップ)の管理はコンテキストエンジニアリングの一部です。「すべてがどこにあるか」の構造がなければClaudeは迷い、変更のたびに時間を失います。完全なセットアップには、AIクローン(自分の方法論に合わせたSkillsとSubagents)+ セカンドブレイン(プロジェクトのナレッジベース)+ コンテキストエンジニアリング(Plan Mode、/compact、実行環境)が含まれます。これらはAIの幻覚を防ぐ3つの柱です。
出典
完全なコンテキストワークフロー:AIクローン + セカンドブレイン + コンテキストエンジニアリング。
詳しい資料はAilootでご覧いただけます。
詳細を見る
Claude Code MCP 設定 どこに書く?Coolify連携とVPSデプロイ:よくある質問
デプロイ後、どのURLがJSONを返しますか?
CoolifyのDomainsに表示されたアプリURLをコピーし、/api/usersを開きます。ルートはホームページで、例のJSONエンドポイントは/api/usersです。
自前ホストの節約はどう計算しますか?
VPS、バックアップ、ストレージ、通信、監視、任意の管理画面料金を月額Cへまとめます。初年度TCOは12Cと17〜34時間の人件費の合計です。例のVercel年額と比較し、双方で同等の運用費も含めてください。