MCP tehisintellekti assistentidele

HAM MCP (Model Context Protocol) server ühendab tehisintellekti assistendi teie seadmetega. Assistent näeb seadmete loendit, praeguseid näite ja ajalugu. Iga kutse töötab teie konto ja teie iga seadme õigustega.

Ühenduse andmed

Üksus	Väärtus
Aadress	`https://api.hamsystems.eu/mcp/index.php`
Transport	HTTP, JSON-RPC 2.0
Protokolli versioon	`2024-11-05`
Autentimine	Päis `Authorization: Bearer-API YOUR_API_KEY`

API võtme loote lehel Konto. Vaadake REST API.

Assistendi seadistamine

Looge API võti.

Lisage server oma assistendi MCP konfiguratsiooni. Claude Code’i jaoks on fail .mcp.json:

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

Taaskäivitage assistent.
Küsige näiteks: “Näita mulle minu seadmeid”. Assistent kutsub tööriista list_devices.

Tööriistad

Tööriist	Parameetrid	Tulemus
`list_devices`	`compact` (vaikimisi `true`)	Teie seadmed. Väärtusega `compact: true`: `serialno`, `name`, `icon`, `groups`, `floorplans` ja `count`. Väärtusega `compact: false`: kõik andmed koos sätetega.
`get_device_state`	`serialno` (üks number või loend)	Praegune olek. Sama vorming nagu `get_device_state.php`. Vaadake REST API.
`get_device_history`	`serialno`, `level`, `bin`	Ajaloo read. Samad tasemed ja bin-id nagu lehel ajalooliste andmete allalaadimine.
`get_definitions`	`family_id` (valikuline), `include_readings` (vaikimisi `true`)	Perekondade definitsioonid: näidud, väljundid, sätted
`get_docs`	puuduvad	Juhised tööriistade jaoks
`send_command`	`serialno`, `command`	Saadab käsu seadmele või grupile. Assistent saab käsud tööriistast `get_docs`.

Tavaline kutsete järjekord: list_devices, siis get_definitions perekonna jaoks, siis get_device_state või get_device_history.

Test curl-iga

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":{}}}'

Tulemus on väljal result.content[0].text JSON-tekstina:

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

Toetatud meetodid: initialize, notifications/initialized, tools/list, tools/call.

Vead

Kood	Tähendus
`-32000`	Autentimise viga (HTTP 401) või tööriista viga
`-32700`	Keha ei ole kehtiv JSON
`-32600`	Vigane JSON-RPC päring
`-32601`	Tundmatu meetod
`-32602`	Tööriista nimi puudub
`-32603`	Sisemine viga

Vaadake ka

Vestle toega