ต้นแบบ · รุ่นทดลอง: มีทุก server ในทะเบียนทางการ อัปเดตทุก 30 นาที เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิวได้แล้วต้นแบบ · อัปเดตทุก 30 นาที
PopNx MCPที่รวม MCP สำหรับคนใช้ AI · วิธีติดตั้งภาษาไทยทุกตัว

Heiman Smart Home

โดย heimanhomeรุ่น 1.0.0i★ 0iรันบนคลาวด์เว็บทางการ ↗
ชื่อใน registryio.github.heimanhome/heimanhome-mcp

วิธีติดตั้ง

ใช้ทำอะไรได้

ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ

  • ต่อแบบ คลาวด์ (ต่อผ่านอินเทอร์เน็ต)
  • บัญชีหรือคีย์ ล็อกอินกับบริการตอนต่อ (OAuth)
  • หมวด เครื่องมือนักพัฒนา
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Control and query Heiman smart home devices: lights, AC, curtains, climate, logs and scenes.

ใช้คู่กับ

Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้

rea

rea เป็นเครื่องมือเสริมสำหรับ AI agent ใช้ทำ reverse engineering กับสิ่งต่าง ๆ ตั้งแต่พฤติกรรมของแอปพลิเคชันไปจนถึงไบนารีระดับ native

โดย morluto★ 467,2351 skill

Skill · คู่มือ

andrej-karpathy-skills

andrej-karpathy-skills เป็นไฟล์ CLAUDE.md ไฟล์เดียวที่ใช้ปรับพฤติกรรมของ Claude Code ให้ดีขึ้น โดยอ้างอิงจากข้อสังเกตของ Andrej Karpathy เกี่ยวกับข้อผิดพลาดที่พบบ่อยเมื่อ LLM เขียนโค้ด

โดย multica-ai★ 234,1251 skill

Skill · คู่มือไม่ระบุสัญญาอนุญาต

graphify

graphify เป็นเครื่องมือที่แปลงโค้ด เอกสาร สคีมา SQL คอนฟิก และไฟล์ PDF ให้เป็นกราฟความรู้ที่ค้นหาได้ ทำงานแบบ local ผ่านการแยกโครงสร้าง AST และใช้ได้กับ Claude Code, Cursor, Codex และ Gemini CLI

โดย Graphify-Labs★ 149,8731 skill

Skill · คู่มือ

ทำไมอยู่อันดับนี้

ตัวนี้อยู่ในแท็บ "แอปที่ต่อกับ AI" ซึ่งเรียงโดยไม่ใช้ดาว ตามลำดับเหล่านี้

1. อยู่ในสมุด connector ของ Claudeไม่
2. ทีมลองใช้จริงแล้วไม่
3. ใช้กับงานคนไทยไม่
4. การใช้งานไม่นับดาว20/100ความนิยม 0 · ความสด 12 · ระบบยังตอบ 8 · ถูกใจจากผู้ใช้ +0
5. ลงทะเบียนเมื่อ2026-11-17

ถูกใจจากผู้ใช้: 0 · บวกในลำดับได้สูงสุด 5 คะแนน (1 คะแนนต่อ 1 คน) ไม่มีใครจ่ายเงินเพื่อเพิ่มได้

คุณภาพ: ผลตรวจเบื้องต้นผ่าน 5/5 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง)

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ให้ AI ติดตั้งให้ด้วยประโยคเดียว

ติดตั้ง Heiman Smart Home ให้หน่อย ทำตาม https://mcp.popnx.com/i/heimanhome-mcp.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรัน

คัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน

ผลตรวจผ่าน 5/5 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (spmcp.heimanhome.com) · ✓ ตรวจคำสั่งแล้ว 17 พ.ย. 2569

ขั้นแรก: คุณใช้ AI ตัวไหน

เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง

ต่อกับ Claude ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม

  1. เปิดหน้า Connectors ของ Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. กด “Add” → “Custom” → “Web” แล้วกรอก 2 ช่องนี้

    คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue

    Name · ชื่อHeiman Smart Home
    Remote MCP server URL · ที่อยู่https://spmcp.heimanhome.com/mcp

    กด Continue ผ่านหน้าตรวจการล็อกอินที่ Claude ตรวจเจอ · หัวข้อ Authentication เลือกตามที่ผู้ทำบอก (Sign in now, Sign in when needed หรือ No sign in) แล้วกด Add

  3. เปิดใช้ในแชต

    +ConnectorsHeiman Smart Home

  4. ลองเลย

    ใช้ Heiman Smart Home บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude บอกว่ากำลังใช้ Heiman Smart Home หรือมีชื่อเครื่องมือของ Heiman Smart Home ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ ChatGPT ได้ ขึ้นกับแผน

MCP แบบเต็ม: ChatGPT Business, Enterprise หรือ Edu บนเว็บ · Pro: ต่อได้ด้วยสิทธิ์อ่านและดึงข้อมูล เครื่องมือที่แก้ข้อมูลอาจใช้ไม่ได้ · Plus: เอกสารยังไม่ยืนยัน ถ้าเห็นเมนูเพิ่ม MCP แบบกำหนดเองในหน้าปลั๊กอิน ลองตามขั้นตอนได้ · ใช้บนเว็บเท่านั้น

  1. เปิดหน้าเพิ่ม MCP ของ ChatGPT บนเว็บ

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. กรอกชื่อและที่อยู่

    ใส่ชื่อ แล้ววางที่อยู่ใต้ Connection ติ๊กยอมรับคำเตือน แล้วกด Create as a plugin

    Name · ชื่อHeiman Smart Home
    Connection · ที่อยู่https://spmcp.heimanhome.com/mcp
  3. เลือก Heiman Smart Home ในแชต

    เปิดแชตใหม่แล้วเลือก Heiman Smart Home จากรายการปลั๊กอินก่อนพิมพ์

  4. ลองเลย

    ใช้ Heiman Smart Home บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า ChatGPT บอกว่ากำลังใช้ Heiman Smart Home หรือมีชื่อเครื่องมือของ Heiman Smart Home ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ OpenAI เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Claude Code ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. เปิด Terminal

    Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell

  2. วางคำสั่งนี้แล้วกด Enter

    claude mcp add --transport http --scope user heimanhome https://spmcp.heimanhome.com/mcp
  3. พิมพ์ /mcp ใน Claude Code

    ต้องเห็น Heiman Smart Home ในรายการและขึ้นว่าเชื่อมต่อแล้ว

  4. ลองเลย

    ใช้ Heiman Smart Home บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude Code บอกว่ากำลังใช้ Heiman Smart Home หรือมีชื่อเครื่องมือของ Heiman Smart Home ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Cursor ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. กดปุ่มนี้เพื่อเปิด Cursor

    เปิดใน Cursor

    Cursor จะถามยืนยันการติดตั้ง ให้กด Install

  2. เปิดแชตของ AI ใน Cursor โหมด Agent

  3. ลองเลย

    ใช้ Heiman Smart Home บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Cursor บอกว่ากำลังใช้ Heiman Smart Home หรือมีชื่อเครื่องมือของ Heiman Smart Home ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ VS Code ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. กดปุ่มนี้เพื่อเปิด VS Code

    เปิดใน VS Code

    VS Code จะถามยืนยันการติดตั้ง ให้กด Install

  2. เปิดแชตของ AI ใน VS Code โหมด Agent

  3. ลองเลย

    ใช้ Heiman Smart Home บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า VS Code บอกว่ากำลังใช้ Heiman Smart Home หรือมีชื่อเครื่องมือของ Heiman Smart Home ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม

ดูโปรแกรมที่ใช้ MCP ทั้งหมด →

ที่อยู่สำหรับโปรแกรมที่ต่อผ่านเว็บ

ที่อยู่https://spmcp.heimanhome.com/mcp

ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง

ติดตรงไหน? ถามคนที่ใช้ Heiman Smart Home อยู่💬 พูดคุย →
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON

ต่อผ่านเว็บ

Claude Code

claude mcp add --transport http --scope user heimanhome https://spmcp.heimanhome.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "heimanhome": {
      "url": "https://spmcp.heimanhome.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "heimanhome": {
      "type": "http",
      "url": "https://spmcp.heimanhome.com/mcp"
    }
  }
}

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

สรุป

ดาวน์โหลดต่อสัปดาห์i
ไม่มียอดใน npm/PyPI
การเชื่อมต่อ
รันบนคลาวด์
รุ่นล่าสุดi
1.0.0
ส่งเข้า registryi
17 พ.ย. 2569
แก้โค้ดล่าสุดi
13 พ.ย. 2569
ตรวจล่าสุดเมื่อ
17 พ.ย. 2569
ผู้ทำ
heimanhome
สถานะใน registry
ใช้งานอยู่

ใช้กับโปรแกรมไหนได้

ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569

ต่อผ่านคลาวด์ได้ใน

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

ดูโปรแกรมทั้งหมดพร้อมข้อดีข้อเสีย →

คู่มือที่เกี่ยวข้อง

ทำอะไรได้บ้าง

server ให้ล็อกอินก่อนจึงจะแสดงรายการเครื่องมือ

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 19 พ.ย. 2569

  • ✓ ผ่าน

    ตัวตนผู้ทำตรงกับ repo

    ชื่อใน registry ยืนยันด้วยบัญชี GitHub heimanhome ซึ่งเป็นเจ้าของ repo

  • ✓ ผ่าน

    ยังมีคนดูแล

    มีการแก้โค้ดล่าสุด 6 วันที่ผ่านมา

  • ✓ ผ่าน

    มีสัญญาอนุญาต (license)

    ใช้ MIT

  • ✓ ผ่าน

    endpoint ตอบ

    ตอบกลับใน 459 ms (HTTP 401)

  • ✓ ผ่าน

    ล็อกอินแบบ OAuth

    ประกาศวิธีล็อกอินแบบ OAuth ให้โปรแกรม AI พาไปล็อกอินเอง

  • … ยังไม่ตรวจ

    คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

    ยังไม่ได้ตรวจ เราอ่านรายการเครื่องมือตอนตรวจ endpoint

เราตรวจอะไรบ้าง → · JSON

ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README

ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้

[![แนะนำบน PopNx MCP](https://mcp.popnx.com/badge/heimanhome-mcp.svg?lang=th)](https://mcp.popnx.com/th/servers/heimanhome-mcp)

พูดคุย

ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์

ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย

ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx

เข้าสู่ระบบเพื่อโพสต์

รีวิวจากผู้ใช้

ยังไม่มีรีวิว

เข้าสู่ระบบเพื่อเขียนรีวิว

เทียบกับตัวอื่นในหมวด เครื่องมือนักพัฒนาi

  • ดาวมากกว่า 0% ของอีก 6103 ตัวในหมวดนี้
  • ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 95% ของอีก 6103 ตัวในหมวดนี้
  • ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 6103 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Heiman Smart Home ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 5 จาก 5 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนคลาวด์ของผู้ทำ ต่อผ่านอินเทอร์เน็ตได้เลย ไม่ต้องลงโปรแกรม แต่ข้อมูลที่ส่งให้จะผ่านเซิร์ฟเวอร์ของผู้ทำ

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด 6 วันที่ผ่านมา และส่งรุ่นล่าสุด (1.0.0) เข้า registry เมื่อวานซืน

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT บนเว็บ (แบบเต็มในแผน Business ขึ้นไป · Pro แบบอ่านอย่างเดียว)

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise

ตัวอื่นที่ทำงานคล้ายกัน

หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

GitDiagram

Architecture diagrams, explanations and Mermaid source for public GitHub repositories.

โดย ahmedkhaleel2004ใช้กันมาก★ 19Kอัปเดต 2 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · gitdiagram.comทีม PopNx ลองใช้จริงแล้ว

Appllama

Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.

โดย Appllamaใช้กันมาก★ 5.2Kอัปเดต 3 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · appllama.io

Cloudflare MCP

Cloudflare MCP servers

โดย cloudflareใช้กันมาก★ 4.5Kอัปเดต 14 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · mcp.cloudflare.comทีม PopNx ลองใช้จริงแล้ว

Omnara

Deploy durable AI agents with Omnara, an open-source managed-agent platform.

โดย omnara-aiใช้กันมาก★ 3.4Kอัปเดต 2 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · omnara.com

Repowise

Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.

โดย repowise-devใช้กันมาก↓ 6.5K/สัปดาห์★ 8.2K ดาวรวมทั้งรีโปอัปเดต 6 วันที่ผ่านมา

บนเครื่องหรือคลาวด์✓ เจ้าของบริการ · repowise.dev
เทียบกับตัวที่คล้ายกัน
ตัวนี้
Heiman Smart Home
GitDiagramAppllamaCloudflare MCPOmnaraRepowise
ทำงานที่ไหนใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องมีทั้งบนคลาวด์และแบบลงเครื่อง
ต้องใส่คีย์ไม่ไม่ไม่ไม่ไม่ไม่
กด + ใน Claude ได้ไม่ไม่ไม่ใช่ไม่ไม่
ผลตรวจเบื้องต้น5/54/44/44/44/45/5
สัญญาอนุญาตMITMITMITApache-2.0Apache-2.0AGPL-3.0
ราคาไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียน

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

Heiman Smart Home MCP Server

Use an AI assistant to query and control Heiman smart home devices in natural language — lights, air conditioning, curtains, temperature and humidity, device logs, rooms, scenes and security — through one remote MCP endpoint.

Endpointhttps://spmcp.heimanhome.com/mcp
TransportMCP Streamable HTTP
AuthorizationOAuth 2.1 with PKCE (sign in with your smart home account)
Repositoryhttps://github.com/heimanhome/heimanhome-mcp.git
Supporthelp@heimanhome.com

This is a third-party integration, not an official Heiman / WorkBuddy / CodeBuddy / Anthropic / OpenAI / Microsoft product. Ownership and licensing boundaries are in NOTICE and OPEN-SOURCE-STATEMENT.md.


What you can do

CapabilityExample request
Device status and control"Set the living room light brightness to 50%"
Climate and sensors"What is the current temperature and humidity in the living room?"
Appliances"Turn on the living room AC and set it to 26 degrees"
Scenes"Close the curtains and run the Home scene"
History and aggregates"Show the average temperature and humidity of the last 24 hours"
Automations"Create an automation that turns off the living room light every day at 11 pm"
SecurityArm / disarm, alarm acknowledgement, alarm logs

The full tool list, parameters and dialogue examples are in skills/heimanhome-skill/SKILL.md.


1. Connect and authorize

  1. Add https://spmcp.heimanhome.com/mcp to your MCP client using one of the configurations below.
  2. Your client opens the authorization page. Sign in with your smart home account.
  3. Review the requested scopes. Read-only access is granted by default; tick write scopes only when you intend to control devices.
  4. Approve. The client stores the token; your upstream credentials never enter this repository.

Authorization uses OAuth 2.1 with PKCE. Client ID Metadata Documents, pre-registered clients and dynamic client registration are all accepted, so most MCP clients work without extra setup.


2. Client configuration

Generic mcp.json

Claude Desktop, Cursor, Cline, Windsurf, Zed, VS Code + GitHub Copilot and MCP Inspector:

{

"mcpServers": { "heiman-smart-home": { "type": "streamableHttp", "url": "https://spmcp.heimanhome.com/mcp", "timeout": 30000 } } }

Claude Code
claude mcp add --transport http heiman-smart-home https://spmcp.heimanhome.com/mcp
Clients that only support stdio

Bridge to the remote endpoint with mcp-remote:

{

"mcpServers": { "heiman-smart-home": { "command": "npx", "args": ["-y", "mcp-remote", "https://spmcp.heimanhome.com/mcp"] } } }

Hosted clients

ChatGPT connectors / apps, Claude.ai connectors, Copilot Studio, the OpenAI Responses API mcp tool, Gemini CLI and the WorkBuddy / CodeBuddy Connector marketplace: register a new remote MCP server in the client's own UI and paste the same URL. No file from this repository is required for that registration.


3. Scopes and safe writes

ScopeAllows
device:readDevice lists, status, capabilities, firmware, logs, sensor readings
device:controlSwitching devices on/off, brightness, target temperature, curtains
scene:readScenes, rooms, homes, automation listings
scene:executeRunning, creating, updating and deleting scenes / automations
security:controlArm / disarm, alarm acknowledgement
  • Without an explicit scope request the server grants read-only access.
  • High-impact actions require confirm=true; preview them first with dry_run=true.
  • When retrying a control command, pass idempotent_key, then check get_command_status(trace_id). A successful response means the command was accepted, not necessarily executed by the device.
  • whoami shows the current identity and granted scopes.
  • If a call is refused, fix the scope / parameter / confirmation instead of retrying the identical call.

4. Example prompts

Set the living room light brightness to 50%

What is the current temperature and humidity in the living room? Turn on the living room AC and set it to 26 degrees Close the curtains and run the Home scene Show the average temperature and humidity of the last 24 hours Create an automation that turns off the living room light every day at 11 pm When the temperature is above 28 degrees, turn on the AC and set it to 26 degrees

The assistant answers in the language you use. Example utterances in 8 languages are in connector-meta.json → i18n.locales.


5. Troubleshooting

SymptomWhat to do
401 / authorization expiredReconnect and authorize again in the client
"scope not granted"Re-authorize and tick the required scope on the consent page
Command accepted but device unchangedCheck get_command_status(trace_id); allow time for the device to report back
Too many requestsWait before retrying; do not loop on the identical call
Cannot connectConfirm the client supports Streamable HTTP + OAuth and the endpoint is reachable over HTTPS

6. Privacy and safety

  • Device control changes the physical world. Review dry_run previews, keep write scopes to the minimum and use two-step confirmation.
  • Access tokens and upstream credentials stay on the server. Never paste tokens, passwords or verification codes into public issues; report security issues to help@heimanhome.com.
  • The operator of the remote service is the data controller for home and device data — see OPEN-SOURCE-STATEMENT.md.

Documentation languages

LanguageDocument
English (authoritative)README.md
Deutschi18n/README.de.md
Françaisi18n/README.fr.md
Españoli18n/README.es.md
Portuguêsi18n/README.pt.md
العربية (RTL)i18n/README.ar.md
Русскийi18n/README.ru.md
简体中文i18n/README.zh.md

English is authoritative; translations are convenience copies. Arabic is right-to-left, while code blocks, tool names and JSON stay LTR.

License

MIT — see LICENSE. Ownership and trademark boundaries: NOTICE. Full statement: OPEN-SOURCE-STATEMENT.md.