💡 Ilumin MCP Server

O Ilumin MCP é o servidor oficial da Ilumin Cloud para o Model Context Protocol (MCP). Ele permite que agentes de IA e desenvolvedores interajam diretamente com a infraestrutura da Ilumin Cloud, facilitando o deploy, monitoramento e gerenciamento de aplicações.

A Ilumin Cloud é a plataforma definitiva para Vibe Coders, desenvolvedores e agentes de IA, oferecendo hospedagem otimizada com instalação em 1 clique para as ferramentas mais populares do mercado.

🚀 Funcionalidades

Com o Ilumin MCP, sua IA ganha "superpoderes" para gerenciar sua infraestrutura:

| Ferramenta | Descrição | | :--- | :--- | | list_servers | Lista todos os servidores e aplicações instaladas na sua conta. | | deploy_project | Faz o upload e deploy automático de projetos locais (Docker). | | list_deploys | Visualiza o histórico de builds e versões disponíveis. | | install_app | Instala aplicações customizadas via Docker Compose. | | update_app | Atualiza a versão de uma aplicação existente em segundos. | | manage_domain | Configura domínios e subdomínios personalizados para seus apps. | | list_catalog | Explora o catálogo Ilumin (n8n, Mautic, Chatwoot, etc). | | install_catalog_app | Instala apps do catálogo com 1 clique diretamente via IA. |

🛠️ Instalação (Stdio vs URL)

Atualmente, o Ilumin MCP é distribuído via NPM e configurado localmente através de comandos. Abaixo, explicamos a diferença entre usar via nome (NPM/npx) ou via URL (SSE).

1. Usando via Nome (Local Stdio - Recomendado)

A configuração padrão utiliza o comando npx para baixar e executar o servidor localmente. O cliente (como o Claude Desktop) inicia um processo filho e se comunica via entradas/saídas padrão (stdio).

No seu arquivo de configuração do MCP:

{
  "mcpServers": {
    "IluminMCP": {
      "command": "npx",
      "args": [
        "-y",
        "ilumin-mcp",
        "--x-api-key",
        "SUA_CHAVE_API_ILUMIN"
      ]
    }
  }
}

2. Usando via URL (Remote SSE)

Se o servidor MCP estivesse hospedado remotamente, ele utilizaria o transporte SSE (Server-Sent Events). Nesse caso, seu agente não rodaria um comando local, mas sim se conectaria a um endpoint HTTPS.

A configuração seria simplificada para:

{
  "mcpServers": {
    "IluminMCP": {
      "url": "https://mcp.ilumin.app/sse"
    }
  }
}

Nota: A versão atual foca na execução local para maior segurança e facilidade de deploy em ambientes de desenvolvimento.

☁️ Sobre a Ilumin Cloud

A Ilumin Cloud simplifica a vida de quem constrói o futuro:

• Agentes de IA: Infraestrutura pronta para escalar seus agentes.
• Apps 1-Clique: n8n, Mautic, Chatwoot, WordPress, Typebot e muito mais.
• Docker Ready: Traga seu próprio container e nós cuidamos do resto.
• Escalabilidade: Servidores de alta performance com gerenciamento simplificado.

🔑 Configuração

Para utilizar este MCP, você precisará de uma Chave API da Ilumin Cloud.

1. Acesse app.ilumin.app.
2. Vá em Conta / API.
3. Gere sua chave e substitua na configuração acima.

Desenvolvido por Ilumin Cloud Team ⚡