Troubleshooting

Fix a failed connect, sign-in, or question.

Connect

Start in your client. Overdrive opens its authorization page. Sign in with the email magic link, then click Allow.

Deny refuses the connection. To reconnect, start Connect again. There is no path that skips the email link and goes straight to Allow.

Collector and hook

The collector refuses redirects (_NoRedirect), and the hook's urllib POST does not follow 307/308. After the host move, reinstall so uploads go to https://mcp.useoverdrive.ai, not the previous MCP host.

Collector ingest: https://mcp.useoverdrive.ai/collector/v1/requests. Hook events: https://mcp.useoverdrive.ai/hooks/v1/events. Get a new ingest token at Connect, then run the install again.

Magic link

Claude Connect uses this path. Overdrive does not have a separate password account.

The client starts Connect.
Enter your work email. That sends one link.
Open the link. It is on https://mcp.useoverdrive.ai/a/{id}.
Confirm on that page.
Click Allow. Overdrive returns you to the client.

The link lasts 10 minutes and works once.

If Overdrive says the link is not valid, has expired, or was already used, go back to Connect and request a new link. Do not reuse the old one.

Confirm in the browser that opened the email link. If Overdrive says to open the link in the browser where you started connecting, request a new link.

Too many sign-in emails returns 429. Wait, then request one new link from Connect.

Tokens

Access token: 1 hour.
Refresh token: 14 days, rotating.

Revoke

Disconnecting Overdrive in Claude does not end the Overdrive session. There is no /oauth/revoke endpoint.

Overdrive logout is POST /logout for this sign-in, or POST /logout/all for every session on that sign-in, on https://mcp.useoverdrive.ai. Those routes use the Overdrive sign-in session, not the Claude disconnect control.

After Overdrive logout, the next MCP call with the old access token is 401. Logout does not delete a pack or usage. On Connect, Turn off stops new data from a connection (stored usage stays up to 90 days). Delete data removes that connection and the usage rows it stored. See Privacy.

Packs

Bring your own operating data through agent fields or a CSV, then call load_pack.

northline and halyard are sample packs for a tour. They are not a product limit.

A temporary allowlist may still limit which pack names the live host accepts.

Ask

ask reads the loaded pack. Sales, finance attribution, and product need period as YYYY-MM-DD:YYYY-MM-DD. Operational questions need before and after in that same shape. Overdrive will not invent the dates.

If the pack name does not load, ask stops. It does not answer from northline or halyard instead. If no pack is loaded, ask tells you to call load_pack first.

Session

Overdrive answers from the pack loaded for this sign-in. This page does not claim that a shared host isolates every customer.