---
title: "Quick start | Annsa Docs"
product: annsa
url: /docs/quick-start
canonical_url: "https://annsa.ai/docs/quick-start"
last_updated: 2026-11-09
type: doc
related:
  - /docs/using-with-coding-tools
  - /feedback
summary: "Start from your agent: connect Claude Code, Cursor, Codex or Grok, ask what to work on, bring in what you know and make your first call."
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.

# Quick start | Annsa Docs

> Start from your agent: connect Claude Code, Cursor, Codex or Grok, ask what to work on, bring in what you know and make your first call.

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

Connect your agent, ask what to work on, make your first call.

## 01 Connect your agent

`claude mcp add --transport http annsa https://app.annsa.ai/mcp`

Run it in your terminal. Then, in Claude Code, run /mcp, pick annsa and choose Authenticate.

Cursor or VS Code? Add it in one click:

- [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=annsa&config=eyJ1cmwiOiJodHRwczovL2FwcC5hbm5zYS5haS9tY3AifQ%3D%3D)
- [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22annsa%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapp.annsa.ai%2Fmcp%22%7D)

Pick your agent on [Connect your agent](https://annsa.ai/docs/using-with-coding-tools) and run its command. You sign in once in the browser, and there's nothing to install. Your agent signs in as you. Read about [the two kinds of sign-in](https://annsa.ai/docs/agent-access) and [who does what](https://annsa.ai/docs/how-the-work-flows#who-does-what).

Paste this to your agent and it sets itself up.

`Set up Annsa for this agent using annsa.ai/setup.md, then start the sign-in.`

## 02 Choose what runs without asking

Five Annsa tools can change things. Let `annsa.work` and `annsa.file` run without asking. Approve `annsa.decide`, `annsa.board` and `annsa.share` each time, because they change what you decided or what your customers hear.

Allow without asking:

- `annsa.work`: Do the work on a priority, and settle routine asks with undo.
- `annsa.file`: Add what a customer said, what an agent found, or a new idea.

Approve each time:

- `annsa.decide`: Record a decision: your answer, a spec edit, or a rule.
- `annsa.board`: Arrange the board. A merge retires numbers for good.
- `annsa.share`: Tell the customers who asked that it shipped. Emails can't be unsent.

The reads (`annsa.priorities`, `annsa.spec`, `annsa.ask`) change nothing, so allow those too. [Every tool](https://annsa.ai/docs/tools-and-verbs).

**Your call:** what your agent does without asking.

## 03 Your agent learns the ropes

When it connects, your agent fetches Annsa's skills: how to work with Annsa, how to write its part of a spec, and how to ask you. [Read them](https://annsa.ai/docs/working-with-annsa).

## 04 Ask what to work on

Ask your agent: _what should I work on?_ It gets your ranked list. Each priority shows why it ranks where it does, who asked, and what's waiting. On a new workspace, it starts with a welcome instead.

## 05 Bring in what you know

Connect where your customers already talk to you, import your roadmap and add your ideas. Your agents add what they find while they build. It all lands in one list. [Bring things in](https://annsa.ai/docs/importing-feedback).

**Your call:** where to start.

## 06 Connect GitHub

This step is optional. You can do it later. Connect your repository so specs name real files and your work stays linked to its PRs. Annsa never writes code. [GitHub](https://annsa.ai/docs/github).

## 07 Make your first call

Annsa ranks the work and shows why. You choose: put a priority on a bet, sign it, or park it with a reason.

**Your call:** what's worth building now.

## 08 Hand it to your agent

Tell your agent to pick it up. It claims the priority, reads the spec, builds, and asks you when a call is yours. [How the work flows](https://annsa.ai/docs/how-the-work-flows).

- [How the work flows Importing feedback](https://annsa.ai/docs/how-the-work-flows)

## Keep reading

- [Connect your agents and sources](https://annsa.ai/guides/mcp-server-for-product-management)
- [Connect your agent](https://annsa.ai/docs/using-with-coding-tools)
- [Customer feedback tool](https://annsa.ai/feedback)

## Related pages

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

- [Connect your agent](https://annsa.ai/docs/using-with-coding-tools)
- [Customer feedback tool: who asked, what shipped](https://annsa.ai/feedback)

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