SnapDeploy MCP

oficial

Implante e gerencie aplicativos SnapDeploy (contêineres Docker na AWS) a partir do Claude Code, Cursor, Codex ou Gemini CLI: builds, logs, variáveis de ambiente, complementos e domínios.

GitHubExperimente este MCPPatrocinado

O que você pode fazer com SnapDeploy MCP?

Implantar um repositório GitHub — Peça ao seu assistente para implantar um repositório no SnapDeploy e receba uma URL ao vivo por meio da ferramenta deploy.
Gerenciar variáveis de ambiente — Instrua seu assistente a definir ou verificar variáveis de ambiente para um contêiner, com valores mascarados como (set).
Monitorar o status da implantação — Solicite status em tempo real, logs ou histórico de implantação para qualquer contêiner do SnapDeploy.
Controlar o ciclo de vida do contêiner — Inicie, pare ou ative um contêiner sob demanda sem sair da sua interface de chat.
Provisionar recursos — Crie bancos de dados gerenciados ou atribua domínios personalizados às suas implantações diretamente da conversa.

Documentação

@snapdeploy/mcp

Implante e gerencie contêineres SnapDeploy a partir do seu assistente de IA — Claude Code, Claude Desktop, Cursor, Windsurf, Codex CLI, Gemini CLI ou qualquer cliente que fale o Model Context Protocol via stdio.

Diga "implante este repositório no SnapDeploy" e receba uma URL ativa de volta. Builds, logs, variáveis de ambiente, bancos de dados gerenciados e domínios personalizados — sem sair do chat.

Configuração

Entre em snapdeploy.dev, abra API Keys e crie um token com o escopo deploy (a página gera os trechos abaixo com seu token já preenchido).
Adicione o servidor ao seu cliente:

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 e outros clientes configurados via 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" }

Plugin do Claude Code (token armazenado em armazenamento seguro em vez de um arquivo de configuração):

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

Reinicie a sessão; as ferramentas snapdeploy aparecem. Seu repositório deve estar no GitHub e o GitHub deve estar conectado ao SnapDeploy uma vez (o conector retorna o link se não estiver).

Ferramentas

Escopo	Ferramentas
`read`	`list_apps` `get_status` `get_logs` `get_deployments` `check_quota` `list_repos` `detect_env_vars`
`deploy`	`deploy` `set_env` `start_container` `stop_container` `wake_container`
`manage`	`create_database` `add_domain` `assign_always_on`

Os escopos são aninhados (read ⊂ deploy ⊂ manage); o servidor os aplica antes de qualquer ferramenta ser executada. Não há ferramenta de exclusão, e o servidor recusa exclusões, cancelamentos de assinatura e alterações de senha para todos os tokens — essas ações exigem uma pessoa conectada ao painel ou ao aplicativo móvel.

Modelo de segurança

Nada destrutivo, jamais. Mesmo um agente que escale para uma chamada de API bruta com o mesmo token recebe 403 INTERACTIVE_SESSION_REQUIRED.
Segredos nunca chegam ao modelo. Os valores das variáveis de ambiente retornam como (set) e as credenciais são mascaradas — no servidor, não apenas neste conector.
Tokens com escopo, expiração e revogação com limite de taxa próprio. Revogue na página de API Keys e toda solicitação retorna 401 a partir desse momento.
Implantações seguras para repetição. Solicitações idênticas em dez minutos retornam a implantação original em vez de iniciar outro build.
Limites do plano são repassados, não repetidos. Respostas 402/429 carregam a mensagem própria do SnapDeploy e o link de upgrade, e o assistente é instruído a não repetir.

Variáveis de ambiente

Variável	Obrigatória	Significado
`SNAPDEPLOY_API_KEY`	sim	Token com escopo (`sd_pat_…`) ou chave de API legada
`SNAPDEPLOY_READ_ONLY`	não	`1` expõe apenas as ferramentas de leitura
`SNAPDEPLOY_BASE_URL`	não	Padrão é `https://snapdeploy.dev`