How to connect Boleani with Claude or ChatGPT (MCP)

MCP (Model Context Protocol) lets your AI assistant connect to Boleani and work with your real business: check today’s summary, see orders and appointments, or even create an order, book an appointment or file a ticket — all in natural language. Here is how to connect it in minutes.

1. 1

   Copy your MCP server URL

   In the Boleani dashboard open "Business settings" and the "MCP connection" card. Expand "MCP server" and copy the URL. It is the same for every AI client.

   https://www.boleani.com/api/v1/mcp

   With OAuth you do NOT paste any key: the client asks for permission and you authorize your business from Boleani.

2. 2

   Add it as a connector in your AI

   In Claude.ai: Settings → Connectors → "Add custom connector" and paste the URL. In ChatGPT (with connectors) or Cursor: add a remote MCP server with the same URL. The client discovers the auth method automatically.

   Client	Path
   Claude.ai	Settings → Connectors → Add custom connector
   ChatGPT	Settings → Connectors → Add MCP server
   Cursor	Settings → MCP → Add remote server

3. 3

   Authorize access (OAuth)

   Boleani’s "Authorize access" screen opens. Sign in if needed, pick the business you want to authorize and press "Authorize". Done — the client is connected without pasting any key.

   The app can only access the business you choose. It never sees your password or other businesses. You can revoke access anytime.

4. 4

   Alternative: connect with an API key (clients without OAuth)

   If your client does not support OAuth, use your API key (in the same "MCP connection" card). Best as an "Authorization: Bearer" header; as a last resort, the URL with the key included.

   Header (recommended):
   Authorization: Bearer bol_live_your_key
   
   URL with key (simple method):
   https://www.boleani.com/api/v1/mcp?key=bol_live_your_key

   Anyone with your API key or the URL-with-key can access your data. Keep it private; you can rotate it from the same screen if leaked.

5. 5

   Use it: ask your AI about your business

   Once connected, your assistant can query and act on Boleani in natural language. These are the available tools.

   Tool	What it does	Type
   get_summary	Today’s summary: orders, sales, appointments and tickets	Read
   get_catalog	Product or service catalog	Read
   list_orders	Recent orders (filter by status)	Read
   list_appointments	Upcoming appointments	Read
   list_tickets	Tickets / support requests	Read
   create_order	Create an order	Write
   book_appointment	Book an appointment (validates availability)	Write
   create_ticket	File a support request	Write

   Examples: "today’s summary in Boleani", "what are my upcoming appointments?", "create an order of 2 burgers for John at 3001234567".