Connect your agent
Qaema’s owner tools are exposed as an MCP server. Any MCP-capable assistant — Claude, ChatGPT, Cursor — can connect to it, read your menu photo or Instagram, and push structured items into a draft for you to review.
What you need
Section titled “What you need”- An account at
https://app.qaema.aiwith at least one venue created. - An MCP-capable client: Claude Code, Claude Desktop, ChatGPT, Cursor, or another client that speaks streamable HTTP MCP.
Add the server
Section titled “Add the server”In Claude Code, run:
claude mcp add --transport http qaema https://mcp.qaema.aiIn Claude Desktop, ChatGPT, or Cursor, add a custom HTTP MCP connector pointing at:
https://mcp.qaema.aiThe client opens a browser tab to complete OAuth — sign in to your Qaema account there. The server only answers requests whose Host header matches mcp.qaema.ai, so this URL is the one to use in every client.
Grant scopes
Section titled “Grant scopes”The consent screen lists what the agent is asking for: venue:read, venue:write, menu:read, menu:write, plus the standard OpenID scopes (openid, profile, email, offline_access) that keep the connection signed in. Review the list and select Allow to finish connecting, or Deny to cancel.
The first prompt
Section titled “The first prompt”Once connected, paste a prompt like:
Here is a photo of my menu — import it in Arabic and English, then show me the review
The agent reads the image, extracts sections and items, and calls the import tool on your behalf.
What happens next
Section titled “What happens next”Nothing goes live automatically. The agent’s import is staged with findings — missing prices, missing calories, suggested allergens, possible duplicates — for you to check. Depending on the client, you’ll either see an Import Review widget inline in the chat, or you can open the same review on the dashboard at /app/imports/{id}. Once you confirm, the changes land in your draft menu; publishing is a separate step you (or the agent, if you explicitly ask it to) take afterward.
Disconnect / revoke
Section titled “Disconnect / revoke”Go to /app/connections in the dashboard. It lists every app and agent with access to your account, when it connected, and its scopes. Click Revoke next to any connection to cut it off immediately — its access token stops working on the next request, even if it hasn’t expired yet.