How to Connect AI to Biurko

Biurko runs a remote MCP server, which lets an AI assistant — such as Claude, Cursor, or ChatGPT — work directly with one of your companies. Once connected, the assistant can draft and issue invoices, look up contractors and products, and check KSeF status on your behalf. Access is always scoped to what you allow, every action is recorded, and anything irreversible asks for your confirmation first.

What You Need Before You Start

• A Biurko company on a plan that includes AI & MCP access. If your plan does not include it yet, you will see an upgrade prompt on the AI tab.
• Permission to view and manage MCP connections in that company. Owners always have it; other members need it granted through their role.
• An AI client that supports MCP connectors, such as Claude Desktop, Cursor, or ChatGPT.

You will find everything in your company settings, under the AI & MCP tab. That page shows your server URL, your active connections, and the live audit log.

Connecting a Client

The exact wording differs between clients, but the flow is the same everywhere.

1. Open your company settings in Biurko and go to the AI & MCP tab. Copy the server URL shown there — it looks like https://app.biurko.io/mcp.
2. In your AI client, add a new MCP server or connector and paste that URL.
3. The client opens a Biurko sign-in and consent screen. Sign in, choose the company you want the assistant to work with, and review the access you are granting.
4. Pick the scopes — the specific things the assistant may do. You can only grant what your own role allows, so the assistant never gets more access than you have.
5. Approve. The client is now connected and the assistant can start working with that company.

Claude Desktop

Open Settings → Connectors, choose to add a custom connector, and paste the Biurko server URL. Claude will guide you through the Biurko sign-in and consent screen.

Cursor

Open the MCP settings, add a new server using the Biurko URL, and complete the Biurko authorization when prompted.

ChatGPT

In a workspace that supports MCP connectors, add a new connector with the Biurko server URL and finish the Biurko sign-in and consent step.

One Connection, One Company

Each connection ties a client to a single company. The company is chosen during sign-in and fixed for that connection.

To work with a different company, you authorize again — either re-connect and pick the other company, or add a second connector for it. Note that some clients identify a connector by its URL and may not let you add a second connector pointing at the same Biurko URL. If that happens, switch the company on the existing connection by re-authorizing instead.

After You Change Permissions

If you change a connection's scopes on the AI & MCP tab, the assistant's available tools change with it. Clients usually load the tool list once when they connect, so the change may not appear until the client reconnects. After editing scopes, reconnect the client (or restart it) so it picks up the updated set of tools.

Staying in Control

• Scoped access. A connection can never do more than the permissions you granted, and never more than your own role allows.
• Full audit trail. Every action an AI client takes is recorded on the AI & MCP tab, updating live as it happens.
• Confirmation on sensitive actions. Irreversible operations and anything that touches KSeF ask for a separate confirmation before they run.
• Owner notifications. The company owner is notified when a new client connects or performs a sensitive action.
• Instant off switch. You can disable AI access for a whole company at any time, and revoke any individual connection from settings.