# Developers: connect software or an AI assistant

In your account menu, open “Developers”. The page is called “API client”. This entry is visible in expert mode and marked BETA.

### Create an API client

Creating API clients requires a paid subscription or an active trial. You can have up to 5 clients.

1. Open “Create an API client”. If you already have a client, click “New API key”.
2. In “ID”, name your integration so you can recognise it.
3. Click “Generate an API key” and save the `client_id` and `client_secret`. The secret is shown only once.

<div class="alert">
<p><span class="lead">Important</span></p>
<p>Keep your secret confidential, like a password. Use it only on your server, never in browser code or a public application. Do not paste it into a chat with an AI assistant.</p></div>

### Connect your software

Your software exchanges these credentials for an access token at `https://api2.rentila.com/oauth/token`, using `client_credentials`. It then uses the token to call the API. Reuse it until it expires, then request a new one.

Open “Login instructions” for connection examples and “API documentation” for operations and their parameters.

### Connect an assistant with MCP

1. In your MCP-compatible client, add a server with the address `https://api2.rentila.com/mcp`.
2. Start the connection. On the Rentila page that opens in your browser, choose the country matching your account and enter your usual login details.
3. Enter the two-factor authentication code if requested, then return to your client.

You do not need to create an API client for this browser-based connection. You can then ask, for example: “List my properties” or “Which rents did I receive in October?”. Some operations change your data: check the request and any confirmations your client offers.

The “Claude MCP” button copies a setup link to open in your browser. “Claude Code”, “Codex” and “Cursor” copy setup text to use in the chosen tool. Enter your password only on the Rentila login page.

### Manage your API clients

The list shows the name, `client_id`, creation date and last login. The secret remains hidden. To delete a client, use the bin icon and confirm.

If you lose the secret, create a new client and update your software. If it is exposed, also delete the compromised client. If you have reached the limit of 5 clients, delete an unused client before creating another.

---

https://www.rentila.co.uk/support/developers-api-mcp
