Connect your AI agent to Aleta

The Aleta MCP server lets an AI agent read and work with your Aleta data directly. Setup takes about a minute.

You need:

An Aleta login.
An agent app that supports remote MCP servers — Claude, ChatGPT, Cursor, VS Code and most others do.
The server URL: https://mcp.aleta.io/mcp

The screenshots below are from Claude. Other apps use different wording — look for MCP, Connectors, Tools or Integrations in settings — but the steps are the same.

1. Add the server

In Claude, as of September 2026, this lives under Customize → Connectors. Click Add, then paste https://mcp.aleta.io/mcp as the URL. The name is up to you — we suggest Aleta. Continue to the next screen.

The Add custom connector dialog, with the name Aleta and the URL https://mcp.aleta.io/mcp — The name and the URL are the only two values you enter.

2. Accept the detected settings

The next screen decides how the agent signs in, and it fills itself in: authentication comes up as Always required and the OAuth client as Anthropic's hosted client metadata, both marked Detected. Leave them alone and add the connector.

Authentication set to Always required and OAuth client set to Anthropic's hosted client metadata, both marked Detected — Nothing here needs changing — the defaults are already correct for Aleta.

3. Sign in

The connector now exists but is not connected yet. Click Connect and sign in with your Aleta login. The agent gets exactly the access your own Aleta user has — nothing more.

The Aleta connector showing 'You are not connected to Aleta yet' above a Connect button — Until you sign in, the connector is listed but inactive.

4. Check the tool permissions

The connector lists its tools in two groups. The read-only tools — reading your data, and looking up the API spec — are set to Always allow. The write/delete tools, which create, change or remove data, are set to Needs approval: the agent has to ask you each time before it uses one.

Tool permissions: read-only tools set to Always allow, write/delete tools set to Needs approval — The default setup. Nothing is created or changed without you confirming it first.

That's it — the connection works. Ask your agent to use the Aleta MCP and dive into your data.

Read-only setup

If you would rather the agent could never change anything, set the write/delete group to Blocked. The read-only tools stay on, so the agent can still answer questions about your data — it simply has no way to modify it.

Tool permissions with the write/delete tools group set to Blocked and those tools greyed out — Read-only. With the write/delete tools blocked, the agent cannot create or change data even if it is asked to.

We recommend this for anyone who uses Aleta mainly to look things up, and for organisations that want to rule out accidental changes made through an agent. Approving a write tool once, in a long conversation, is easy to do without meaning to; blocking removes the risk entirely.

These settings live in your own agent app, so each person can choose their own. If you need write access enforced centrally across your organisation, speak to your personal Aleta contact.