# Adding a system account

### Deploy MechCloud Proxy for a REST API

Deploy either MechCloud OIDC or HTTPs Proxy depending on your requirement. See [Broken mention](broken://pages/GERmvubzIEmU8Vfi68y9#choosing-between-mechcloud-oidc-and-https-proxies) for more details.

### Registering a system account in MechCloud

Each system account registered in **MechCloud OIDC proxy** must have a unique id which is specified against **Credentials ID** while registering an account for the target system.

* Login to MechCloud [console](https://portal.mechcloud.io).
* Navigate to **Infrastructure -> System Accounts**.
* Click on **New System Account** button.
* Enter a name for the account.
* Choose **Kubernetes** in the dropdown.
* Enter the base url of Kubernetes API. 
  * If you are using minikube and exposing its api using [MechCloud HTTPS Proxy](https://github.com/mechcloud/mechcloud-flask-proxy), then the base url of k8s api will be \*\*<https://127.0.0.1:6443/minikube**.&#x20>;
* (Optional) If K8s api is running with a self-signed certificate, then open the base url (e.g. <https://127.0.0.1:6443>) in the browser and accept the certificate warning so that MechCloud can communicate with the k8s api.
* Click on **fetch version** link. If you are able to see k8s version, it means MechCloud is able to communicate with your k8s api. Otherwise, you can debug it with the help of browser devtools.
* If the k8s api require authentication, then add an account for k8s api in this proxy. Finally, enter the value of id attribute, which you chose in **MechCloud OIDC Proxy**, against **Credentials ID.**

<figure><img src="/files/5IBW9BpOWtSwYn5vBTP7" alt=""><figcaption></figcaption></figure>

* If the api is not secured then toggle the **Secured API** button to off position.


---

# Agent Instructions: 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:

```
GET https://docs.mechcloud.io/ai-agents/rest-agent/kubernetes/adding-a-system-account.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.