Claude (web)
Connect Claude.ai directly to your rawquery workspace. Ask Claude to explore your data, run SQL, publish charts — all through a single OAuth authorization. Works on Claude's web and desktop apps.
Who this is for: users who don't want to install Claude Code or deal with API keys. If you prefer the CLI, see Claude Code.
Setup (30 seconds)
Requires a Claude Pro, Max, Team, or Enterprise plan (Claude.ai custom connectors are not available on the free tier).
1. Open Claude custom connectors
- Claude web: Settings → Connectors → Add custom connector
- Claude desktop: Settings → Connectors → Add custom connector
2. Enter the rawquery MCP URL
https://mcp.rawquery.devhttps://mcp.rawquery.devLeave OAuth Client ID and OAuth Client Secret blank. rawquery self-registers the client automatically.
Click Add.
3. Authorize
A browser window opens at rawquery.dev/authorize. If you're not logged in to rawquery, sign in first.
You'll see a consent screen showing:
- What Claude can do (read your data, create charts, trigger syncs)
- Which workspace to grant access to
Pick a workspace, click Authorize. You're done.
What Claude can do
Once connected, ask Claude anything about your data:
- Explore: "What tables do I have?", "Describe the stripe.customers table"
- Query: "Show me total revenue by month for 2026", "Which customers signed up last week?"
- Build: "Create a chart showing monthly active users", "Publish this as a public dashboard"
- Sync: "Refresh my Stripe data"
Claude uses the rawquery MCP tools under the hood. Every action happens in the workspace you authorized.
Scope
The connector has two scopes, both granted at authorization time:
| Scope | What it allows |
|---|---|
workspace:read | Read tables, schemas, saved queries, charts, pages, usage |
workspace:write | Create and modify saved queries, charts, pages, transforms; trigger syncs |
Claude is granted both scopes by default so the full workflow works. Access is scoped to the single workspace you pick at authorization — Claude cannot see or touch other workspaces.
Revoke access
At any time:
- Go to Settings → Connected apps in rawquery
- Find Claude in the list
- Click Revoke
The token is invalidated immediately. Claude will stop working until you re-authorize.
You can also remove the connector from Claude's side (Settings → Connectors → Remove). Both sides are safe to use.
Privacy
- rawquery never sees your Claude conversations
- Claude never stores your data — it queries live each time
- OAuth tokens live 1 hour, then auto-expire. Claude re-authorizes silently when needed.
- All traffic is HTTPS. Credentials are hashed at rest (SHA-256).
Claude Code vs Claude (web)
| Claude Code (CLI) | Claude (web) | |
|---|---|---|
| Install needed | Claude Code CLI | None |
| Auth | API key via rq login | OAuth (browser) |
| Where it runs | Your terminal | Claude web/desktop |
| Plan needed | Any | Pro / Max / Team / Enterprise |
| Best for | Developers, local workflows | Analysts, non-technical users |
Both use the same MCP tools underneath. Pick whichever fits your workflow.
Troubleshooting
"Couldn't reach the MCP server"
Check the URL: https://mcp.rawquery.dev (no trailing path, no typo). Confirm your Claude plan is Pro or higher — custom connectors are gated.
"Cannot authorize — Unknown or expired authorization request"
The authorization request expires after 10 minutes. Start over from Claude — click Connect again.
Claude says "I don't have access to rawquery"
The token may have expired (1h TTL). Disconnect and reconnect from Settings → Connectors in Claude. Your connected apps entry in rawquery will show a new timestamp.
I want to scope access to read-only
Not exposed in the UI yet. If you need this, ping us — it's on the roadmap.