---
title: Connecting an MCP client
id: integrations.mcp
description: "Connect an MCP client such as Claude, ChatGPT or Cursor to your organisation's Lucrii data."
lastUpdated: 2026-10-24
order: 70
---

Who can do this: administrators and owners.

## What it does

Connect an MCP client, such as Claude, ChatGPT or Cursor, to work with your Lucrii data from that app. MCP is the protocol an MCP client uses to reach your Lucrii data. The MCP page gives the one address every MCP client points at, under Connection. Below it, Connections lists the MCP clients that are connected.

Connecting is a sign-in followed by a consent screen.

- The MCP client sends you to Lucrii, where you pick the organisation to connect.
- The screen lists the permissions the MCP client needs, and you approve or deny. Access begins only once you approve.
- Approving can ask you to confirm it's you, once 10 minutes have passed since you logged in or last confirmed. Denying never asks. [Two-factor authentication and passkeys](/docs/settings/security.md) describes the Confirm It's You window.

Connections lists the whole organisation, including rows connected by other people.

| Column    | What it shows                                   |
| --------- | ----------------------------------------------- |
| User      | The person who connected the MCP client         |
| Client    | The MCP client that connected                   |
| Scopes    | The permissions they granted, or None           |
| Last used | When the MCP client last used the connection, or Never for one approved but not used yet |

- A connection belongs to the person who made it. When two people use the same MCP client, they get a row each.
- Revoking an MCP client ends its access at once. It has to connect again from scratch to get access back.
- An MCP client can also run a bulk action or start an export, through the same previews and approvals Hermes uses. Imports happen only in Lucrii.

Good to know:

- Approve and Deny answer the request the screen shows, even after you go back or forward to another one.

## Before you start

- Administrators and owners find MCP under Organisation. It isn't available in demo organisations.
- Hermes and an MCP client give each date as YYYY-MM-DD. Lucrii reads it as that day in your organisation's timezone. [What Hermes can do and change](/docs/hermes/tools.md) states the same rule.
- Hermes and an MCP client meet the same limits as the forms. [What Hermes can do and change](/docs/hermes/tools.md) says how Lucrii refuses a longer value. A note on a stock adjustment from an MCP client can be up to 1,000 characters.

## How to use it

1. Open Settings, then Organisation, then MCP.
2. Copy the address with the button beside it. The button shows Copied once the address is on your clipboard.
3. In your MCP client, add a custom MCP server and paste the address.
4. Sign in when the MCP client sends you to Lucrii, choose the organisation and approve the permissions.
5. To cut an MCP client off, find its row under Connections and select Revoke. Select Revoke again to confirm.

## Troubleshooting

The page says Could not copy to clipboard. Your browser blocked the copy. Select the address and copy it yourself.

## Related

- [Browsing the App Store](/docs/integrations/app-store.md): Browse the App Store for apps that connect Lucrii to the other tools you use.
- [Managing an installed app](/docs/integrations/manage.md): Set up, update, reconnect or uninstall an app your organisation has installed.
- [Bulk actions with Hermes](/docs/hermes/bulk-work.md): Ask Hermes for a bulk action, such as recording payment on unpaid invoices, and approve its preview first.

## Changes

- [Confirm it's you before sensitive changes](/changelog/2026-10-23#2026-10-23-confirm-its-you) - 2026-10-23
- [Bulk actions over MCP](/changelog/2026-10-16#2026-10-16-bulk-actions-over-mcp) - 2026-10-16
- [Field lengths and tag limits](/changelog/2026-10-16#2026-10-16-field-lengths-and-tag-limits) - 2026-10-16
- [Help lookups over MCP](/changelog/2026-09-30#2026-09-30-help-lookups-over-mcp) - 2026-09-30
- [Help pages for every feature](/changelog/2026-09-30#2026-09-30-help-pages-for-every-feature) - 2026-09-30