Claude connector
The Claude connector lets you ask Claude.ai about the Production Readiness Score of your Python projects in plain English. It reads reports that you sync from the Python package with quell find --sync; it never sees your source code or test bodies. It is a Pro and Team feature and is separate from the local MCP server, which lets an agent run quelltest inside a repository.
What it does
Once connected, Claude can answer questions like:
- "What's my PRS for the payments module?"
- "Why can't those two edge cases be auto-tested?"
- "Which tests should I review before merging?"
- "Give me the README badge for this project."
Claude reads your synced Quell reports. It never sees your source code.
Requirements
- quelltest 2.0.1 or later —
pip install --upgrade quelltest; the sync settings were added in 2.0.1, so checkquell sync --helpshows the command - Pro or Team plan — cloud sync and the connector are Pro/Team features
- quell auth login — authenticate your account first
Setup in 4 steps
Step 1 — Authenticate
quell auth login
This opens a browser for an OAuth login and stores your session locally.
Step 2 — Sync your first report
quell find src/ --fix --sync
This scans your code, writes tests, and pushes a privacy-safe report to api.quelltest.com. You should see:
Report synced -> https://quelltest.com/dashboard/your-project
Step 3 — Connect in Claude.ai
- Open claude.ai
- Go to Settings → Connectors
- Search for "Quell"
- Click Connect and complete the OAuth flow (under 30 seconds)
Step 4 — Ask Claude
Once connected, start a new conversation and ask:
What is my production readiness score for payments-service?
Claude will call the get_prs_report tool and reply with your PRS, test counts, and any flagged items.
Configuration
Add to pyproject.toml to enable sync automatically:
[tool.quell]
sync = true # opt-in (default: false)
sync_project_alias = "my-service" # human-readable name in Claude
Or use the flag explicitly each time:
quell find src/ --sync
quell score . --sync
Verify what was sent
quell sync status --privacy
Output:
Sync enabled: yes (Pro tier)
Project: my-service
Last push: 2026-06-07 10:00:00
What gets sent: test names, confidence scores, flagged reasons, PRS, file:line
What stays local: all source code, all test bodies, all docstrings
View full schema: https://quelltest.com/docs/sync-payload
Remove your data
quell sync unlink
This deletes all synced data from api.quelltest.com. Claude will no longer be able to answer questions about this project.
Next steps
- MCP Tool Reference — all 8 tools Claude can call
- Privacy & Security — exactly what gets sent