You need an active Fortnox subscription in the portal,
or Fortnox must be included in your plan
(the free edition or
the Consile Studio membership). The company needs
Fortnox’s Integration licence, and the first time, the access must be approved by
a system administrator in Fortnox. Anyone on the team can connect an agreement
that is not connected yet. Only an administrator can reconnect it or disconnect
it. Your AI (Claude or
ChatGPT) can be added before or after.
How to connect
1
Open the connector in the portal
Open the Fortnox connector in the portal. Click Connect now at the top of
the page, or Connect next to the agreement on the Connections card. The
portal calls each connection to the system an agreement. If you have not
accepted Consile’s terms yet, you are asked to do so first.
2
Authorise access
The portal shows the permissions Consile asks Fortnox for (see
What exactly am I approving?). Click
Authorise access. You are sent to Fortnox’s login.
3
Log in and choose the company
Log in with your Fortnox user. If you have access to several companies, for
example as an accounting firm, choose the client the agreement should apply to.
The access is bound to exactly that company.
4
Confirm at Fortnox
Fortnox shows what Consile is asking for access to. Confirm to continue. You
are then sent back to the portal.
The portal shows that Fortnox is connected, and the agreement shows as
Connected. The agreement gets the company’s name and organisation number.
If you have not already added the address
https://mcp.consile.ai/fortnox/mcp in your AI, do it now.What exactly am I approving?
Consile asks for exactly fifteen permissions in Fortnox:companyinformation,
bookkeeping, customer, supplier, article, invoice, supplierinvoice,
project, costcenter, currency, offer, order, price, timereporting and
warehouse.
Read and write, with confirmation
Fortnox has no pure read permission: each permission covers both reading and
writing. Consile only changes something when a write tool is confirmed with
confirm: true, and an administrator can set users to Read only. See
Fortnox.Only the fifteen
Consile does not ask for payments, settings or payroll. If the approval contains
permissions other than the fifteen, or one is missing, the connection is
refused.
Encrypted per customer
The access is stored encrypted with a key that applies only to your account,
and is never logged. It is renewed automatically in the background.
Your AI never sees it
Your AI is never given the access itself. It only receives answers to your
questions.
Licences and modules. The permissions only work for the parts of Fortnox the
company has a licence for. Offers and orders require Offert & Order, the
warehouse requires Lager, and time registration requires Tidredovisning. If a
module is missing, your AI gets an explanatory message when it asks for that
data. Reconnecting does not help. If the connection cannot be completed at all,
write to support@consile.dk.
If the connection fails
If the approval does not succeed, the portal shows Connection was not completed and a technical reason. The most common ones:token_exchange_failed: Fortnox did not send back a valid approval, typically because you cancelled at Fortnox. Try again, and approve the access.unexpected_scope: the approval did not contain exactly the fifteen permissions Consile asks for. Try again.state_expired,invalid_stateorstate_unknown_or_consumed: more than 10 minutes passed, or the same approval was used twice (for example with the browser’s back button). Start over in the portal.
Multiple companies
One agreement covers one Fortnox company. If your AI should work in several companies, for example an accounting firm’s clients, you add one agreement per company:1
Add an agreement
Open the Fortnox connector in the portal. On the Connections card, an
administrator clicks Add agreement (149.50 kr/mo.). The agreement is added
to the existing subscription and charged pro rata for the rest of the period.
2
Connect the agreement
When the new agreement is ready (typically after a few seconds), click
Connect next to it and complete the steps above. Choose the company the
agreement should apply to when you log in to Fortnox.
3
Add the address in your AI
Each agreement has its own address, for example
https://mcp.consile.ai/fortnox-2/mcp. Copy it from the card, and add it as an
extra connector in your AI.https://mcp.consile.ai/fortnox-2/mcp instead of
https://mcp.consile.ai/fortnox-3/mcp). Check the addresses on the
Connections card, and update them in your AI. You remove the last agreement by
cancelling the subscription under Subscription.
The access is renewed, but the connection can stop
Consile renews the access automatically, so you do not have to reconnect in normal use. This is how an administrator reconnects:- If the agreement says Access revoked, click Reconnect, and follow the steps above.
- Otherwise: click the menu (the three dots) next to the agreement on the Connections card, choose Disconnect, and confirm with Disconnect. Then click Connect, and follow the steps above.
- You can also ask your AI for a new connection link. Ask in the connector that
belongs to the agreement (for example
fortnox-2), so the link connects exactly that agreement.
If your AI is instead told that the company lacks a licence, or that the user
lacks a right, reconnecting does not help. Ask your Fortnox administrator to give
access in Fortnox.
Revoke access
You can remove the access again at any time:- In the portal: an administrator clicks the menu next to the agreement on the Connections card, chooses Disconnect and confirms with Disconnect. The stored access is deleted at Consile right away. The subscription continues until an administrator cancels it under Subscription.
- In Fortnox: when you disconnect in the portal, Consile does not revoke the approval at Fortnox. If you also want to remove it there, an administrator does so under the integrations in Fortnox (Hantera integrationer). After that, the connector stops working in any case.
- When the subscription ends: if you cancel Fortnox under Subscription, Consile automatically deletes the stored access when the subscription ends.