Este guia explica como ligar aplicações de IA ao servidor MCP LOX24 para enviar mensagens SMS e de voz e gerir a tua conta LOX24.

Pré-requisitos

• LOX24 API v2 Key (cria uma na tua conta nas definições da API)
• Node.js 18+ instalado (para mcp-remote proxy)

Detalhes do servidor MCP

• URL do servidor: https://mcp.lox24.eu/mcp
• Autenticação: chave da API através de X-LOX24-API-KEY no cabeçalho
• Cabeçalho opcional: X-LOX24-SENDER-ID (identificação padrão do remetente)

Funções

Claude Desktop

macOS

1. Instala o mcp-remote (se ainda não estiver instalado):
   

   npm install -g mcp-remote
   

2. Abre a configuração do ambiente de trabalho do Claude:
   

   abre ~/Biblioteca/Aplicação\  Suporte/Claude/claude_desktop_config.json
   

Ou cria-o se não existir:

mkdir -p ~/Biblioteca/Aplicação\  Apoio/Claude
toca em ~/Biblioteca/Aplicação\  Suporte/Claude/claude_desktop_config.json

3. Adiciona a configuração do servidor LOX24 MCP:
   

   {
     "mcpServers": {
       "lox24": {
         "comando": "npx",
         "args": [
           "mcp-remote",
           "https://mcp.lox24.eu/mcp",
           "--header" (cabeçalho),
           "X-LOX24-API-KEY: A TUA_CHAVE_API_AQUI"
         ]
       }
     }
   }
   

4. Reinicia o Claude Desktop (fecha e volta a abrir)
5. Verifica a ligação: Procura o ícone do martelo em Claude

Janelas

1. Instala o mcp-remote:
   

   npm install -g mcp-remote
   

2. Abre a configuração do ambiente de trabalho do Claude:
   

   %APPDATA%\Claude\claude_desktop_config.json
   

Ou navega até : C:\Users\<YourUsername>\AppData\Roaming\Claude\

3. Adiciona a configuração do servidor LOX24 MCP:
   

   {
     "mcpServers": {
       "lox24": {
         "comando": "npx",
         "args": [
           "mcp-remote",
           "https://mcp.lox24.eu/mcp",
           "--header" (cabeçalho),
           "X-LOX24-API-KEY: A TUA_CHAVE_API_AQUI"
         ]
       }
     }
   }
   

4. Reinicia completamente o Claude Desktop
5. Verifica a ligação: Procura o ícone do martelo

Facultativo: Identificação do próprio remetente

Para definir um ID de remetente predefinido para todas as mensagens SMS, adiciona outro cabeçalho:

{
  "mcpServers": {
    "lox24": {
      "comando": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.lox24.eu/mcp",
        "--header" (cabeçalho),
        "X-LOX24-API-KEY: A TUA_CHAVE_API_AQUI",
        "--header" (cabeçalho),
        "X-LOX24-SENDER-ID: A tua empresa"
      ]
    }
  }
}

Código Claude (CLI)

1. Adiciona o Servidor SMS MCP:
   

   claude mcp add lox24 -- npx mcp-remote https://mcp.lox24.eu/mcp  \
     --header  "X-LOX24-API-KEY: A TUA_CHAVE_API_AQUI"
   

2. Verifica:
   

   lista claude mcp
   

Cursor

1. Abre as definições do cursor: Cmd+, (macOS) ou Ctrl+, (Windows)
2. Navega para: Recursos → Servidores MCP
3. Adiciona a configuração do servidor MCP:
   

   {
     "lox24": {
       "comando": "npx",
       "args": [
         "mcp-remote",
         "https://mcp.lox24.eu/mcp",
         "--header" (cabeçalho),
         "X-LOX24-API-KEY: A TUA_CHAVE_API_AQUI"
       ]
     }
   }
   

4. Reinicia o cursor

Windsurf (Codeium)

1. Abre as definições de windsurf
2. Vai para a configuração da MCP
3. Adiciona a configuração do Servidor SMS MCP:
   

   {
     "mcpServers": {
       "lox24": {
         "comando": "npx",
         "args": [
           "mcp-remote",
           "https://mcp.lox24.eu/mcp",
           "--header" (cabeçalho),
           "X-LOX24-API-KEY: A TUA_CHAVE_API_AQUI"
         ]
       }
     }
   }
   

4. Recomeça a praticar windsurf

Cline (extensão de código VS)

1. Instala a extensão Cline a partir do VS Code marketplace
2. Abre as definições do Cline: Clica no ícone da roda dentada
3. Vai para a área Servidores MCP
4. Conclui a configuração:
   

   {
     "lox24": {
       "comando": "npx",
       "args": [
         "mcp-remote",
         "https://mcp.lox24.eu/mcp",
         "--header" (cabeçalho),
         "X-LOX24-API-KEY: A TUA_CHAVE_API_AQUI"
       ]
     }
   }
   

5. Recarrega o código VS

Continua (Código VS / JetBrains)

1. Abre a configuração Continuar: – Código VS: ~/.continue/config.json – JetBrains: Configurações → Continuar
2. Adiciona o servidor MCP:
   

   {
     "mcpServers": [
       {
         "nome": "lox24",
         "comando": "npx",
         "args": [
           "mcp-remote",
           "https://mcp.lox24.eu/mcp",
           "--header" (cabeçalho),
           "X-LOX24-API-KEY: A TUA_CHAVE_API_AQUI"
         ]
       }
     ]
   }
   

3. Inicia novamente a extensão

Zed Editor

1. Abre as definições do Zed: Cmd+, (macOS)
2. Completa o ficheiro settings.json:
   

   {
     "modelos_de_idioma": {
       "mcp_servers": {
         "lox24": {
           "comando": "npx",
           "args": [
             "mcp-remote",
             "https://mcp.lox24.eu/mcp",
             "--header" (cabeçalho),
             "X-LOX24-API-KEY: A TUA_CHAVE_API_AQUI"
           ]
         }
       }
     }
   }
   

3. Reinicia o Zed

Exemplos de aplicação

Diz à tua IA:

• “Envia um SMS para +49123456789 a dizer ‘Olá da IA!'”
• “Verifica o saldo da minha conta LOX24”
• “Obter informações sobre a minha conta”
• “Envia uma mensagem de voz para +49123456789 com o texto ‘A tua encomenda está pronta'”
• “Mostra as minhas mensagens SMS recebidas”

Fontes de erro

“A ferramenta não é apresentada”

• Certifica-te de que mcp-remote está instalado: npm install -g mcp-remote
• Verifica a tua chave API
• Reinicia a aplicação completamente
• Verifica o ficheiro de registo

“A autenticação falhou” / Erro 401

• Verifica a tua chave API (v2 utilizada?)
• Verifica a ortografia do cabeçalho: X-LOX24-API-KEY: YOUR_KEY
• Não tens espaço depois da chave?

“Tempo limite da ligação”

• Verifica se é possível aceder a https://mcp.lox24.eu
• Aumenta o tempo de espera nas definições

macOS: “npx não encontrado”

• Verifica se o Node.js está instalado: brew install node
• Ou com o caminho completo: /usr/local/bin/npx

Windows: “npx não reconhecido”

• Certifica-te de que o Node.js está no teu diretório
• Experimenta o caminho completo: C:\Program Files\nodejs\npx.cmd
• Ou reinicia o terminal/computador uma vez