MCP AI asszisztensekhez

A HAM MCP (Model Context Protocol) szerver összekapcsol egy AI asszisztenst az eszközeivel. Az asszisztens látja az eszközlistát, az aktuális méréseket és az előzményeket. Minden hívás az Ön fiókjával és az Ön eszközönkénti jogosultságaival fut.

Csatlakozási adatok

Elem	Érték
Cím	`https://api.hamsystems.eu/mcp/index.php`
Átvitel	HTTP, JSON-RPC 2.0
Protokollverzió	`2024-11-05`
Hitelesítés	`Authorization: Bearer-API YOUR_API_KEY` fejléc

Az API kulcsot a Fiók oldalon hozza létre. Lásd: REST API.

Az asszisztens beállítása

Hozzon létre egy API kulcsot.

Adja hozzá a szervert az asszisztense MCP konfigurációjához. A Claude Code esetében a fájl a .mcp.json:

{
  "mcpServers": {
    "ham": {
      "type": "http",
      "url": "https://api.hamsystems.eu/mcp/index.php",
      "headers": {
        "Authorization": "Bearer-API YOUR_API_KEY"
      }
    }
  }
}

Indítsa újra az asszisztenst.
Kérdezzen például ilyet: “Mutasd az eszközeimet”. Az asszisztens meghívja a list_devices eszközt.

Eszközök

Eszköz	Paraméterek	Eredmény
`list_devices`	`compact` (alapértelmezés: `true`)	Az Ön eszközei. `compact: true` esetén: `serialno`, `name`, `icon`, `groups`, `floorplans` és `count`. `compact: false` esetén: minden részlet, a beállításokkal együtt.
`get_device_state`	`serialno` (egy szám vagy egy lista)	Az aktuális állapot. Ugyanaz a formátum, mint a `get_device_state.php` esetében. Lásd: REST API.
`get_device_history`	`serialno`, `level`, `bin`	Az előzmények sorai. Ugyanazok a szintek és bin értékek, mint az előzményadatok letöltése oldalon.
`get_definitions`	`family_id` (nem kötelező), `include_readings` (alapértelmezés: `true`)	A családdefiníciók: mérések, kimenetek, beállítások
`get_docs`	nincs	Utasítások az eszközökhöz
`send_command`	`serialno`, `command`	Parancsot küld egy eszköznek vagy egy csoportnak. Az asszisztens a parancsokat a `get_docs` eszköztől kapja.

Egy szokásos hívási sorrend: list_devices, majd get_definitions a családhoz, majd get_device_state vagy get_device_history.

Teszt curl-lel

curl -X POST https://api.hamsystems.eu/mcp/index.php \
  -H "Authorization: Bearer-API YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_devices","arguments":{}}}'

Az eredmény a result.content[0].text mezőben van, JSON szövegként:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      { "type": "text", "text": "{\"devices\":[{\"serialno\":\"e11:123\",\"name\":\"Fridge 1\",\"icon\":\"\",\"groups\":[],\"floorplans\":[]}],\"count\":1}" }
    ]
  }
}

Támogatott metódusok: initialize, notifications/initialized, tools/list, tools/call.

Hibák

Kód	Jelentés
`-32000`	Hitelesítési hiba (HTTP 401) vagy eszközhiba
`-32700`	A törzs nem érvényes JSON
`-32600`	Érvénytelen JSON-RPC kérés
`-32601`	Ismeretlen metódus
`-32602`	Hiányzik az eszköz neve
`-32603`	Belső hiba

Lásd még

Csevegés az ügyfélszolgálattal