MCP за AI асистенте

HAM MCP (Model Context Protocol) сервер повезује AI асистента са вашим уређајима. Асистент може да види листу уређаја, тренутна очитавања и историју. Сваки позив ради са вашим налогом и вашим дозволама на сваком уређају.

Подаци за повезивање

Ставка	Вредност
Адреса	`https://api.hamsystems.eu/mcp/index.php`
Транспорт	HTTP, JSON-RPC 2.0
Верзија протокола	`2024-11-05`
Аутентификација	Заглавље `Authorization: Bearer-API YOUR_API_KEY`

API кључ правите на страници Налог. Погледајте REST API.

Подешавање асистента

Направите API кључ.

Додајте сервер у MCP конфигурацију свог асистента. За Claude Code датотека је .mcp.json:

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

Поново покрените асистента.
Питајте, на пример, „Прикажи моје уређаје”. Асистент позива алат list_devices.

Алати

Алат	Параметри	Резултат
`list_devices`	`compact` (подразумевано `true`)	Ваши уређаји. Са `compact: true`: `serialno`, `name`, `icon`, `groups`, `floorplans` и `count`. Са `compact: false`: сви детаљи, са подешавањима.
`get_device_state`	`serialno` (један број или листа)	Тренутно стање. Исти формат као `get_device_state.php`. Погледајте REST API.
`get_device_history`	`serialno`, `level`, `bin`	Редови историје. Исти нивои и бројеви датотека као у Преузимање историјских података.
`get_definitions`	`family_id` (опционо), `include_readings` (подразумевано `true`)	Дефиниције породица: очитавања, излази, подешавања
`get_docs`	нема	Упутства за алате
`send_command`	`serialno`, `command`	Шаље команду уређају или групи. Асистент добија команде из `get_docs`.

Уобичајен редослед позива: list_devices, затим get_definitions за породицу, затим get_device_state или get_device_history.

Тест помоћу curl

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

Резултат је у result.content[0].text, као JSON текст:

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

Подржане методе: initialize, notifications/initialized, tools/list, tools/call.

Грешке

Кôд	Значење
`-32000`	Грешка аутентификације (HTTP 401) или грешка алата
`-32700`	Тело није исправан JSON
`-32600`	Неисправан JSON-RPC захтев
`-32601`	Непозната метода
`-32602`	Недостаје име алата
`-32603`	Унутрашња грешка

Погледајте и

Ћаскање са подршком