Connecting a client

This guide shows how to connect an MCP client to the Moloni ON server and start working in a company.

Add the server

The server endpoint is:

https://mcp.molonion.pt/mcp

Claude Desktop

Open Settings → Connectors (or Developer → MCP servers, depending on version).
Add a remote MCP server with the URL above.
Complete the sign-in when prompted.

Claude Code

Add it as a remote server:

claude mcp add --transport http moloni https://mcp.molonion.pt/mcp --scope user

Add it at the right scope

Add the server at user scope (or to a specific project), as shown above. If you add it while inside a subfolder, it may not appear when you run /mcp from elsewhere.

Select a company

Every data tool works within one selected company.

If your account has exactly one company, it is selected automatically — you can start right away.
If you belong to several, the assistant will ask you (or you can tell it) to pick one. Behind the scenes it calls company_select; you can list options first with company_list.

Your selection is remembered across requests. To switch companies later, just ask to change company (the assistant calls company_select again).

You can prompt naturally — e.g. "Which companies can I use?" or "Work in Acme Lda." — and the assistant maps that to company_list / company_select for you.

Troubleshooting

"Reconnect" / credentials rejected on reconnect — remove and re-add the server so it re-runs the sign-in flow.
Tools fail asking you to select a company — you belong to more than one company; ask the assistant to select one (company_select).
Server not listed in /mcp — you likely added it at the wrong scope; re-add with --scope user.

Add the server#

Claude Desktop#

Claude Code#

Select a company#

Troubleshooting#

Add the server

Claude Desktop

Claude Code

Select a company

Troubleshooting