Skip to content
Browse docs
Docs / Connect your agent

Connect your agent

One URL, a sign-in in the browser. Nothing to install.

01 One server for every agent

Annsa is a remote server at https://app.annsa.ai/mcp. Every agent uses the same URL. Only the way you add it differs. Your agent gets eight tools. Three read: your ranked priorities, the spec for a priority, and questions you ask about your feedback, customers and Annsa. Five act, split by how much they can change, so you can allow annsa.work and annsa.file without asking and approve the other three. Every tool.

02 Pick your agent

# Claude Code
claude mcp add --transport http annsa https://app.annsa.ai/mcp

# Grok
grok mcp add --transport http annsa https://app.annsa.ai/mcp
  • Cursor: Settings, then MCP, then Add server, and paste https://app.annsa.ai/mcp
  • Codex: run codex mcp add annsa --url https://app.annsa.ai/mcp. It opens your browser to sign in. If it doesn't, run codex mcp login annsa. More on Codex

Claude Code · Cursor · Codex · Grok

Other clients take the same URL: ChatGPT, Windsurf, Figma Make, Lovable and Bolt.

03 Sign in

The first call opens a consent screen in your browser. Approve once. There's no API key to paste. The two kinds of sign-in are explained in What your agent can do.

04 What your agent reads when it connects

Your agent starts with Annsa's own guide to working with you: check the workspace, pick work, what it may do alone, prove it shipped. You can read it in For your agent.

05 If it doesn't connect

Most clients load servers when a session starts, so a server added mid-session needs a new session. If a call says unauthorized, reconnect from the client's MCP settings instead of retrying. Each agent page has its own fix, and there's more in Common issues.

Next guideQuick start