1. Home
  2. Docs
  3. Guides
  4. 5-Minute Quickstart

5-Minute Quickstart

Get your first “AI controls a device” running in minutes: install the MCP server → configure your AI client → run a connectivity test. No real device needed — you can practice with the virtual devices on the demo page.

1

Install the MCP server

The MCP server bridges your devices and your AI client (see the L1 Access Protocol). Get the reference implementation from the mcp repository Releases and self-host it with one command, per the repository README.

2

Configure your client

Add one mcpServers entry to the MCP configuration of your AI client (Kimi / Claude Desktop / Cursor …), pointing at your MCP server:

3

Connectivity test

Restart the client and simply ask “list my devices”. Seeing the device list means you are connected; then try “turn on the living-room light” for the full loop.

Example mcpServers config

{ "mcpServers": { "open-aiot": { "command": "<your-open-aiot-mcp-server>", "args": [] } } }

This is a generic skeleton — the exact fields (command, args, environment) are defined by the mcp repository README and each platform tutorial.

Per-platform tutorials

No real device yet?

Start on the demo page with the virtual devices (light / thermostat / plug) for the full interaction; when you are ready to connect your own devices, grab resources and downloads on the developer page.