Skip to main content

​
Prerequisites

  • A Majarrah account. If you don’t have one, sign up first.
  • Claude Desktop, or claude.ai on the web.

​
claude.ai (web)

1

Open Connectors

Click your avatar → Settings → Connectors.
2

Add a custom connector

Click Add custom connector.
3

Fill in the details

  • Name: Majarrah
  • Server URL: https://api.majarrah.io/mcp
  • Auth: OAuth
4

Authorize

You’ll be redirected to Majarrah, asked to sign in if you’re not already, and shown exactly which permissions Claude is requesting. Review, then Authorize.
5

Test it

Back in Claude, type “use Majarrah MCP to whoami”. You should see your email, roles, and workspaces.

​
Claude Desktop

Same flow — open Settings → Connectors → Add custom and use the same URL. Claude Desktop stores the OAuth token locally and refreshes it automatically.

​
What permissions does Claude ask for?

The consent screen shows a role-scoped list:
  • Every user: search, saved lists, inquiries, viewings, phone reveal, price intel, basic profile
  • If you’re a broker: workspace listings, CRM, team, API keys, credits
  • If you’re a developer: projects, widget config, knowledge base, inbox
You can revoke access at any time from Claude’s connector settings, or from Majarrah at Dashboard → Settings → Connections.

​
Troubleshooting

“whoami” says I’m a buyer but I’m a broker. Sign in to Majarrah in your browser first, then re-authorize the connector. Roles are read at the moment you authorize. I can’t scroll to the top of the consent screen. Make sure your browser window is at least 700 px tall. The card scrolls internally when content overflows.

What can you do once connected?

A tour of the tools available at each role tier.