Netlify MCPサーバーの使い方 — Claude Codeからのデプロイ手順

Netlifyは、コードエージェントがNetlifyのAPIとCLIを自然言語の指示で操作できるMCPサーバーを公式提供しています。プロジェクトの作成・デプロイ・環境変数の管理・アクセス制御の変更までを、Claude Codeのセッションを離れずに任せられます。サーバーはリモート版とローカル版の2種類あり、Claude Codeへの接続はどちらもコマンド1行で終わります。

Netlify MCPサーバーとは — リモート版とローカル版の違い

Netlify MCPサーバーは、Netlify公式が配布するMCP実装です。Netlifyの案内では、常に最新のMCP機能を使えるリモート版が推奨されています。ローカル版が要るのは、リモートのMCPサーバーへの接続がブロックされている環境などに限られます。

対応クライアントにはClaude Code・Claude Web(Netlifyコネクタ経由)・Claude Desktop(同)・Codex・ChatGPT(Netlify App経由)・Windsurf・Cursor・Cline・Warp・LM Studioなどが並びます。

Claude Codeで接続する手順

Claude Codeだけに絞って追加するなら、claude mcp addでリモート版を直接指定します。

claude mcp add --transport http netlify https://netlify-mcp.netlify.app/mcp

複数のエージェントをまとめて設定したい場合は、Netlifyの汎用インストーラーも使えます。実行すると、設定したいエージェントをプロンプトで選びます。

npx -y add-mcp https://netlify-mcp.netlify.app/mcp

.mcp.jsonに書き込まれる中身

claude mcp addは既定ではローカルスコープに保存しますが、--scope projectを付けるとプロジェクト直下の.mcp.jsonに書き込みます。v2.1.287でリモート版を登録すると、typeとurlだけの短い設定が書き込まれます。

{
  "mcpServers": {
    "netlify": {
      "type": "http",
      "url": "https://netlify-mcp.netlify.app/mcp"
    }
  }
}

ローカル版をclaude mcp add --scope project netlify -- npx -y @netlify/mcpで登録すると、typeがstdioになり、commandとargs、空のenvが入ります。

{
  "mcpServers": {
    "netlify": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@netlify/mcp"],
      "env": {}
    }
  }
}

READMEにあるクライアント向けの設定(commandとargsだけのJSON)に比べて、typeとenvが自動で補われている点が違いです。Claude Code以外のクライアントでは、READMEのJSONをそのままMCP設定ファイルに貼り込みます。

claude mcp addのスコープ(ローカル・プロジェクト・ユーザー)の使い分けはClaude Code MCP設定ガイドにまとめています。.mcp.jsonはプロジェクトのルートに置き、バージョン管理に入れてチームで共有する前提のファイルです。このあと触れるPATをenvに入れる場合は、この共有前提がそのまま漏えい経路になります。

前提条件 — Nodeのバージョンはページごとに違う

Netlify MCPサーバーの動作には、NetlifyアカウントとMCPクライアントが必要です。Nodeの要件は、2つのページで数字が食い違っています。

• GitHubのREADME: Node.js 22以上
• Claude Code向けセットアップガイド: Node 24以上を推奨(nvm install 24とnvm use 24)

Claude Codeで使うなら、新しいほうの24以上に合わせておけば両方の要件を満たします。nvmを使っていれば切り替えは1行で済みます。

READMEには、Netlify CLIをグローバルインストールしておくと最良の体験になるとあります。

npm install -g netlify-cli

Claude Code以外のクライアントでの接続方法

同じ「Netlifyにつなぐ」操作でも、クライアントによって入口が3種類に分かれます。

Claude Webでは、チャット画面のCustomizeからConnectorsを開き、Netlifyを検索してConnectを選びます。Claude DesktopではSettingsのConnectorsでAddを選び、Netlifyを探してConnectします。組織で一括導入するなら、管理者がOrganization Settings > ConnectorsでNetlifyを選び、Add to your teamを押します。

コネクタ側には、ツールの権限を分ける設定があります。Netlifyが推奨しているのは、読み取り専用ツールとその他のツールを「Always allow」、書き込み・削除ツールを承認制(管理者画面では「Ask」)にする組み合わせです。Claude Webのコネクタは、必要になったときにNetlifyのツールを読み込むので、コネクタ名を指定せずに「このプロジェクトをNetlifyにデプロイして」と頼めます。

Claude Codeでも、ツール単位で許可を絞れます。書き方はClaude Code MCP権限ルールで扱っています。

MCP経由でできること

READMEが挙げる用途は次の6つで、いずれもNetlify APIとCLIの範囲に対応します。

• プロジェクトの作成・管理・デプロイ
• アクセス制御の変更によるプロジェクトの保護
• Netlify拡張機能のインストールとアンインストール
• ユーザー・チーム情報の取得
• フォーム送信の有効化と管理
• 環境変数・シークレットの作成と管理

これらは自然言語の指示から呼び出せます。Netlifyのドキュメントが示す試し方は、「Add a new contact page to my site using Netlify Forms with spam protection」「Convert this Express endpoint into a Netlify Function」のように、使いたい機能名を入れた依頼文です。

デプロイの種類 — まず下書きで試す

Claude Code向けガイドは、最初のデプロイを頼む前に、どの種類で出すかを決めておくよう勧めています。CLIでの対応は次のとおりです。

「本番に反映して」と頼む前に、下書きの結果をURLで確かめる流れにしておくと、権限や環境変数の不備を本番に持ち込まずに済みます。

認証でつまずいたときの切り分け順

Netlify MCPサーバーは通常、初回接続時に認証を求めます。うまく進まないときの手段は次の5つです。1〜4はClaude Code向けガイドのトラブルシューティングにあり、5はREADMEの手段です。並びは、手軽なものから順に試せるようにした順序です。

1. 会社でNetlifyのSSOが有効なら、別の仕事用ログインや個人のIDで入り直す必要がないか確かめる
2. Claude Codeにログインを手伝わせるか、ターミナルでnetlify loginを実行して、正しいアカウントにつながっているかを確かめる
3. netlify statusでNetlify CLIが入っているかを見る
4. プロジェクトに機密情報がなければ、匿名デプロイを試して認証の問題とデプロイの問題を切り分ける
5. それでも通らないときだけ、Personal Access Tokenを一時的に使う

5番のPATは、READMEが「認証で困ったとき、一時的にMCP設定へ追加できる」と案内する手段です。

{
  "mcpServers": {
    "netlify-mcp": {
      "command": "npx",
      "args": ["-y", "@netlify/mcp"],
      "env": {
        "NETLIFY_PERSONAL_ACCESS_TOKEN": "YOUR-PAT-VALUE"
      }
    }
  }
}

PATはNetlifyダッシュボードのユーザーアイコンからUser settings → OAuth → New access tokenで発行し、設定に入れたらMCPクライアントを再起動(または更新)します。

Claude Codeでは、サーバー名の後ろに-eを置いて同じ設定を作れます。-eの直後にサーバー名を置くと、名前が環境変数として読まれ、v2.1.287ではInvalid environment variable format: netlifyと拒否されます。

claude mcp add --scope project netlify -e NETLIFY_PERSONAL_ACCESS_TOKEN=YOUR-PAT-VALUE -- npx -y @netlify/mcp

--scope projectで作った.mcp.jsonのenvには、トークンの値がそのまま平文で書かれます。共有前提のファイルなので、--scope projectを付けずにローカルスコープで登録するか、解決したらすぐenvごと消すのが安全です。

エージェントスキルとの併用 — netlify.aiとcontext-and-tools

Netlifyは、MCPサーバーとは別に「エージェントスキル」も配布しています。ベストプラクティスをまとめたコンテキストで、機能ごとに分かれています。

npx skills add netlify/context-and-tools --skill '*' --yes

Claude Codeだけに入れるなら、末尾に--agent claude-codeを付けます。スキルが入らない、古いように見えるときも、Netlifyのガイドのトラブルシューティングではこの形で入れ直すよう案内しています。リポジトリのREADMEの現行のインストール手順はnpx @netlify/skills@latest add --allで、こちらも--agent claude-codeを指定でき、.claude/skills/に書き込まれます。Claude Codeでは/<スキル名>でスキルを個別に呼び出せます。

MCPサーバーがAPIとCLIをツールとして呼び出す役割なのに対し、スキルは機能ごとの実装パターンをコンテキストとして渡す役割です。

スキルは機能単位に分かれています。Netlify Functions・Edge Functions・Netlify Blobs・Image CDN・Netlify Formsのほか、netlify.tomlによるファイルベース設定、Netlify CLI、デプロイ作成、キャッシュ制御があります。Netlify Databaseはマネージド型のPostgresで、Drizzle ORMとの連携を含みます。フレームワークアダプターはVite・Astro・TanStack Start・Next.jsが対象です。netlify-ai-gatewayは、OpenAI・Anthropic・GoogleのAI SDK向けのプロキシにあたります。

個別にインストールしない方法もあります。「https://netlify.aiを取得して、最新のエージェントスキルでNetlifyでのビルドとデプロイを手伝って」と依頼文に書くだけで、同等のコンテキストを渡せます。

まとめ — リモート版から試すのが近道

リモート版をclaude mcp addで登録し、最初の依頼は下書きデプロイにするのが、いちばん事故の少ない入り方です。ローカル版とPATは、リモート接続が使えない環境や認証の切り分けに限った代替手段として覚えておくと迷いません。