Integrace RichPear Home

Model Context Protocol Server

Model Context Protocol Server zpřístupní RichPear Home jako MCP server pro externí klienty. Klienti pak mohou používat vybrané nástroje, prompty a zdroje podle nastaveného přístupu.

Doména
mcp_server
Kategorie
voice
Komunikace
local-push
Kvalita
silver
01

Příprava

Rozhodněte, kterým klientům chcete RichPear Home zpřístupnit. Připravte bezpečnou externí nebo lokální adresu, autorizaci a pravidla přístupu.

MCP server může dávat klientům kontext a nástroje nad domácností. Před zapnutím si stanovte, co klient smí číst a měnit.

Lokální adresa

Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123.

02

Nastavení

V Nastavení -> Zařízení a služby přidejte MCP Server a nastavte možnosti přístupu. Po dokončení ověřte URL a klientskou konfiguraci.

Připojte nejdřív jednoho testovacího klienta a vyzkoušejte pouze čtecí nebo bezpečný nástroj.

Po přidání vždy zkontrolujte vytvořená zařízení, entity, oblasti a oprávnění uživatelů. Teprve potom integraci zapojte do automatizací.
03

Klientská konfigurace

Každý klient potřebuje správnou adresu serveru a autorizaci. Konfiguraci držte mimo veřejné repozitáře a sdílené dokumenty.

Při problémech s připojením ověřte URL, HTTPS, firewall a OAuth tok.

04

Access control

Přístupová pravidla rozhodují, co klient uvidí a smí použít. Nastavte minimum nutných oprávnění.

Nedávejte externím klientům možnost ovládat zámky, alarm nebo kritické systémy bez další ochrany.

05

Nástroje, prompty a zdroje

Server může poskytovat nástroje, prompty a zdroje. Každou kategorii projděte a ponechte jen to, co má jasný účel.

Popisy nástrojů musí být srozumitelné, aby klient nevolal špatnou akci.

06

Troubleshooting

Při opakovaných OAuth chybách zkontrolujte čas, redirect adresu, tokeny a klientskou konfiguraci. Při nedostupnosti serveru ověřte reverzní proxy a firewall.

Nelogujte tokeny do veřejných výstupů.

07

Údržba

Pravidelně kontrolujte aktivní klienty a odebírejte ty, které už nepoužíváte. Po změně domény nebo certifikátu znovu otestujte připojení.

U citlivých instalací sledujte audit volání nástrojů.

08

Kontrola po nasazení

Po prvním dni provozu projděte historii entit integrace Model Context Protocol Server. Sledujte, zda se hodnoty aktualizují podle typu komunikace local-push a zda se v logu neopakují stejné chyby, odpojení nebo odmítnuté požadavky.

Pokud integrace ovládá reálné zařízení, cloudový účet, finanční data, kamerový obraz nebo ruční konfiguraci, nechte správcům jasný postup pro vypnutí automatizace a návrat k ručnímu ovládání. Zapište si také místo, kde se spravuje token, API klíč, IP adresa, párování nebo konfigurační soubor.