How to connect Claude to Quilty

Quilty is now in the Claude directory. You can ask Claude about a completed analysis the same way you would ask a coverage reader — scores, story-craft notes, scene search — without exporting a PDF or pasting a report into chat.

This is the setup guide. The short product reference is on the Claude connector docs.

What you need

1. A Quilty account with at least one completed analysis.
2. Claude.ai, Claude Desktop, or Claude Code (or another MCP client).
3. About two minutes.

Scores Claude reads are diagnostic assessments, not predictions of commercial outcome.

Option A — Claude.ai (fastest)

This is the path most people should use. You do not paste a token.

1. Open claude.ai and sign in.
2. Go to Customize → Connectors.
3. Find Quilty in the directory, or open the listing directly: claude.ai/directory/data/quilty.
4. Click Connect.
5. Sign in with your Quilty account and approve access.
6. Start a new chat and ask Claude to use Quilty. Example:

List my completed Quilty analyses and summarize the Quilty Score for the latest one.

If Quilty does not appear in search, add it as a custom connector:

1. Customize → Connectors → Add custom connector.
2. Name: Quilty.
3. Server URL:

https://quilty.app/api/mcp

4. Save, then sign in with your Quilty account when prompted.

Transport is Streamable HTTP. The same URL works for every user; Claude uses Quilty login (OAuth) so the session is scoped to your account.

Option B — Claude Code (personal token)

Claude Code talks to Quilty with a personal access token. Mint it once, then run the command Quilty generates for you.

1. Sign in at quilty.app.
2. Open Settings → Claude connector.
3. Give the token a label (for example Claude Code) and click Create token.
4. Copy the token immediately. It is shown once on that page and emailed to your account.
5. Run the generated command. It looks like this (your token will be different):

claude mcp add --transport http quilty https://quilty.app/api/mcp --header "Authorization: Bearer qmcp_YOUR_TOKEN"

6. Start a Claude Code session and ask it to list your Quilty analyses.

Treat the token like a password. Revoke it anytime from the same settings page.

Option C — Claude Desktop (personal token)

Desktop uses mcp-remote plus the same personal token.

1. Mint a token at Settings → Claude connector (same as Option B).
2. Open Claude Desktop’s claude_desktop_config.json.
3. Paste the generated config. The shape is:

{
  "mcpServers": {
    "quilty": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://quilty.app/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer qmcp_YOUR_TOKEN"
      }
    }
  }
}

4. Restart Claude Desktop.
5. Confirm quilty appears in the connectors / tools list, then ask about a completed analysis.

The Authorization:${AUTH_HEADER} form (no space in the header template) is required so Desktop does not mangle the value. Use the JSON Quilty generates on the settings page rather than typing this by hand.

What Claude can read

Tool	What it returns
List analyses	Completed reports you own — title with year, content type, score
Analysis manifest	Section index and approximate sizes (not the full report)
One analysis section	Paginated chapter text; Claude should fetch only what it needs
Quilty Score	Diagnostic score, confidence range, and pillar breakdown
Screenplay metadata	Title with year, page count, genre, content type
Scene search	Semantic search over your uploaded screenplay text

All tools are read-only. The connector cannot upload scripts, start analyses, change settings, or spend credits. Claude never sees another user’s scripts.

Example prompts

Use these after the connector is connected:

• List my completed Quilty analyses and give me the Quilty Score for each.
• Open the manifest for analysis 1234, then read the story-craft section.
• Search my screenplay for scenes that introduce the antagonist.
• What does the Quilty Score say about confidence and pillar breakdown?

Replace 1234 with an id from the list-analyses result.

Privacy and revoke

Connecting Claude authorizes that client to request analyses you already own. Quilty returns only your data. Conversation handling after that is covered by Anthropic’s privacy policy.

• Revoke a personal token at Settings → Claude connector.
• Disconnect the Claude.ai listing from Customize → Connectors.
• Full policy: Quilty Privacy Policy.

Troubleshooting

Claude says it cannot see any analyses. You need a completed analysis on the account you signed in with. Previews and in-progress jobs are not exposed.

Directory listing asks you to log in and then fails. Confirm you are signing into Quilty (not only Claude) on the consent screen, then retry Connect.

Desktop or Claude Code returns 401. The token was copied incompletely, expired, or revoked. Mint a new one and replace the header / AUTH_HEADER value.

You pasted a token into Claude.ai. You do not need to. Remove the custom header and use the directory listing so Claude can sign in with OAuth.

Where to go next

• Claude directory listing
• Claude connector docs
• Settings → Claude connector
• What is the Quilty Score?