Skip to content
Docs · Foundation · 4 min

Common Issues

The things that most often go wrong, and what to check first.

01Slack isn't syncing

Check Settings → Integrations → Slack reads Connected and at least one channel is selected. Polling runs every 10 minutes, so allow for that. Bot messages, already-imported items and anything posted before you connected are filtered by design. Still stuck: disconnect, reconnect, and check the Slack app permissions.

02A CSV won't import

"Invalid format" usually means the wrong extension, semicolons instead of commas, non-UTF-8 encoding or a missing header row. "Column not found" means your headers don't match feedback / text / message / content — use the column mapper. "Duplicates skipped" is intentional. Over 10,000 rows, split the file.

03The survey isn't showing up

Check the script tag is in your HTML, ideally before </body>, and that the API key in it matches your Survey settings. No CORS setup is needed — it works from any domain. Then open dev tools and read the console.

04A spec won't generate

It needs feedback, so import some first. Files to Touch specifically needs GitHub connected. If the spec comes out empty, click Refresh — and if it's still empty, that priority needs more feedback behind it.

05Priorities look stale

They move when new feedback is imported and grouped, which happens automatically. Give processing a few minutes, and if items still read as processing, let them finish.

06MCP won't authenticate

"Not authenticated": re-authenticate from your client (in Claude Code, /mcp → annsa → Authenticate) — the browser reopens Annsa’s consent screen. "MCP not found" in Cursor: Settings → MCP → Add server → paste https://app.annsa.ai/mcp. In Claude Code: claude mcp add --transport http annsa https://app.annsa.ai/mcp.

07Search finds nothing

Two characters minimum. Search is semantic, so try a synonym — "slow" reaches performance and latency. If it's still empty, check there's feedback in the system and broaden the terms.

08You've hit the usage limit

Check Settings → Billing. Upgrade, buy a $9 top-up to process the queue now, or wait — queued items carry forward and process when the next month starts. Nothing is lost.

09Processing feels slow

Classification runs 1–2 seconds an item, clustering 5–30 seconds depending on volume, and spec generation 5–15 seconds. Imports over 1,000 items take several minutes, with progress shown.

10A team invite never arrived

Check the spelling, then the spam folder. If you're at the seat limit — 2 on Starter, 5 on Pro, 10 on Max — invites are blocked until you upgrade. Invites also expire after 7 days; send a fresh one from Settings → Team.

11Undo isn't available on a CSV import

Only the most recent CSV upload can be undone, and only from the completion screen right after upload. Navigate away, or upload another CSV, and the option is gone. It doesn't apply to Google Sheets or manual entry.

12A classification correction didn't take

Corrections apply to future feedback on the same theme — existing items on other priorities aren't reclassified. If the new feedback is worded very differently it may not match; correct it again and Annsa learns the broader pattern.

13Still stuck

Email support@annsa.ai with what you were trying to do, what happened instead, a screenshot if it helps, and your browser and device. Replies come within 24 hours.

annsa

Start building from signal.

Solo-founded in Sydney in 2025. Launched February 2026.