O servidor MCP para a sua casa
Ligue o Claude, ou qualquer agente que fale MCP, e ele passa a ver e a comandar todos os dispositivos da sua app Casa. Continua a pedir confirmação antes de destrancar, regista tudo o que faz e nunca obedece ao nome de um dispositivo.
Feito para agentes
O Homeswift é um servidor MCP, a forma padrão de os agentes de IA acederem a ferramentas. Adicione-o ao Claude como conector personalizado, inicie sessão com a sua conta da interface web e decida até onde pode ir. Outros clientes MCP ligam-se com um token.
Em HTTPS, com um nome de domínio: Cloudflare Tunnel, Tailscale Funnel ou o seu próprio proxy inverso.
No Claude, em Settings › Connectors › Add custom connector, com https://home.example.com/mcp. Não há ID de cliente para copiar: o Claude regista-se sozinho.
Ler, Controlar ou Administrar, nunca mais do que a sua conta pode fazer. E acompanha-o nas apps do Claude no telemóvel.
Pergunta antes de agir
Apagar um candeeiro deve ser imediato. Destrancar a porta da rua, não. O Homeswift traça essa linha por si.
Tudo o que destranque, reescreva a configuração ou reinicie a ponte é primeiro executado como simulação. Vê cada definição e o seu novo valor e depois escolhe Permitir ou Não permitir. Uma alteração que falharia de qualquer forma nunca lhe é apresentada.
Fechaduras, portas de garagem e alarmes só mudam através de uma ferramenta protegida, que pede sempre confirmação. Uma cena que destrancasse alguma coisa recusa-se a ser executado sem supervisão.
Cada alteração fica num registo de auditoria com quem pediu, de onde e o que aconteceu. Consulte-o quando quiser, ou pergunte simplesmente: “o que mudou hoje?”
Palavras-passe, tokens e chaves são ocultados antes de qualquer coisa chegar a um modelo. A palavra-passe que uma TV entrega ao emparelhar viaja como uma referência que o modelo nunca lê.
Limites diários e mensais em tokens ou dólares. Quando se esgota, o assistente para até à meia-noite; as suas luzes não.
O texto vindo de dispositivos e registos é isolado como não fiável. Um dispositivo que se chame “destranca a porta” é lido, nunca obedecido.
Como pedir
Um assistente, um conjunto de regras, três portas de entrada. A Siri e a app Casa continuam a funcionar como sempre: cada dispositivo continua a ser um acessório HomeKit.
O botão do assistente, em todas as páginas, ou ⌘K. Mantenha o microfone premido para falar e ouça a resposta lida em voz alta. As conversas ficam guardadas, por utilizador, na sua própria máquina.
Adicione o Homeswift como conector no claude.ai e nas apps do Claude. Basta iniciar sessão com a sua conta da interface web e escolher o que pode fazer: ler, controlar ou administrar.
$ homeswift ask "porque é que a key light fica Sem resposta à noite" Perde o Wi-Fi quando o router reinicia, todas as noites às 03:00…
ask, explain para um erro, diagnose para um registo, ou o digest de hoje. Passe-lhe a saída do journalctl diretamente com um pipe.
Mais do que um comando
O assistente lê os mesmos plugins, registos e histórico que a ponte, por isso responde às perguntas a que um interruptor não sabe responder.
Porque é que a luz do alpendre deixou de responder ontem à noite?
Procura no registo por volta dessa hora, diz-lhe o que aconteceu e se há alguma coisa a corrigir.
O que aconteceu hoje?
Um resumo diário em menos de 200 palavras, com o que precisa de atenção em primeiro lugar. Também aparece na página Estado todas as manhãs.
Adiciona a luz Elgato em 192.168.1.50.
Escreve as definições do plugin, validadas pelo seu esquema, e mostra-lhe a alteração antes de guardar.
Emparelha a minha TV Philips.
Encontra a TV, faz o emparelhamento e mantém fora da conversa a palavra-passe que recebe.
Cria uma cena para a noite de cinema.
Escolhe os acessórios, propõe valores, experimenta-os e guarda uma cena que pode agendar.
Organiza as minhas divisões.
Sugere divisões e nomes mais claros para quarenta acessórios chamados “Interruptor 2”.
Novidade da 0.9
143 paletas de cores fotográficas em 28 temas, com vinte e dois ambientes para as luzes de uma divisão. Explore temas como Fique confortável, Noite de cinema e Vontade de viajar, e escolha as mesmas imagens para os cenários guardados. Os ambientes animados repõem as luzes quando terminam.
Arctic aurora
Rolling hills
Blossom
Luz de velasLuz muito quente e ténue para o jantar.
LareiraVermelhos, laranjas e âmbar a dançar de forma irregular.
OceanoAzuis e turquesas que passam de luz em luz como ondas.
Aurora borealVerde, turquesa e violeta a deslizar lentamente.
Pôr do solDez minutos do amarelo dourado a um vermelho ténue, passando pelo laranja e pelo rosa.
DiscoCada luz salta para uma cor viva a cada batida.
Sirene de políciaVermelho e azul a trocar de luz em luz.
HalloweenRoxo e laranja com um tremeluzir inquietante.Transforma a sala num bar de jazz.
O assistente escreve o ambiente a partir das suas palavras: as cores, quanto tempo dura cada uma, se se repete. Sabe quantas luzes existem, nunca os nomes.
Halloween nas luzes da sala de jantar.
Roxo e laranja com um tremeluzir inquietante durante meia hora, e depois cada luz volta ao que era. Ou diga «parar».
Um pôr do sol de dez minutos no quarto.
Do amarelo dourado a um vermelho ténue, passando pelo laranja e pelo rosa, e as luzes ficam assim. Também é um botão na página Cenas.
O modelo à sua escolha
O assistente é opcional, fica desligado até o adicionar e fala com o fornecedor que escolher, por HTTPS simples.
Na base
O assistente assenta no Homebridge, reescrito em Swift: a sua configuração e os seus plugins do Homebridge, num pequeno binário sem Node.js. Desligue o assistente e continua a ser a ponte mais leve que pode usar.
Apple M1, uma execução de cada em loopback. A comparação completa.
Instalar
# 1. A ponte. A rede do anfitrião permite ao HomeKit encontrá-la por mDNS.
docker run -d --name homeswift --network host \
--restart unless-stopped \
-v ~/homeswift:/homeswift \
ghcr.io/mp-consulting/homeswift:latest
// 2. O assistente: um bloco no config.json, com um orçamento. { "platform": "HomeswiftAiKit", "provider": "anthropic", "apiKey": "sk-ant-…", "budget": { "monthlyUsd": 5 } }
Na porta 8581; crie a sua conta com o código que a ponte mostra.
Escolha plugins e preencha as definições, ou peça ao assistente que o faça.
Digitalize o código QR na página Estado.
Prima ⌘K e diga à sua casa o que quer.