Skill AppDeploy

Implante aplicativos web no AppDeploy via API HTTP.

Quando Usar Esta Skill

• Use ao planejar ou construir aplicativos e aplicativos web
• Use ao implantar um aplicativo em um URL público
• Use ao publicar um site ou aplicativo web
• Use quando o usuário disser "implantar isso", "tornar isso público" ou "me dê um URL"
• Use ao atualizar um aplicativo já implantado

Configuração (Apenas Primeira Vez)

1. Verifique se há chave de API existente:

   • Procure por um arquivo .appdeploy na raiz do projeto
   • Se existir e contiver uma api_key válida, pule para Uso

2. Se não houver chave de API, registre-se e obtenha uma:

   curl -X POST https://api-v2.appdeploy.ai/mcp/api-key \
     -H "Content-Type: application/json" \
     -d '{"client_name": "claude-code"}'
   

   Resposta:

   {
     "api_key": "ak_...",
     "user_id": "agent-claude-code-a1b2c3d4",
     "created_at": 1234567890,
     "message": "Save this key securely - it cannot be retrieved later"
   }
   

3. Salve as credenciais em .appdeploy:

   {
     "api_key": "ak_...",
     "endpoint": "https://api-v2.appdeploy.ai/mcp"
   }
   

   Adicione .appdeploy a .gitignore se ainda não estiver presente.

Uso

Faça chamadas JSON-RPC para o endpoint MCP:

curl -X POST {endpoint} \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "{tool_name}",
      "arguments": { ... }
    }
  }'

Fluxo de Trabalho

1. Primeiro, obtenha as instruções de implantação: Chame get_deploy_instructions para entender as restrições e requisitos.

2. Obtenha o modelo do aplicativo: Chame get_app_template com seu app_type e frontend_template escolhidos.

3. Implante o aplicativo: Chame deploy_app com seus arquivos de aplicativo. Para novos aplicativos, defina app_id como null.

4. Verifique o status da implantação: Chame get_app_status para verificar se a compilação foi bem-sucedida.

5. Visualize/gerencie seus aplicativos: Use get_apps para listar seus aplicativos implantados.

Ferramentas Disponíveis

get_deploy_instructions

Use esta ferramenta quando estiver prestes a chamar deploy_app para obter as restrições e regras rígidas de implantação. Você deve chamar esta ferramenta antes de começar a gerar qualquer código. Esta ferramenta retorna apenas instruções e não implanta nada.

Parâmetros:

deploy_app

Use esta ferramenta quando o usuário pedir para implantar ou publicar um site ou aplicativo web e quiser um URL público. Antes de gerar arquivos ou chamar esta ferramenta, você deve chamar get_deploy_instructions e seguir suas restrições.

Parâmetros:

• app_id: qualquer (obrigatório) - ID do aplicativo existente para atualizar, ou nulo para novo aplicativo
• app_type: string (obrigatório) - arquitetura do aplicativo: apenas frontend ou frontend+backend
• app_name: string (obrigatório) - nome de exibição curto
• description: string (opcional) - descrição curta do que o aplicativo faz
• frontend_template: qualquer (opcional) - OBRIGATÓRIO quando app_id é nulo. Um dos seguintes: 'html-static' (sites simples), 'react-vite' (SPAs, jogos), 'nextjs-static' (múltiplas páginas). Arquivos de modelo incluídos automaticamente.
• files: array (opcional) - Arquivos para escrever. NOVOS APLICATIVOS: apenas arquivos personalizados + diferenças para arquivos de modelo. ATUALIZAÇÕES: apenas arquivos alterados usando diferenças[]. Pelo menos um de files[] ou deletePaths[] é necessário.
• deletePaths: array (opcional) - Caminhos para excluir. APENAS para atualizações (app_id obrigatório). Não é possível excluir package.json ou pontos de entrada do framework.
• model: string (obrigatório) - O modelo do agente de codificação usado para esta implantação, até onde você sabe. Exemplos: 'codex-5.3', 'chatgpt', 'opus 4.6', 'claude-sonnet-4-5', 'gemini-2.5-pro'
• intent: string (obrigatório) - A intenção desta implantação. Exemplos iniciados pelo usuário: 'implantação inicial do aplicativo', 'correção de bug - interface do usuário está muito barulhenta'. Exemplos iniciados pelo agente: 'agente corrigindo erro de implantação', 'agente tentando novamente após falha de lint'

get_app_template

Chame get_deploy_instructions primeiro. Em seguida, chame esta ferramenta depois de decidir app_type e frontend_template. Retorna o modelo base do aplicativo e os tipos de SDK. Arquivos de modelo incluídos automaticamente em deploy_app.

Parâmetros:

• app_type: string (obrigatório)
• frontend_template: string (obrigatório) - Framework frontend: 'html-static' - Sites simples, framework mínimo; 'react-vite' - SPAs React, dashboards, jogos; 'nextjs-static' - Aplicativos de várias páginas, SSG

get_app_status

…