How to connect an AI agent to RentProg
An AI agent works with company data on your behalf over the MCP protocol: it sees the same branches, records and fields as you do, and no more. The “MCP for AI agents” service must be enabled in the company's plan.
Two ways to connect
| Method | For which agents | Is a key needed |
|---|---|---|
| OAuth connector | Claude in the browser and in the desktop app, ChatGPT, Claude Code with the RentProg plugin | No: you sign in to RentProg and choose access on the consent screen |
Personal rpa_ key | RentProg CLI, Cursor, Codex and other clients without OAuth | Yes, issued in the profile |
Both methods are set up in the profile, in the “AI agent keys” section. It also shows a hint about which connector to add, the “Connected applications” list and the list of keys.
Where to get the connector address
The connector name and address for your company are shown in the profile, in the hint of the “AI agent keys” section. Use exactly those.
How to connect the connector in Claude
- Open the profile, the “AI agent keys” section, and look up the connector name and address in the hint.
- In Claude's connector settings, add a custom connector with the name and address from the hint. On Claude team plans, the connector is added by the organization owner.
- Click connect — the RentProg sign-in opens.
- On the consent screen, choose access by area and click “Allow”.
- Turn on RentProg in the conversation you need through Claude's tools menu.
How to connect the connector in ChatGPT
- Turn on developer mode in ChatGPT's app settings if it is not on yet.
- Create a new app with the connector name and address from the profile. If ChatGPT asks for an authorization method, choose OAuth.
- Start the tool search — the RentProg sign-in opens.
- On the consent screen, choose access by area and click “Allow”.
- Wait for the tools to load and save the app.
In a ChatGPT workspace, an administrator may need to publish the app for members.
How to connect Claude Code
Install the RentProg plugin version 3.0.0 or later:
/plugin marketplace add RentProg/rentprog-claude-plugin /plugin install rentprog@rentprogWhen the plugin asks, enter the connector address from the profile. The plugin does not need a key.
Open
/mcp, select therentprogserver and complete the sign-in and consent in the browser.Check that
/mcpshows therentprogserver with a list of tools.
Tip
If you had the 2.x plugin with a key, update it. Revoke the key in the profile if it is no longer used anywhere else.
What you choose on the consent screen
Access is set separately for each area: CRM, fleet and bookings, money, employees. The same levels are chosen when issuing a key.
| Level | What the agent can do |
|---|---|
| No access | Does not see the area |
| Read | Only views data |
| Write with approval | Prepares a change, which is carried out after your approval in the “Awaiting approval” section |
| Write with preview | First gets the result of the change, then confirms it itself |
| Write immediately | Makes the change without preview or confirmation |
Levels above what your role allows are not offered. If the employee's permissions are later reduced, the agent's access shrinks along with them. For money we recommend “Write with approval”, for CRM — “Write with preview”. Reconnecting the same app replaces the previous access.
How to issue a personal key
- Open the profile, the “AI agent keys” section, and click “Create key”.
- Enter the key name and access by area.
- Copy the key right away: after the window is closed, it is not shown again.
- From the same window, copy the MCP server address and, for agents with a terminal, the ready-made CLI command.
Important
A key is valid for one year, no more than five keys can be active at the same time, and revoking a key cannot be undone. Apps connected via OAuth do not count toward this limit. Keys are not issued to partners and agents.
With a key, the agent connects to the MCP server address from the profile and sends the header Authorization: Bearer rpa_…. For example, in Claude Code without the plugin:
claude mcp add --transport http rentprog address_from_profile --header "Authorization: Bearer rpa_your_key"How to revoke an agent's access
- Open the profile, the “AI agent keys” section.
- Find the app in the “Connected applications” list or the key in the list of keys.
- Click “Revoke access” next to the app or “Revoke” next to the key, and confirm.
- If needed, also remove the connector in the Claude or ChatGPT settings.
A revoked app or key loses access on the agent's very next request to RentProg. The main administrator sees the access of all employees in the company group in both lists and can revoke any of it.
Where the data goes
Everything the connection sees, including clients' personal data, the agent passes to the AI service you chose. Your company chooses the service, and it is responsible for making sure such a transfer is permitted by the laws of the country and by its agreements with clients.