> For the complete documentation index, see [llms.txt](https://docs.mclimate.eu/mclimate-enterprise/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mclimate.eu/mclimate-enterprise/getting-started/adding-a-device.md).

# Adding a Device

Now that you have created a Building it is time to start filling it with Devices. The process is very intuitive and can be started from the Main Building Dashboard. Press on the "Add new device" button and you will be taken to a new screen.

<figure><img src="/files/tOZFwru3Gau1P4B6DPMq" alt=""><figcaption><p>Main Building Dashboard</p></figcaption></figure>

There are two ways to add a Device

* Manually filling in its Serial Number and App Key
* Importing a file with the parameters for 1 or more devices (this is useful if you need to add devices in bulk).

{% hint style="info" %}
MClimate has the practice of sending a CSV file with the device parameters required for registration **via email**. If you have not received one when ordering directly contact MClimate or the distributor you purchased the product from.
{% endhint %}

## Manually importing a device

Enter the "Serial Number" (14 symbols) and the "App Key" (32 symbols) in the corresponding text boxes and press on the "Add" button.

<figure><img src="/files/TYPntv94Pm5hhmX2ns3P" alt=""><figcaption><p>Adding a device</p></figcaption></figure>

You can add many devices this way in sequence, they will all be listed in the table at the lower half of the screen (refer to the image below).

Once you have added all devices and they appear in the table you can press the "Import devices" button in order to register them with Enterprise.

<figure><img src="/files/fhQ78tRhFUtBPT412Qn7" alt=""><figcaption><p>Importing devices</p></figcaption></figure>

Your screen will refresh and they will appear in the Main Dashboard.

{% hint style="info" %}
The dot in front of the device icon represents its state. Green if it is online, gray if it is not (refer to the image below).
{% endhint %}

<figure><img src="/files/SnlxuXQfFVnMxMzlSR08" alt=""><figcaption><p>Registered devices in Main Dashboard</p></figcaption></figure>

## Importing devices via a file

This option is especially suitable if you want to provision a lot of devices at once.

{% hint style="warning" %}
The CSV file should be in its original format as generated by MClimate, with the fields in the following order:\
Serial Number; DevEui; AppEui; AppKey; DeviceType

Do not remove the row with the column names.
{% endhint %}

The following image is a representation of a CSV file in the proper format, you can also download an example one below.

<figure><img src="/files/Py5VxrdCsgDjYCyRX1BY" alt=""><figcaption><p>Example Devices CSV file structure</p></figcaption></figure>

{% file src="/files/KsKqIml5qWcaLxyAVobz" %}
Example Devices CSV file
{% endfile %}

Simply drag and drop the CSV file into the text box.

<figure><img src="/files/GyWndo2i0P2p6pfTGgEw" alt=""><figcaption><p>Importing Devices via a file</p></figcaption></figure>

If the file is in the right format the table will populate with all the devices in it. Import via the button and you are done.

<figure><img src="/files/pIjwzf3RJ4ibSMNE0X41" alt=""><figcaption><p>Importing in bulk</p></figcaption></figure>

As with the manual case you should see all device in the Main Dashboard.

{% hint style="info" %}
If there is a device in the file you are importing via that has already been registered, there should be no error it will simply be omitted and the rest will be registered.
{% endhint %}

<figure><img src="/files/a3nzo3WtNSIFOjA1ynvw" alt=""><figcaption><p>Complete device list after importing</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.mclimate.eu/mclimate-enterprise/getting-started/adding-a-device.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
