stackgate.ai
Alle integrationer

Philips Hue

Styr Philips Hue-lys, rum, scener og sensorer fra AI-agenter via Hue Remote API. OAuth-forbindelse og hosted MCP.

OAuth 25 værktøjer

Oversigt

Forbind Philips Hue, så AI-klienter kan finde og styre dine lys, rum, zoner, scener og sensorer via Hue Remote API. Brug denne integration, når du skal have en Hue MCP-server, Philips Hue OAuth til ChatGPT eller Claude, eller en styret måde at kontrollere dit smarte hjem fra AI-agenter uden at bygge en custom connector.

Almindelige use cases

  • Hue MCP til Cursor eller Claude Desktop — pege din klient mod POST /mcp/hue med et stackgate.ai bearer-token.
  • Styr lys væk hjemmefra — Hue Remote API når din bridge via Signifys cloud efter godkendelse.
  • Private gateway — brug Hue sammen med andre tools via én MCP-forbindelse med hue__* namespaced tools.

Forudsætninger

  • En Philips Hue Bridge knyttet til din Hue-konto (remote access aktiveret i Hue-appen)
  • En stackgate.ai-konto

Sådan får du credentials

OAuth (anbefalet)

  1. Log ind på stackgate.ai.
  2. Gå til Integrations og åbn Philips Hue.
  3. Klik Activate, derefter Connect Philips Hue.
  4. Log ind på account.meethue.com og godkend adgang for stackgate.ai Hue-appen.
  5. stackgate.ai gemmer dine tokens og opretter automatisk en Hue application key.

Hvis autorisation udløber senere, disconnect og reconnect Philips Hue fra My Integrations.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/hue med et Sanctum bearer-token
  • Private gateway: én konfiguration til alle integrationer — brug hue__* namespaced tools

Se Dokumentation for HTTP-autentifikation og private gateway-opsætning.

Fejlfinding

  • 422 integration not configured — fuldfør OAuth-connect i My Integrations.
  • 422 application key missing — reconnect Philips Hue, så en remote application key kan oprettes.
  • Auth / 401-fejl — reconnect; access tokens udløber, og refresh tokens kan udløbe efter lang inaktivitet.
  • 429 rate limit — Hue begrænser kommandohastighed, og hubben kan anvende et fair-use dagsloft. Vent og prøv igen.
  • Lys eller rum mangler — bekræft at bridgen er online, og at remote access er aktiveret i Hue-appen.

Tilgængelige værktøjer

  • list_lights

    Vis alle Hue-lys med ID og tilstand.

  • get_light

    Get details and current state for a single Philips Hue light by CLIP resource ID.

  • update_light

    Tænd/sluk eller ændr lysstyrke og farve for ét lys.

  • list_rooms

    Vis rum med grouped_light-ID til rumstyring.

  • get_room

    Get a single room by CLIP resource ID.

  • list_zones

    List zones (logical light groups spanning rooms) with grouped_light service IDs.

  • get_zone

    Get a single zone by CLIP resource ID.

  • list_grouped_lights

    List grouped_light resources used to control entire rooms or zones at once.

  • get_grouped_light

    Get a single grouped_light resource by ID (on/dimming/color aggregate state).

  • update_grouped_light

    Styr et helt rum eller zone via grouped_light.

  • list_scenes

    Vis scener med navne og gruppeforhold.

  • get_scene

    Get a single scene by CLIP resource ID.

  • recall_scene

    Aktivér en scene.

  • list_smart_scenes

    List smart (24h circadian) scenes.

  • get_smart_scene

    Get a single smart scene by CLIP resource ID.

  • recall_smart_scene

    Activate or deactivate a smart (24h) scene.

  • list_devices

    List devices (lights, bridges, switches, sensors) with product metadata and services.

  • get_device

    Get a single device by CLIP resource ID.

  • list_bridge_homes

    List bridge_home resources (whole-home grouped collections).

  • list_motion

    List motion sensor resources and current motion state.

  • list_temperature

    List temperature sensor readings from Hue sensors.

  • list_light_level

    List ambient light level sensor readings.

  • list_device_power

    List battery / power state for battery-powered Hue devices.

  • list_buttons

    List button resources (wall switches / remotes) and last event state.

  • list_contact

    List contact sensors (door/window open/closed state).

MCP-endpoint: https://stackgate.ai/mcp/hue (HTTP) eller via private gateway.

Opret konto Dokumentation