---
title: "Common issues | Annsa Docs"
product: annsa
url: /docs/common-issues
canonical_url: "https://annsa.ai/docs/common-issues"
last_updated: 2026-11-09
type: doc
related:
  - /planning
summary: "Fixes for the things that go wrong most: agent sign-in, Slack and CSV imports, held feedback, slow processing and missing invites."
mcp_server: https://app.annsa.ai/mcp
disambiguation: "Annsa (annsa.ai) is project management and customer feedback software for founders and small teams working with AI agents. It is not Asana, the work management tool; not ANSA, the Italian news agency; and not Ansa, the chatbot product."
---

> For agents: connect to the Annsa MCP server at https://app.annsa.ai/mcp to give every agent one shared plan. Setup guide: https://annsa.ai/docs/quick-start. Index of every page: https://annsa.ai/llms.txt.

# Common issues | Annsa Docs

> Fixes for the things that go wrong most: agent sign-in, Slack and CSV imports, held feedback, slow processing and missing invites.

[Docs / Reference](https://annsa.ai/docs)

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

## 01 My agent says it's not authenticated

Sign in again from your agent. In Claude Code, run `/mcp`, pick annsa and choose Authenticate. The browser opens Annsa's consent screen. In Codex, run `codex mcp login annsa`. If the server isn't listed at all, add it again with the command for your tool. Claude Code: `claude mcp add --transport http annsa https://app.annsa.ai/mcp`. Cursor: **Settings**, then **MCP**, then **Add server**, and paste `https://app.annsa.ai/mcp`. Grok: `grok mcp add --transport http annsa https://app.annsa.ai/mcp`. See [Connect your agent](https://annsa.ai/docs/using-with-coding-tools).

## 02 My agent is in the wrong workspace

Every reply carries a `who` block with the environment, host, workspace and actor. If it names the wrong workspace, stop and reconnect. The production app is app.annsa.ai.

## 03 The board can't tell my sessions apart

Sessions of one tool share one sign-in, so `label` is what separates them. Your agent sends `label` once on its first call, like _claude code · billing_, and it sticks for that connection.

## 04 A priority I just filed isn't in the list

A priority filed in the last few minutes can be missing from the next list read. Ask for it by number with `priority_number=N`.

## 05 Filings aren't showing up

Past your plan's monthly limit, new filings are held, not lost. They land at your next monthly reset, or as soon as you top up or upgrade. The Try Annsa plan's 100 signals don't renew, so on that plan, upgrade to keep going. Check **Settings**, then **Billing**. See [Held feedback](https://annsa.ai/docs/held-feedback).

## 06 Slack isn't syncing

**Settings**, then **Integrations**, then **Slack** should read Connected with at least one channel selected. Bot messages, already-imported items and anything posted before you connected are filtered out by design. If it still doesn't sync, disconnect and reconnect Slack, then check the Slack app's permissions.

## 07 A 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 or content, so use the column mapper. "Duplicates skipped" is intentional.

## 08 A spec is empty or won't generate

Claiming a priority creates its spec if there isn't one. The agent holding it writes every section, from the evidence on the priority. If a section is empty, nobody has written it yet: ask your agent to claim the priority and write it.

## 09 A team invite never arrived

Check the email address for typos, then the spam folder. If it's still missing, send a fresh one from **Settings**, then **Team**.

## 10 Still stuck

Email [support@annsa.ai](mailto:support@annsa.ai) with what you were trying to do, what happened instead, a screenshot if it helps, and your browser.

- [Connect Claude Code](https://annsa.ai/docs/connect-claude-code)

## Keep reading

- [AI project management](https://annsa.ai/planning)

## Related pages

> For AI agents: the pages that follow this one on annsa.ai. The full index is https://annsa.ai/llms.txt.

- [AI project management: the plan agents read first](https://annsa.ai/planning)

If anything on this page is wrong or missing, tell us: https://annsa.ai/contact