A automação de infraestrutura está entrando em uma nova fase. Em vez de depender apenas de painéis, scripts ou chamadas manuais de API, agora é possível interagir com recursos de cloud usando linguagem natural.

É exatamente esse o objetivo do LetsCloud MCP Server: conectar assistentes de IA, como o Claude, à infraestrutura da LetsCloud por meio do Model Context Protocol, também conhecido como MCP.

Com essa integração, o Claude pode ajudar em tarefas como consultar cloud instances, listar imagens disponíveis, verificar localizações, analisar snapshots, gerenciar SSH keys e apoiar fluxos de automação de infraestrutura com mais agilidade.

Neste guia, você verá como configurar o LetsCloud MCP Server no Claude de forma prática e segura.

O que é o LetsCloud MCP Server?

O LetsCloud MCP Server é uma ponte entre assistentes de IA e a plataforma da LetsCloud.

Na prática, ele permite que clientes MCP, como Claude, Cursor, Windsurf e VS Code Copilot, acessem ferramentas relacionadas à infraestrutura da LetsCloud por meio de uma conexão padronizada.

Diferente de MCP servers locais, que precisam ser instalados na máquina do usuário, o LetsCloud MCP Server é um serviço remoto. Isso significa que você não precisa instalar dependências locais, configurar runtime ou manter um processo rodando no seu computador.

Você conecta o Claude ao endpoint MCP da LetsCloud, autentica com sua API key e passa a interagir com a infraestrutura por meio de prompts.

O que você pode fazer com o MCP da LetsCloud no Claude?

Depois de configurado, o Claude pode auxiliar em operações como:

  • Consultar informações da conta LetsCloud;
  • Listar localizações disponíveis;
  • Ver planos de cloud instances;
  • Consultar imagens disponíveis para deploy;
  • Listar cloud instances existentes;
  • Ver detalhes de uma cloud instance;
  • Trabalhar com SSH keys;
  • Consultar snapshots;
  • Apoiar fluxos de automação e provisionamento.

O objetivo não é substituir completamente o controle humano, mas facilitar operações repetitivas e tornar a interação com a infraestrutura mais rápida, clara e conversacional.

Pré-requisitos

Antes de começar, você precisa ter:

  1. Uma conta ativa na LetsCloud;
  2. Acesso ao painel da LetsCloud;
  3. Uma API key da LetsCloud;
  4. O Claude Desktop instalado;
  5. Acesso às configurações de desenvolvedor do Claude Desktop;
  6. Acesso ao endereço oficial do LetsCloud MCP Server.

O endpoint MCP utilizado para a integração é:

https://mcp.letscloud.io

A página pública do projeto também pode ser acessada em:

https://www.letscloud.io/mcp

Passo 1: Gere sua API key na LetsCloud

A autenticação do LetsCloud MCP Server é feita por API key.

Acesse o painel da LetsCloud, vá até a área de API ou credenciais da conta e gere uma nova chave de acesso.

Guarde essa chave com segurança, pois ela será usada pelo Claude para autenticar as chamadas ao MCP Server.

A autenticação segue o padrão Bearer Token:

Authorization: Bearer SUA_API_KEY

Nunca compartilhe sua API key em chats públicos, repositórios, prints ou documentos acessíveis por terceiros.

Passo 2: Abra a configuração de desenvolvedor no Claude Desktop

No Claude Desktop, acesse:

Claude Desktop → Settings → Developer → Edit Config

Essa opção abre o arquivo de configuração do Claude Desktop, chamado claude_desktop_config.json.

O caminho do arquivo varia conforme o sistema operacional:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Esse arquivo é usado para declarar os MCP servers que ficarão disponíveis no Claude Desktop.

Passo 3: Adicione o LetsCloud MCP Server ao arquivo de configuração

Dentro do arquivo claude_desktop_config.json, adicione uma entrada para o LetsCloud dentro de mcpServers.

Use o modelo abaixo:

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

Substitua SUA_API_KEY pela API key gerada no painel da LetsCloud.

Se o arquivo já tiver outros MCP servers configurados, não substitua todo o conteúdo. Apenas adicione o bloco letscloud dentro de mcpServers, respeitando a estrutura JSON existente.

Exemplo com mais de um MCP server:

{
  "mcpServers": {
    "letscloud": {
      "url": "https://mcp.letscloud.io",
      "headers": {
        "Authorization": "Bearer SUA_API_KEY"
      }
    },
    "outro-mcp": {
      "command": "npx",
      "args": ["exemplo"]
    }
  }
}

Depois de editar o arquivo, salve as alterações.

Passo 4: Reinicie completamente o Claude Desktop

Após salvar o arquivo claude_desktop_config.json, feche completamente o Claude Desktop e abra novamente.

Não basta fechar apenas a janela. O ideal é encerrar o aplicativo por completo e iniciar uma nova sessão para garantir que a configuração do MCP seja recarregada corretamente.

Passo 5: Confirme se o LetsCloud MCP está conectado

Com o Claude Desktop aberto novamente, inicie uma nova conversa.

Em seguida, clique no ícone de plugue 🔌 e confirme se o conector letscloud aparece como conectado.

Para validar a integração, comece com um comando simples:

Show my LetsCloud account balance.

Se a conexão estiver correta, o Claude deverá conseguir consultar as informações da sua conta usando o LetsCloud MCP Server.

Você também pode testar comandos como:

Liste as localizações disponíveis na minha conta LetsCloud.

Ou:

Mostre os planos de cloud instances disponíveis na LetsCloud.

Outro exemplo:

Liste minhas cloud instances ativas na LetsCloud.

Esses primeiros testes ajudam a confirmar se a autenticação está funcionando e se o Claude consegue acessar corretamente as ferramentas expostas pelo LetsCloud MCP Server.

Passo 6: Use prompts mais completos

Depois que a conexão estiver validada, você pode usar prompts mais detalhados.

Exemplo:

Analise minhas cloud instances na LetsCloud e me mostre quais estão ativas, em qual localização estão e quais informações são relevantes para uma revisão de infraestrutura.

Outro exemplo:

Liste as imagens disponíveis para criar uma nova cloud instance Ubuntu e me ajude a escolher a opção mais adequada para um ambiente de desenvolvimento.

Ou ainda:

Verifique minhas SSH keys cadastradas na LetsCloud e organize uma visão geral para facilitar a administração da conta.

A vantagem do MCP é permitir que o Claude consulte ferramentas reais e combine essas informações com raciocínio contextual, em vez de responder apenas com conhecimento genérico.

Exemplo de uso: criar um plano de deploy

Imagine que você queira preparar uma nova cloud instance para um projeto web.

Você poderia pedir ao Claude:

Quero criar uma nova cloud instance na LetsCloud para hospedar uma aplicação web em Linux. Verifique as localizações disponíveis, liste imagens compatíveis e sugira uma configuração inicial.

Com o LetsCloud MCP Server conectado, o Claude pode consultar os dados disponíveis e ajudar você a estruturar o próximo passo.

Dependendo das permissões, ele também pode apoiar fluxos mais avançados, como provisionamento, criação de recursos e organização da infraestrutura.

E se o LetsCloud MCP não aparecer no Claude?

Se o conector letscloud não aparecer no Claude Desktop, revise os principais pontos:

  • Confirme se o arquivo claude_desktop_config.json foi salvo corretamente;
  • Verifique se o JSON está válido, sem vírgulas extras ou chaves faltando;
  • Confirme se a URL está configurada como https://mcp.letscloud.io;
  • Verifique se a API key da LetsCloud está correta;
  • Confirme se o header foi configurado como Authorization;
  • Confirme se o valor segue o formato Bearer SUA_API_KEY;
  • Feche completamente o Claude Desktop e abra novamente;
  • Inicie uma nova conversa após reiniciar o aplicativo.

Também é importante diferenciar MCP remoto de MCP local.

Muitos exemplos de MCP usam comandos locais, como node, npx, python ou docker. Já o LetsCloud MCP Server funciona como um MCP remoto, acessado por URL, usando autenticação por API key.

Boas práticas de segurança

Ao conectar uma IA à sua infraestrutura, alguns cuidados são essenciais.

Revise sempre as ações antes de aprovar qualquer execução. Mesmo com uma integração segura, o usuário continua sendo responsável por validar comandos, impactos e alterações no ambiente.

Evite colar API keys em conversas, documentos ou repositórios. Se houver suspeita de exposição, revogue a chave imediatamente e gere uma nova.

Comece com comandos de leitura antes de executar ações que alterem recursos. Isso ajuda a validar o comportamento do conector e entender como o Claude interpreta os dados da sua conta.

Também é recomendado usar prompts claros, objetivos e com contexto suficiente. Quanto mais específico for o pedido, melhor será a resposta do assistente.

Exemplos de prompts para usar com o Claude

Aqui estão alguns exemplos práticos para começar:

Liste minhas cloud instances na LetsCloud e organize por status.

Mostre as localizações disponíveis para criar uma nova cloud instance.

Quais imagens Linux estão disponíveis para deploy?

Liste meus snapshots e informe a qual cloud instance cada um está relacionado.

Verifique minhas SSH keys cadastradas e me ajude a identificar quais estão bem nomeadas.

Me ajude a planejar uma nova cloud instance para uma aplicação Node.js com banco de dados.

Analise os recursos disponíveis na minha conta LetsCloud e sugira uma organização inicial para ambiente de desenvolvimento, homologação e produção.

Por que usar o LetsCloud MCP Server com Claude?

A principal vantagem é transformar tarefas de infraestrutura em conversas guiadas.

Em vez de alternar entre painel, documentação, scripts e chamadas de API, você pode pedir ao Claude para consultar informações, comparar opções e auxiliar na tomada de decisão.

Isso torna o processo mais acessível para desenvolvedores, equipes de operações, startups e empresas que desejam acelerar fluxos de cloud automation.

O LetsCloud MCP Server também mantém a integração alinhada ao ecossistema moderno de IA, onde ferramentas como Claude deixam de ser apenas assistentes de texto e passam a atuar como interfaces inteligentes para sistemas reais.

Conclusão

Configurar o LetsCloud MCP Server no Claude é uma forma prática de levar automação inteligente para o gerenciamento de infraestrutura cloud.

Com poucos passos, você conecta o Claude à sua conta LetsCloud e passa a interagir com recursos como cloud instances, snapshots, imagens, localizações e SSH keys usando linguagem natural.

Essa integração representa um avanço importante para quem busca produtividade, automação e simplicidade no gerenciamento de ambientes cloud.

Para começar, acesse a página oficial do LetsCloud MCP Server, gere sua API key e conecte o Claude ao endpoint MCP da LetsCloud.

Related Articles

Read more about: PT-BR