MCP (Model Context Protocol) lets external AI assistants — ChatGPT, Claude, Cursor, Claude Code, Windsurf and any MCP-compatible client — securely connect to your Moza workspace. The assistant reads information through Moza's intelligence layer (it never gets direct database access), can use Moza's intelligence (insights, forecasts, affordability), and makes changes only through a safe propose → confirm step. MCP is a Pro feature, and usage is metered with your existing AI Credits.
How it works
- Open Connect AI. In Moza, go to Profile → Connect AI. MCP is a Pro feature, so upgrade first if you're on Free.
- Pick your AI client and choose Connect. The recommended way is OAuth — you simply sign in to Moza and approve the workspace you want to share. No API key, endpoint or header to copy.
- ChatGPT: Settings → Connectors → Advanced → Developer mode → add a custom MCP connector → choose OAuth → sign in to Moza and approve.
- Claude: Settings → Connectors → Add custom connector → sign in to Moza when prompted and approve.
- Claude Code: run
claude mcp add --transport http moza https://app.moza.so/api/mcp/, then/mcpand sign in to Moza.
- For advanced clients (Cursor, Windsurf, local agents): open Advanced setup and create a Personal Access Key, then point the client at the Moza server endpoint
https://app.moza.so/api/mcp/with anAuthorization: Bearer <YOUR_MOZA_ACCESS_KEY>header. Copy the key right away — it's shown only once. - Start asking. Your AI client can now retrieve your Moza data and propose changes — you approve any change before it's applied. Revoke access anytime.
Limitations
- Pro only. MCP access requires a Pro plan.
- Writes are confirmed. Every change uses a propose → confirm flow — nothing is altered until you approve it.
- No direct database access. AI receives information through Moza's intelligence layer, never your raw database.
- Metered. AI-client usage draws from your existing AI Credits.
- Keep keys private. Treat a personal access key like a password; you can revoke it anytime from Profile → Connect AI → Advanced setup.
Common Questions
How do I connect ChatGPT or Claude to Moza?
Go to Profile → Connect AI and choose Connect on the ChatGPT or Claude card. Both connect with one-click sign-in (OAuth): add a custom MCP connector in the client, then sign in to Moza and approve the workspace you want to share. No API key needed.
Do I need an API key?
Usually no. ChatGPT, Claude and Claude Code connect with OAuth (sign in and approve). Personal access keys live under Advanced setup and are only needed for clients that don't support OAuth yet, like Cursor, Windsurf, local agents or self-hosted tools.
Is connecting an AI client (MCP) free?
MCP is a Pro feature. Once you're on Pro, AI-client usage is metered with your normal AI Credits.
Is it safe to let an AI client change my data?
Yes — AI receives information only through Moza's intelligence layer (never direct database access), and every write uses a propose → confirm flow, so Moza never changes anything until you approve it. You control which workspace is connected and can revoke access anytime from Profile → Connect AI.