Support
Fixes for the problems people hit most, and how to reach us.
Find your problem below; most fixes take a minute. Your API keys are in the dashboard, and setup steps for each client are in the guides for Claude Code, Codex and Cursor.
Fix your first install
The tools don't appear in my agent
Fully restart the client after installing. In Claude Code, quit and reopen it (in VS Code, run Developer: Reload Window); reloading plugins alone keeps the old MCP server running. Then check the key is set: in the plugin's settings, in your MCP config, or saved once with:
npx -y --package=@thedesignagent/mcp thedesignagent login
"Invalid API key" or "Authorization header is required"
The key is missing, mistyped or revoked. Check or create a key, then send it as Authorization: Bearer tda_... or X-Api-Key: tda_... for the hosted server, or as THEDESIGNAGENT_API_KEY for the local one.
The local server won't start
The package has two commands, so name the one you want. A bare npx @thedesignagent/mcp won't start; use:
npx -y --package=@thedesignagent/mcp thedesignagent-mcp
The first Discover asks for setup
That's expected for a new project. Your agent scans the repo, sends a project model and calls again. After that, briefs come back straight away.
Other problems
Out of credits
Buy a pack or turn on auto-recharge in the dashboard. Agents can buy credits themselves over MPP: see llms.txt.
Visual says "local install required"
The hosted server reviews public pages and preview deploys, but it can't reach localhost. Install the Claude Code plugin or run the local server, or deploy a preview and pass its URL.
Visual stopped at a login page
Nothing was charged. For a protected Vercel preview, pass your Protection Bypass for Automation secret. For your own app, follow the session instructions in the response, which save a login on your machine.
No review on my pull request
Reviews run when a preview deploy finishes, on pull requests that change an App Router page. In GitHub reviews, check the installation is linked and the repo is enabled. If the PR's comment says login required, add your Vercel Protection Bypass for Automation secret to that repo there.
Rate limited
Wait a moment and retry. Your agent can read _meta.tda_retry_ok to know when a retry is safe.
Contact us
Email thedesignagent@borntall.com. We're a small team and usually reply within 3–5 business days. Please include:
- What you were doing, and the tool involved: Discover, Ux or Visual.
- Your client and how you installed TheDesignAgent: Claude Code plugin, hosted MCP, npm package, CLI or GitHub App.
- The first characters of your API key (for example
tda_ab12) and your project id from.thedesignagent. Never send a whole key. - The message your agent got back, and roughly when it happened.
Billing, privacy and security
- Billing questions and refunds: email us with the date and amount of the purchase.
- Export or delete your data: email us from your account's address. See the privacy policy.
- Security issues: email us with "Security" in the subject. Please give us a chance to fix a problem before disclosing it.
Guides for agents and CI: install and tools overview, the npm package README, the Claude Code plugin and the pull request gate (GitHub App or Action). Terms of use are in our terms of service.