SnapDeploy MCP

@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 से एक बार कनेक्ट होना चाहिए (कनेक्टर लिंक लौटाता है यदि यह नहीं है)।

उपकरण

स्कोप	उपकरण
read	list_apps get_status get_logs get_deployments check_quota list_repos detect_env_vars
deploy	deploy deploy_image set_env start_container stop_container wake_container
manage	create_database add_domain assign_always_on

स्कोप नेस्ट होते हैं (read ⊂ deploy ⊂ manage); सर्वर किसी भी उपकरण के चलने से पहले उन्हें लागू करता है। कोई डिलीट उपकरण नहीं है, और सर्वर हर टोकन के लिए डिलीट, सदस्यता रद्दीकरण और पासवर्ड परिवर्तन से इनकार करता है — उनके लिए डैशबोर्ड या मोबाइल ऐप में साइन इन किए व्यक्ति की आवश्यकता होती है।

पूर्व-निर्मित इमेज। deploy कनेक्टेड GitHub रिपॉजिटरी से बिल्ड करता है; कोई इमेज उपकरण नहीं है। सार्वजनिक Docker इमेज चलाने के लिए, डैशबोर्ड (Deploy Your Application → Docker Image) या POST /api/mobile/containers का उपयोग name, image, imageTag, port, फिर POST /api/mobile/containers/{containerId}/start के साथ करें। इमेज Docker Hub, ghcr.io, quay.io या public.ecr.aws से आनी चाहिए, linux/amd64 या linux/arm64 प्रकाशित करें, और SnapDeploy की निर्माण-समय नीति जांच पास करें; एक 400 Security policy violation अंतिम है और उसे दोबारा प्रयास नहीं करना चाहिए। पूर्ण नियम: https://snapdeploy.dev/llms-full.md

सुरक्षा मॉडल

• कभी भी विनाशकारी नहीं। यहां तक कि एक एजेंट जो उसी टोकन के साथ कच्चे API कॉल पर चढ़ता है, उसे 403 INTERACTIVE_SESSION_REQUIRED मिलता है।
• रहस्य कभी मॉडल तक नहीं पहुंचते। पर्यावरण-चर मान (set) के रूप में वापस आते हैं और क्रेडेंशियल मास्क किए जाते हैं — सर्वर पर, न केवल इस कनेक्टर में।
• स्कोप्ड, समाप्त होने वाले, रद्द करने योग्य टोकन अपनी स्वयं की दर सीमा के साथ। API Keys पृष्ठ पर रद्द करें और उस क्षण से हर अनुरोध 401 लौटाता है।
• रीट्राई-सुरक्षित तैनाती। दस मिनट के भीतर समान अनुरोध मूल तैनाती लौटाते हैं, दूसरा बिल्ड शुरू करने के बजाय।
• योजना सीमाएं रिले की जाती हैं, रीट्राई नहीं। 402/429 उत्तर SnapDeploy का अपना संदेश और अपग्रेड लिंक ले जाते हैं, और सहायक को रीट्राई न करने के लिए कहा जाता है।

पर्यावरण चर

चर	आवश्यक	अर्थ
SNAPDEPLOY_API_KEY	हाँ	स्कोप्ड टोकन (sd_pat_…) या लीगेसी API कुंजी
SNAPDEPLOY_READ_ONLY	नहीं	1 केवल पढ़ने के उपकरण उजागर करता है
SNAPDEPLOY_BASE_URL	नहीं	डिफ़ॉल्ट https://snapdeploy.dev है

लिंक

• गाइड: Claude Code · Cursor · Codex / Gemini CLI · Lovable निर्यात
• संदर्भ: snapdeploy.dev/docs/mcp · API
• डिज़ाइन लेख: क्यों एक एजेंट जो तैनात कर सकता है उसे हटाने में सक्षम नहीं होना चाहिए

MIT © AAR Labs