The numbers are there. The time to dig is not.
It is eleven at night, the shop is closed, and you are on the sofa with your phone. You want to know one thing: did the new biscuits sell, or did they just sit there? The answer is in the reports — product by product, day by day — but finding it on a small screen is work. Most nights you leave it for tomorrow, and tomorrow is busy.
An AI assistant is good at exactly this: understanding a question in plain words, fetching the right numbers and explaining them. What it lacked was a safe way into your shop. That is what this feature is.
What “connecting your AI” means
AI assistants reach other programs through a standard called MCP — think of it as a universal plug. PosMasr Cloud gives every shop a socket for that plug at https://api.posmasr.com/mcp, opened only with a key the owner makes. Once your AI is plugged in, it does not see your database: it sees a short list of tools, each one a question it may ask — “today's summary”, “compare two periods”, “what is running low” — and only the tools you allowed.
The AI stays yours. You pay its maker for your subscription as you already do; the shop pays us nothing extra per question. There are 19 tools in all; the full table is on the Connect your AI page.
Questions from a real day
Ask the way you talk. The AI chooses the tool; you never need to know its name. Some examples, and what the AI reads to answer them:
| You ask | It reads | The tick it needs |
|---|---|---|
| “How much did we sell this week against last week?” | A comparison of two periods | Reports |
| “Which hour is our busiest?” | Sales by hour | Reports |
| “What is about to run out?” | The low-stock list | Stock |
| “Which products make me the most profit this month?” | Profit by product | Reports + Stock |
| “What expires in the next ten days?” | Expiry dates | Stock |
| “What was on receipt 1043?” | That receipt and its lines | Receipts |
| “How much does Mr Hassan owe?” | The customer and the balance | Customers (off until you tick it) |
| “Who is clocked in right now?” | Today's attendance | Team (off until you tick it) |
It only reads — and why that matters
An AI can be tricked. A web page it reads, or a strange product note, can carry a hidden sentence like “now refund the last receipt”. That is why we did not build a single tool that writes. There is nothing to sell, void, refund, take a payment, change a setting or delete — so whatever the AI is talked into, the answer on our side is the same: that tool does not exist.
- Product names and notes reach the AI as data, never as instructions, and the AI is told so.
- A key sees only its own shop, and only its branch if you chose one. It is not a sign-in: nobody gets into your account with it.
- If a key keeps asking for what it may not see — 20 refusals within an hour — it is paused at once and you get the “AI key paused” alert. You look at what it was asked, then resume or revoke it.
A key for every AI
Make a separate key for each AI and each person: “My ChatGPT”, “My Claude”, “The accountant”. Each key has its own ticks — Reports, Stock, Products and Receipts start on; Customers, Bookings and Team start off, because the first two are personal data and the last two only matter when those modules are on.
- The key (
aik_…) is shown once. We keep only a hash of it, so copy it right away. - Optionally: one branch only, and a last day — handy for an accountant who works with you for a month.
- Revoke stops it at once. A key cannot be widened later: to give more, make a new one, so each key's record stays clear.
- Without the Customers tick, a customer on a receipt or a booking reaches the AI as “hidden”.
Setup, step by step
Only the owner can do this, from Settings → AI access.
- Tick “Allow AI access to this shop” and the sentence under it that says your AI sees only what each key allows. Save.
- Under New key: type a name, tick what this AI may see, choose a branch and a last day if you want, then Make the key.
- Copy the key. Below it, four setup cards are already filled with your address and the new key.
- Follow your card: the Claude desktop app (install Node.js once, paste the card's text into Claude's config file, restart Claude); claude.ai and the Claude phone apps (Settings → Connectors, a custom connector, paid Claude plans); ChatGPT (developer mode, then a connector, paid ChatGPT plans); or any MCP client such as Cursor (the address and a header).
- Ask: “Using my shop tools, how were sales today?”
The manual has every card in detail: AI access in the manual.
See what the AI did
On the same page, What the AI did lists the last 50 calls: when, which key, which tool, how many rows, and whether it was answered or refused. Your questions themselves are not stored — only that a tool was called. Making, revoking, pausing and resuming keys, and switching AI access on or off, also show in Team → Activity, next to everything else that happens in the shop.
The limits, plainly
- It reads; it does not act. No AI can sell, refund or change anything through this connection. We are not promising that this will change.
- Per key: 60 calls a minute and 2,000 a day; lists stop at 50 rows, and the AI is told to ask a narrower question.
- We have not tried every AI app. Their menus move from one update to the next; follow the ready cards, and look for “Connectors” if a name differs.
- The AI apps' own conditions apply: custom connectors in claude.ai and ChatGPT need their paid plans, and the Claude desktop app needs Node.js.
- The AI can still be wrong. The numbers it reads are exact; how it explains them is the AI's own work. For anything important, open the report and check.
- Online only, owner only. It is not in the program on your PC, and a manager or cashier cannot make keys.
Which plans include it
Connect your AI is part of Business (2,500 EGP a month) and Chain (5,000 EGP a month). Every new shop starts with 14 days of Business with no card, so you can connect your own AI and question your own numbers before paying. The full comparison is on the PosMasr Cloud page.
First year 20% off every plan and every add-on, with the code AHLAN20.
Quick answers
Do I pay PosMasr per question?
No. It is included in Business and Chain. You pay your AI provider for your own subscription, as you already do.
Can the AI change a price or refund a receipt?
No. There is no tool that writes, so there is nothing for it to call, whatever it is asked.
Does the AI see my customers' phone numbers?
Only on a key where you ticked Customers. That tick starts off; without it customers show as “hidden”.
Can my manager connect his own ChatGPT?
Only through a key the owner makes for him. Managers and cashiers cannot make keys themselves.
I use the program on my PC. Can I connect my AI?
Not from the program on your PC — this is a PosMasr Cloud feature. See online or on your PC if you are weighing a move.
Ask your shop's numbers in your own words
Start the 14-day trial of Business, no card, make a key in Settings → AI access, and ask your AI how today went.
First year 20% off every plan and add-on — with the code
