Skip to content

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 check quell sync --help shows 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

  1. Open claude.ai
  2. Go to Settings → Connectors
  3. Search for "Quell"
  4. 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