v2.0.0 online

LetsCloud MCP Server

Servidor remoto Model Context Protocol + API REST para gerenciar a infraestrutura da LetsCloud diretamente a partir de assistentes de IA como Claude, Cursor, Windsurf e qualquer cliente compatível com MCP.

📚 Documentação da API (Swagger)

Explorador interativo da API REST com schemas de requisição e resposta.

📖 ReDoc

Documentação em formato de referência.

🧾 Schema OpenAPI

JSON puro para geração de código e integrações.

💚 Saúde

Endpoint de verificação de disponibilidade.

ℹ️ Informações do serviço (JSON)

Catálogo de endpoints em formato legível por máquinas.

🐙 GitHub

Código-fonte, issues e releases.

🔌 Conecte um cliente MCP

O LetsCloud MCP Server é um servidor MCP remoto, baseado em HTTP. Escolha o seu cliente abaixo e siga o passo a passo. Em todos os casos você precisará da sua chave de API LetsCloud — gere uma no painel LetsCloud (Conta → API).

Snippet genérico de configuração (usado pela maioria dos clientes):

{
  "mcpServers": {
    "letscloud": {
      "url": "https://mcp.letscloud.io/mcp",
      "headers": {
        "Authorization": "Bearer SUA_CHAVE_API_LETSCLOUD"
      }
    }
  }
}

🆚 VS Code (GitHub Copilot Chat — modo Agente)

Requer VS Code 1.102+ com GitHub Copilot Chat. O suporte a MCP já vem habilitado.

Abra a Paleta de Comandos: Ctrl+Shift+P (macOS: ⌘+Shift+P).
Execute MCP: Add Server… → escolha HTTP (server-sent events).
URL do servidor: https://mcp.letscloud.io/mcp
ID / nome do servidor: letscloud
Quando perguntado, escolha User Settings (global) ou Workspace.
Abra o mcp.json gerado e adicione o header Authorization:

{
  "servers": {
    "letscloud": {
      "type": "http",
      "url": "https://mcp.letscloud.io/mcp",
      "headers": {
        "Authorization": "Bearer SUA_CHAVE_API_LETSCLOUD"
      }
    }
  }
}

Abra o Copilot Chat e troque o seletor de modo para Agent.
Clique no ícone 🛠️ tools e confirme que as ferramentas letscloud estão habilitadas.
Teste: "Liste meus servidores LetsCloud."

Dica: você também pode editar .vscode/mcp.json manualmente para compartilhar a configuração com o time.

🤖 Claude Desktop (Anthropic)

Abra o Claude Desktop → Settings → Developer → Edit Config.
Isso abre o arquivo claude_desktop_config.json:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Adicione a entrada letscloud dentro de mcpServers:

{
  "mcpServers": {
    "letscloud": {
      "url": "https://mcp.letscloud.io/mcp",
      "headers": {
        "Authorization": "Bearer SUA_CHAVE_API_LETSCLOUD"
      }
    }
  }
}

Salve e feche e reabra o Claude Desktop completamente.
Em uma nova conversa, clique no ícone 🔌 para confirmar que letscloud está conectado.
Teste: "Mostre o saldo da minha conta LetsCloud."

🖱️ Cursor

Abra o Cursor → Settings → Cursor Settings → MCP (ou edite ~/.cursor/mcp.json).
Clique em + Add new MCP server.
Cole o snippet:

{
  "mcpServers": {
    "letscloud": {
      "url": "https://mcp.letscloud.io/mcp",
      "headers": {
        "Authorization": "Bearer SUA_CHAVE_API_LETSCLOUD"
      }
    }
  }
}

Salve. O indicador ao lado de letscloud deve ficar verde.
Abra o Composer / Chat em modo Agent e teste: "Liste meus snapshots LetsCloud."

🌬️ Windsurf (Codeium)

Abra o Windsurf → Settings → Cascade → MCP servers → Add custom server.
Ou edite ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "letscloud": {
      "serverUrl": "https://mcp.letscloud.io/mcp",
      "headers": {
        "Authorization": "Bearer SUA_CHAVE_API_LETSCLOUD"
      }
    }
  }
}

Clique em Refresh no painel MCP.
Abra o chat do Cascade e teste: "Reinicie o servidor web-prod-01."

🧩 Continue (extensão para VS Code / JetBrains)

Abra o Continue → clique na engrenagem ⚙️ → Open config.
Edite ~/.continue/config.yaml e adicione o servidor MCP:

mcpServers:
  - name: letscloud
    url: https://mcp.letscloud.io/mcp
    headers:
      Authorization: Bearer SUA_CHAVE_API_LETSCLOUD

Salve — o Continue recarrega automaticamente.
No chat, digite @letscloud para invocar qualquer ferramenta.

🧪 Outros clientes MCP / teste rápido (curl)

A maioria dos clientes compatíveis com MCP aceita o snippet genérico do topo. Para validar a conectividade ponta a ponta:

curl -H "Authorization: Bearer SUA_CHAVE_API_LETSCLOUD" \
     https://mcp.letscloud.io/api/v1/account

Você deve receber um JSON com o seu perfil LetsCloud.

⚡ Teste com curl

curl -H "Authorization: Bearer SUA_CHAVE_API_LETSCLOUD" \
     https://mcp.letscloud.io/api/v1/account

🤖 Converse com sua nuvem — exemplos de prompts

Depois de conectado, basta conversar com a IA em português (ou inglês). O assistente escolhe a ferramenta correta, pede confirmação quando necessário e executa a ação na sua conta LetsCloud.

📊 Inventário e cobrança

• "Liste todos os meus servidores LetsCloud e o status de cada um."
• "Quais servidores estão desligados agora?"
• "Mostre meu saldo da conta e o plano atual."

🚀 Provisionamento

• "Crie um VPS Ubuntu 22.04 de 2 GB em Miami chamado web-prod-01."
• "Suba 3 servidores Debian 12 em São Paulo com a minha chave SSH laptop."
• "Quais planos estão disponíveis na região do Brasil?"

⚙️ Operações de ciclo de vida

• "Reinicie o servidor web-prod-01."
• "Desligue todos os servidores cujo nome começa com staging."
• "Resete a senha root do db-01."

💾 Snapshots e backups

• "Tire um snapshot do db-01 chamado pre-upgrade."
• "Liste todos os snapshots com mais de 30 dias."
• "Renomeie o snapshot snap-12 para backup-semanal."

🔑 Chaves SSH

• "Adicione esta chave pública à minha conta como laptop-2026."
• "Quais servidores foram criados com a minha chave laptop?"
• "Remova a chave SSH old-macbook."

🧹 Limpeza e economia

• "Encontre servidores desligados que não ligo há 14 dias."
• "Estime meu gasto mensal se eu apagar todos os staging-*."
• "Tire snapshot do test-vm-07 e depois apague o servidor."

💬 Exemplo de conversa completa

Você → Provisione um servidor Ubuntu pequeno em Miami para um blog pessoal,
        use minha chave SSH "laptop" e chame de blog-prod.

IA   → Vou fazer isso em 4 etapas:
        1. list_locations → confirma o slug de Miami como MIA1
        2. list_plans     → escolhe o plano de 1 GB mais barato (1c-1gb-25ssd)
        3. list_ssh_keys  → resolve "laptop" como slug laptop-abc
        4. create_server(hostname="blog-prod", location="MIA1",
                         plan_slug="1c-1gb-25ssd", image="ubuntu-22.04",
                         ssh_slugs=["laptop-abc"])
        Posso prosseguir? (sim/não)

Você → sim

IA   → ✅ Servidor blog-prod criado (id 91234, IP 192.0.2.45).
        Login root está desabilitado; use: ssh ubuntu@192.0.2.45

🛠️ Ferramentas MCP disponíveis (21)

get_account_info · list_locations · list_plans · list_images · list_ssh_keys · get_ssh_key · create_ssh_key · delete_ssh_key · list_servers · get_server · create_server · delete_server · start_server · shutdown_server · reboot_server · reset_server_password · list_snapshots · get_snapshot · create_snapshot · update_snapshot · delete_snapshot

🔐 Autenticação

Toda requisição precisa carregar a sua chave de API LetsCloud em Authorization: Bearer <chave-api> (ou no header alternativo X-LetsCloud-Token). Os tokens nunca são armazenados; são apenas repassados para a API oficial da LetsCloud.