SnapDeploy MCP

公式

SnapDeployアプリ（AWS上のDockerコンテナ）をClaude Code、Cursor、Codex、またはGemini CLIからデプロイおよび管理：ビルド、ログ、環境変数、アドオン、ドメイン。

GitHubこのMCPを試すスポンサー

SnapDeploy MCPで何ができますか？

  • Deploy a GitHub repository — アシスタントにリポジトリをSnapDeployへデプロイするよう依頼し、deployツール経由でライブURLを受け取ります。
  • Manage environment variables — アシスタントにコンテナの環境変数の設定や確認を指示し、値は(set)としてマスク表示されます。
  • Monitor deployment status — SnapDeployコンテナのリアルタイムのステータス、ログ、またはデプロイ履歴をリクエストします。
  • Control container lifecycle — チャットインターフェースから離れることなく、コンテナの起動、停止、またはウェイクアップをオンデマンドで実行します。
  • Provision resources — 会話から直接、マネージドデータベースを作成したり、デプロイにカスタムドメインを割り当てたりします。

ドキュメント

@snapdeploy/mcp

AIアシスタントからSnapDeployコンテナをデプロイおよび管理できます — Claude Code、Claude Desktop、Cursor、Windsurf、Codex CLI、Gemini CLI、またはstdioで Model Context Protocolを話す任意のクライアントに対応しています。

"このリポジトリをSnapDeployにデプロイして" と言うだけで、ライブURLが返ってきます。ビルド、ログ、環境変数、マネージドデータベース、カスタムドメイン — チャットから離れることなくすべてを管理できます。

セットアップ

  1. snapdeploy.devにサインインし、API Keysを開いて deployスコープを持つトークンを作成します（ページがあなたのトークンを あらかじめ入力したスニペットを生成します）。
  2. サーバーをクライアントに追加します：

Claude Code

claude mcp add --scope user snapdeploy -e SNAPDEPLOY_API_KEY=sd_pat_your_token -- npx -y @snapdeploy/mcp

Cursor（~/.cursor/mcp.json）、Windsurf（~/.codeium/windsurf/mcp_config.json）、 Gemini CLI（~/.gemini/settings.json）、Claude Desktopおよびその他のJSON設定クライアント：

{
  "mcpServers": {
    "snapdeploy": {
      "command": "npx",
      "args": ["-y", "@snapdeploy/mcp"],
      "env": { "SNAPDEPLOY_API_KEY": "sd_pat_your_token" }
    }
  }
}

Codex CLI（~/.codex/config.toml）：

[mcp_servers.snapdeploy]
command = "npx"
args = ["-y", "@snapdeploy/mcp"]
env = { SNAPDEPLOY_API_KEY = "sd_pat_your_token" }

Claude Codeプラグイン（トークンを設定ファイルではなくセキュアストレージに保存）：

/plugin marketplace add AAR-Labs/snapdeploy-mcp
/plugin install snapdeploy@snapdeploy

セッションを再起動すると、snapdeployツールが表示されます。リポジトリはGitHub上にあり、 GitHubがSnapDeployに一度接続されている必要があります（接続されていない場合、コネクタがリンクを返します）。

ツール

スコープツール
readlist_apps get_status get_logs get_deployments check_quota list_repos detect_env_vars
deploydeploy set_env start_container stop_container wake_container
managecreate_database add_domain assign_always_on

スコープは入れ子になります（read ⊂ deploy ⊂ manage）。サーバーはツールが実行される前にこれらを強制します。 削除ツールはなく、サーバーはすべてのトークンに対して削除、サブスクリプションのキャンセル、パスワード変更を拒否します — これらはダッシュボードまたはモバイルアプリにサインインした担当者が必要です。

セキュリティモデル

  • 破壊的な操作は一切ありません。 同じトークンで生のAPI呼び出しにエスカレーションするエージェントでも 403 INTERACTIVE_SESSION_REQUIREDを受け取ります。
  • シークレットはモデルに到達しません。 環境変数の値は(set)として返され、 認証情報はマスクされます — このコネクタだけでなく、サーバー上で処理されます。
  • スコープ付き・期限付き・失効可能なトークンで、独自のレート制限があります。API Keysページで失効させると、 その瞬間からすべてのリクエストが401を返します。
  • リトライ安全なデプロイ。 10分以内の同一リクエストは、別のビルドを開始せずに元のデプロイを返します。
  • プラン制限は中継され、リトライされません。 402/429応答にはSnapDeploy自身のメッセージと アップグレードリンクが含まれ、アシスタントにはリトライしないよう指示されます。

環境変数

変数必須意味
SNAPDEPLOY_API_KEYはいスコープ付きトークン（sd_pat_…）またはレガシーAPIキー
SNAPDEPLOY_READ_ONLYいいえ1は読み取りツールのみを公開します
SNAPDEPLOY_BASE_URLいいえデフォルトはhttps://snapdeploy.dev

リンク

MIT © AAR Labs