AEB 앱 v1.0.6 + MCP 서버 — switch.blink · Devices-Speak 라우팅 정비 #

2026-05-08

SmartThings MCP 서버와 AEB 앱 내장 ST 클라이언트 양쪽에 동일하게 적용되었습니다.

새 기능

  • switch.blink 의사 명령 추가Devices-Commandcapability=switch 에서 command=blink 를 받으면 4단계로 토글한 뒤 시작 상태로 복귀 (시작 ON → off/on/off/on, 시작 OFF → on/off/on/off). delay_ms 기본 2000ms, 최대 5000ms 로 cap (초과 입력 시 결과 메시지에 안내). 동일 디바이스에 대한 동시 호출은 mutex 로 직렬화. 단일 디바이스 한정.

도구 설명 정비

  • Devices-Speak 라우팅 명세 갱신 — AEB 앱이 추가한 audioNotification 분기 정책에 맞춰 도구 설명을 다시 썼습니다: Gemini API key 가 있고 디바이스가 audioNotification 을 지원하면 Gemini TTS + audioNotification.playTrackAndResume, 그렇지 않으면 speechSynthesis fallback. 이전의 "Galaxy Home Mini → speechSynthesis 강제" 같은 모델별 분기는 제거되어 capability 만 보고 결정합니다. LLM 이 audioNotification/audioStream/mediaPlayback 을 직접 호출하지 말라는 가이드는 그대로 유지.

AEB app v1.0.6 + MCP server — switch.blink · Devices-Speak routing refresh #

2026-05-08

Applied identically to the SmartThings MCP server and to the embedded ST client inside the AEB app.

New

  • switch.blink pseudo commandDevices-Command with capability=switch accepts command=blink: 4-step toggle that returns to the starting state (start ON → off/on/off/on; start OFF → on/off/on/off). delay_ms defaults to 2000ms and is capped at 5000ms (the cap is surfaced in the result text). A per-device mutex serialises concurrent calls. Single-device only.

Description tweaks

  • Devices-Speak routing refreshed — rewritten to match the AEB app's audioNotification routing: when a Gemini API key is set and the device exposes audioNotification, the announcement goes through Gemini TTS + audioNotification.playTrackAndResume; otherwise it falls back to speechSynthesis. The old per-model carve-out ("Galaxy Home Mini → speechSynthesis only") is gone — capability alone decides. The "do not call audioNotification/audioStream/mediaPlayback directly" guidance for the LLM is preserved.

AEB 앱 v1.0.5 + MCP 서버 — 도구 설명 압축 · 매칭 정확도 향상 #

2026-05-07

SmartThings MCP 서버 + AEB 앱 내장 ST 클라이언트 양쪽에 동일한 도구 설명 압축과 FindAndCommand 매칭 fix 가 적용되었습니다.

최적화

  • 도구 설명 ~50% 압축 — 26개 SmartThings 도구의 description 을 한 단락으로 축약. 한국어 트리거 키워드(방송·알림·외출·조명들 등)와 안티패턴(예: TTS 는 Devices-Speak 만 사용)은 그대로 보존. JSON Schema 표준 호환이라 외부 MCP 클라이언트(Claude.ai, Cursor 등)에는 영향 없음.
  • 첫 턴 토큰 ~30% 절감tools/list 응답 직렬화 크기가 21KB → 9KB 수준. AEB 채팅 첫 호출 입력 토큰이 약 7,800 → 5,400 으로 줄어듭니다.

매칭 fix

  • Devices-FindAndCommand — 방 이름 매칭 추가 — 이전에는 도구가 device label/category 만 봤기 때문에 사용자가 "컴퓨터방 불꺼줘" 라고 해도 라벨이 그냥 "조명" 인 디바이스는 매칭되지 않았습니다. 이제 listRooms 로 방 이름까지 함께 매칭합니다.
  • 다중 단어 AND 매칭 — query 를 공백 단위로 토큰화한 뒤 모든 토큰이 {label, category, room name} 중 하나라도 매칭되어야 그 디바이스를 선택합니다. 예: query="컴퓨터방 조명" → "컴퓨터방"은 방 이름 매칭, "조명"은 라벨 매칭 → 컴퓨터방의 조명만 선택 (공기청정기 같은 다른 switch 디바이스는 제외).
  • 도구 설명 가이드 강화 — LLM 이 자연어 명령에 대해 Devices-List + Devices-Command loop 대신 Devices-FindAndCommand 를 먼저 선택하도록, query 형식을 <방> + <기기 종류> (필요 시 "불"→"조명"/"light" 같은 동의어 변환)로 만들도록 안내. 결과: "컴퓨터방 불 꺼줘" 가 4-5턴 → 2턴으로 회복.

AEB app v1.0.5 + MCP server — compressed tool descriptions & accurate matching #

2026-05-07

The SmartThings MCP server and the embedded ST client inside the AEB app received the same tool-description compression and FindAndCommand match fixes.

Optimizations

  • Tool descriptions ~50% smaller — every one of the 26 SmartThings tool descriptions trimmed to a single concise paragraph. Korean trigger keywords (방송, 알림, 외출, 조명들, …) and anti-patterns (e.g. TTS only via Devices-Speak) are preserved. Fully JSON-Schema compliant, so external MCP clients (Claude.ai, Cursor, …) are unaffected.
  • First-turn tokens ~30% lower — serialized tools/list dropped from ~21KB to ~9KB; first-call input on AEB chat falls from ~7,800 to ~5,400 tokens.

Match fixes

  • Devices-FindAndCommand now matches by room name — previously the tool only looked at device label and category, so a phrase like "turn off the bedroom light" failed when the device was just labeled "Light". We now look up listRooms and match the room name as a third field.
  • Multi-word AND matching — the query is split on whitespace and every token must hit at least one of {label, category, room name}. Example: query="bedroom light" → "bedroom" matches the room, "light" matches the category → only the bedroom lights are targeted (an air purifier with the same room is excluded).
  • Sharper tool-routing description — explicit examples and warnings push the model to call Devices-FindAndCommand directly for natural-language commands (instead of Devices-List + Devices-Command loops) and to build the query as <room> + <device-kind> with synonym translation (e.g. "불"→"조명"/"light"). Result: "컴퓨터방 불 꺼줘" regressed from 4–5 turns to 2 again.

AEB 앱 v1.0.4 — Skill 자동 인지 + 카테고리 매핑 #

2026-05-06

Skill 활용에 대한 client + server 양쪽 변화를 정리합니다. 서버 도구 자체는 변경 없음 (이미 category 필터 지원).

기능

  • Skill 자동 인지 + 사용 토글 — Tesla 같은 driver 가 발행한 aeb.skill capability(자기 능력·예시 모음)를 AEB 가 자동으로 LLM system prompt 에 주입해 정확한 명령 생성을 돕습니다. 설정 → Agent → "Skill 사용" 토글로 ON/OFF (기본 ON). 첫 턴 토큰 비용 vs 매칭 정확도 비교 가능.
  • device-categories reference 신규 추가 — 한국어 자연어 명령("조명 다 꺼줘", "센서 상태", "TV 음소거")을 SmartThings 표준 device category enum (Light, MotionSensor, Television 등) 으로 매핑하는 가이드. 그룹별 분류(조명·스위치·센서·공조·보안·가전·청소·미디어·에너지·환경 등) + 키워드 + 인접 그룹 fallback 룰 포함.
  • decision-tree 보강 — "사용자가 자연어로 기기를 지칭한다" 시나리오 추가. category 결정 → Devices-Search 흐름 명시.
  • SmartThings MCP 도구 자체는 변경 없음 — Devices-Search/Find/StatusByQuery 가 이미 category 파라미터 지원하던 것을 LLM 이 더 정확히 활용할 수 있게 만든 변화.

AEB app v1.0.4 — Skill auto-discovery + category mapping #

2026-05-06

Tracks both client and server changes around Skill usage. No tool-shape changes (server already supports category filtering).

Features

  • Skill auto-discovery + toggle — devices (e.g. Tesla driver) that publish the aeb.skill capability now have their self-description injected into the LLM system prompt automatically. Toggle in Settings → Agent → "Enable Skill" (default on). Useful for comparing first-turn token cost vs. matching accuracy.
  • New device-categories reference — maps Korean natural-language phrases ("turn off the lights", "sensor status", "mute the TV") to standard SmartThings category enums (Light, MotionSensor, Television, etc.). Group-based layout + keywords + adjacent-group fallback rules.
  • Decision-tree augmented — added scenario "user refers to a device in natural language" with the category-decision → Devices-Search flow.
  • No tool-shape changes on the server — Devices-Search/Find/StatusByQuery already accepted the category parameter; this change helps the LLM use it correctly.

AEB 앱 v1.0.3 — 클라이언트측 MCP 변경 #

2026-05-04

SmartThings MCP 서버 자체는 이번 업데이트에서 변경되지 않았습니다. AEB 앱 안에서 MCP를 어떻게 쓰는지에 대한 변화만 정리합니다.

기능

  • 웹 검색 RAG 도구 추가 — AEB 안에 새 MCP 클라이언트(websearch)가 추가되어 LLM이 DuckDuckGo에서 실시간 검색을 수행할 수 있습니다. 설정 토글로 ON/OFF.
  • 두 가지 채팅 모드 — CHAT 모드는 평소처럼 모든 MCP 도구 호출 가능, API 모드는 삭제·룰 변경·기기 변경 같은 위험 도구를 호출 단계에서 자동 차단합니다.
  • 채팅 화면 하단에 "API 모드 시뮬레이션" 토글 — 자동화/외부 호출 시점의 MCP 동작을 앱 안에서 미리 검증할 수 있습니다.

AEB app v1.0.3 — client-side MCP changes #

2026-05-04

The SmartThings MCP server itself is unchanged in this update. This entry tracks only how the AEB app uses MCP.

Features

  • New Web Search RAG tool — a new in-app MCP client (websearch) lets the LLM run live DuckDuckGo lookups. Toggle in Settings.
  • Two chat modes — CHAT keeps all MCP tools available; API mode blocks destructive tools (delete / rule changes / device updates) at dispatch time.
  • "API mode simulation" toggle in the chat screen — preview how MCP behaves under automation / external calls without leaving the app.

v0.5.0 #

2026-05-06

기능

  • 기기 스킬 도구 2종 추가 — Edge Driver가 자기 기기의 능력을 자연어 매니페스트로 발행한 경우, LLM이 그것을 직접 조회해서 정확한 명령을 만들 수 있습니다 (예: 차 잠그기, 에어컨 모드 변경 같은 모호한 요청에서 Driver가 알려주는 사용 예시를 참고)
  • 매니페스트 1회 조회로 후보 기기와 요약을 한 번에 — 큰 상세 스펙은 후보가 정해진 뒤에만 별도 호출 (응답 토큰 절약)

v0.5.0 #

2026-05-06

Features

  • Two new device-skill tools — when an Edge Driver publishes a natural-language capability manifest for its device, the LLM can now read it directly and build the right command (helpful for ambiguous requests like "lock the car" or "change the AC mode" where the driver provides usage examples)
  • One cheap manifest call returns all candidate devices with summaries; the larger detailed spec is fetched only after a candidate is chosen (saves response tokens)

v0.4.0 (이후 누적) #

2026-04-30 ~ 2026-05-02

기능

  • 모바일 푸시 알림 도구 추가 — LLM이 사용자 폰의 SmartThings 앱으로 직접 푸시 알림을 보낼 수 있습니다 (2026-05-02)
  • 도구 30개 → 24개로 통합 — 비슷한 도구들이 한 도구의 옵션으로 합쳐져 사용·이해가 더 쉬워졌습니다 (모드·룸·디바이스 명령 등)
  • 모드 정보에 모드 ID도 함께 포함 — 자동화에서 다루기 쉬움
  • LLM이 음성 안내(TTS)를 보내기 직전에 항상 최신 상태를 한 번 더 확인 — 옛 값으로 잘못 안내하던 문제 해소
  • 도구 설명에 한국어 예시가 섞여 있던 부분 영어로 통일 (LLM 학습 데이터 일관성 향상)
  • 디바이스 목록에서 사용자 휴대폰은 자동으로 숨겨 응답이 짧아지고 깔끔해짐

버그

  • Gemini 모델이 도구 정의를 거부하던 호환성 문제 해결
  • 일부 명령 인자 정의가 누락돼 LLM이 잘못 호출하던 문제 보완

v0.4.0 (and follow-ups) #

2026-04-30 ~ 2026-05-02

Features

  • New mobile push notification tool — the LLM can send push notifications straight to the SmartThings app on the user's phone (2026-05-02)
  • 30 tools consolidated to 24 — similar tools are now options on a single tool, making them easier to use and understand (Modes / Rooms / Device-Command, etc.)
  • Mode info now includes the mode ID — easier to use in automations
  • The LLM always re-fetches the latest state right before TTS announcements — no more announcing stale values
  • Standalone Korean examples in tool descriptions translated to English (consistent inputs for the LLM)
  • The user's own phone is auto-hidden from the device list — shorter, cleaner responses

Bug fixes

  • Fixed Gemini compatibility — the model was rejecting some tool definitions
  • Fixed missing argument schemas that were causing the LLM to invoke commands incorrectly

v0.3.0 #

2026-04-29

기능

  • 개인정보 동의 단계 추가 — 첫 사용 시 데이터 처리 안내와 동의를 명시적으로 받습니다
  • ChatGPT 가이드 탭 추가 — ChatGPT에서도 SmartThings MCP를 쉽게 연결할 수 있도록 안내
  • 응답 구조 평탄화 — LLM이 더 쉽게 읽을 수 있도록 status 응답 정리
  • 새 도구 3개 추가 + 타임존 처리 추가
  • 음성 안내(TTS)는 전용 도구를 우선하도록 정리 — 다른 도구로 우회 사용 차단
  • n8n 같은 다른 자동화 도구와의 OAuth 호환성 강화

버그

  • 연결 해제(Account-Unlink) 안내가 사용자 언어로 표시되도록 수정
  • 일부 GitHub 링크 정리 + ChatGPT 가이드 갱신

v0.3.0 #

2026-04-29

Features

  • Privacy consent gate added — first-time users now see an explicit data-handling notice and consent step
  • New ChatGPT guide tab — walks ChatGPT users through connecting SmartThings MCP
  • Flattened response structure — status responses reorganized so the LLM can read them more easily
  • 3 new tools added + timezone handling
  • Voice announcements (TTS) now strongly prefer the dedicated tool — workarounds via other tools are rejected
  • Stronger OAuth compatibility with other automation tools (e.g. n8n)

Bug fixes

  • Account-Unlink messages now appear in the user's language
  • Cleaned up some GitHub links and refreshed the ChatGPT guide

v0.2.0 #

2026-04-29

기능

  • 첫 공개 버전

v0.2.0 #

2026-04-29

Features

  • Initial public release