Connect Konto to your AI assistant¶

(Íslensk útgáfa: connect.is.md)

Add Konto's hosted connector to your AI assistant once, sign in with your Konto account, and then manage your bookkeeping in plain language — "book this receipt", "invoice Acme for 3 hours", "who's overdue?". No install, no api-keys to paste.

Production & dev endpoints: https://mcp.konto.is/mcp is live — you sign in with your real Konto account and act on your real books. Developers who want to try it against Konto's dev/test environment first should use https://dev-mcp.konto.is/mcp with a dev Konto login. Everything below uses the production URL.

The connector¶


Server URL	`https://mcp.konto.is/mcp`
Sign-in	OAuth 2.1 — you log in with Konto and approve which areas the assistant may use
Credentials	The connector holds a short-lived, per-user Konto token server-side. Your assistant never sees your Konto password or api-key.
Works with	Claude (web/desktop/mobile), ChatGPT (Developer Mode), Cursor, and any MCP client that supports remote servers

That one URL is the same across every AI client — sign in once with your Konto account and you're connected to your live books.

Claude — web, desktop & mobile¶

In Claude, open Customize → Connectors.
Click +, choose Add custom connector.
Paste the server URL: https://mcp.konto.is/mcp
Click Add, then Connect.
Konto's consent screen opens — review the requested scopes and click Allow.
Pro / Max: you can add it yourself with the steps above.
Team / Enterprise: an Owner adds it once under Organization Settings → Connectors → Add → Custom → Web; each member then clicks Connect. (If the "Add custom connector" option isn't visible to you, this is why — ask an Owner.)
Add it once on claude.ai (web) and it syncs to Claude Desktop and mobile on the same account. If Desktop doesn't show it, restart the app.

ChatGPT — Developer Mode¶

ChatGPT connects to remote MCP servers through Developer Mode (available on Pro, Plus, Business, Enterprise and Edu plans, on the web).

Settings → Connectors → Advanced and enable Developer Mode (equivalently: Settings → Apps → Advanced settings → Developer mode).
In the Connectors tab, add a new remote MCP server.
Enter the URL: https://mcp.konto.is/mcp
Complete the Konto sign-in when prompted.

ChatGPT supports remote MCP over SSE / streaming HTTP (no local servers). Write actions (creating an invoice, deleting a cost, …) prompt you for confirmation.

Cursor¶

Settings → Tools & MCP → New MCP Server (this opens mcp.json).
Add the server:

{
  "mcpServers": {
    "konto": { "url": "https://mcp.konto.is/mcp" }
  }
}

Use .cursor/mcp.json in a project for project-scoped access, or ~/.cursor/mcp.json for all projects. 3. Cursor opens a browser OAuth flow — sign in with Konto and approve. Cursor stores the credential for you.

Any other MCP client (including Gemini)¶

Any assistant that supports remote (Streamable-HTTP) MCP servers with OAuth can connect: point it at https://mcp.konto.is/mcp and complete the Konto sign-in. The connector is reachable over the public internet, which is what these clients require (they connect from the vendor's cloud, not your machine).

Gemini: MCP support is rolling out and differs by surface (Gemini app, Gemini CLI, Vertex AI). If your Gemini surface offers a custom remote-MCP / extension with a URL field, use the URL above; otherwise use Claude, ChatGPT, or Cursor for now. (Check the current Gemini UI — this space is moving fast.)

What you can ask¶

"What's my company status in Konto?"
"List my five most recent expenses."
"Book this receipt as a cost — 12,400 ISK from Múlakaffi, paid by card, 24% VAT."
"Create an invoice for Acme Corp: 3 hours of consulting at 20,000 ISK/hr, 24% VAT."
"Add a customer: Acme Corp, kennitala 1234567890, email acme@example.is."
"Show my open tasks and log 2 hours on the first one for today."
"How many costs from supplier X this quarter?"

What it can do — areas & permissions¶

At sign-in you approve scopes. Konto only grants the scopes your subscription includes, and your assistant only sees the tools those scopes unlock (39 tools in total across the areas below).

Scope	Area	What it enables
`manage_customers`	Customers	list, search, view, create, update customers
`nav`	Products & invoice reading	product/service catalogue; read, update & quote invoices
`create_invoice`	Invoicing	issue invoices and quotes
`recurring`	Recurring invoicing	create recurring invoice schedules
`cost`	Expenses	list, view, book (incl. receipt OCR), update, delete cost records
`task`	Tasks & time	tasks, timers, and time-log entries
`sell_product`	Product sales	read product-sale events and attendees
`dashboard_data`	Account	account status / identity check

Heads-up: write actions are real¶

The assistant acts on your instructions immediately. Creating an invoice issues it and Konto delivers it to the customer (by email or e-invoice, per that customer's delivery setting); marking an invoice paid, deleting a cost, or revoking an agent all take effect at once. Review money-moving actions before you confirm them. This is your live Konto data — invoices you create are real and go to real customers. To experiment safely first, connect the dev endpoint https://dev-mcp.konto.is/mcp with a dev/test Konto account.

Manage or revoke access¶

Revoke the connector's access to your Konto account anytime at https://konto.is/strax/agent/manage — remove the registered client.
Remove the connector in your AI tool's own connector settings.

Revoking in Konto is the hard stop: the connector's token stops working immediately, even if the connector is still listed in your AI tool.

Prefer to run it yourself? (power users)¶

There's also a local option: the konto-mcp npm package runs the server on your own machine with tokens stored on-device — no third-party server in the path, and it works for scripting and offline development. See the README for the local install + setup flow.

Troubleshooting¶

Symptom	Fix
"Add custom connector" isn't shown (Team/Enterprise)	An Owner must add it organization-wide first; then you Connect.
Added on web, missing on Claude Desktop	Restart the desktop app.
"requires the `X` scope"	Your Konto plan or consent didn't include that scope — reconnect and approve it, or upgrade the plan, then reconnect.
Assistant can't reach the server	The connector must be reachable from the vendor's cloud; `mcp.konto.is` is public, so this is usually a transient network issue — retry.
Wrong data / not my account	Make sure you completed the Konto sign-in as the right user; disconnect and reconnect if needed.