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.

GitHub

O que você pode fazer com SnapDeploy MCP?

Fazer deploy pelo GitHub — Peça para fazer deploy de um repositório do GitHub conectado e receba uma URL ao vivo via deploy.
Gerenciar variáveis de ambiente — Defina ou atualize variáveis de ambiente de um app sem expor valores secretos, usando with e set_env.
Monitorar deploys — Verifique o status do deploy, visualize logs e liste deploys recentes com get_status, get_logs e get_deployments.
Controlar contêineres — Inicie, pare ou ative um contêiner sob demanda usando start_container, stop_container e wake_container.
Provisionar recursos — Crie um banco de dados gerenciado ou anexe um domínio personalizado a um app com create_database e add_domain.

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 ao vivo 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` `deploy_image` `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 qualquer token — essas ações exigem uma pessoa conectada ao painel ou ao aplicativo móvel.

Imagens pré-construídas. deploy cria a partir de um repositório GitHub conectado; não há ferramenta de imagem. Para executar uma imagem Docker pública, use o painel (Implantar Seu Aplicativo → Imagem Docker) ou POST /api/mobile/containers com name, image, imageTag, port e depois POST /api/mobile/containers/{containerId}/start. As imagens devem vir de Docker Hub, ghcr.io, quay.io ou public.ecr.aws, publicar linux/amd64 ou linux/arm64 e passar na verificação de política de criação do SnapDeploy; um 400 Security policy violation é definitivo e não deve ser repetido. Regras completas: https://snapdeploy.dev/llms-full.md

Modelo de segurança

Nada destrutivo, nunca. 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`