Skip to content
Browse docs
Docs / Connect your agent

Connect Grok

One command and a sign-in. Grok is good at reading your work and filing what it finds.

01 Run this

Run once:

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

Then sign in when the browser opens. If it doesn't open, reconnect from Grok's MCP settings. Nothing installs.

02 Sign in

The first call opens a consent screen in your browser. Approve once. There's no API key to paste. Grok signs in as you, with your full rights. See What your agent can do. All Grok sessions share this sign-in.

03 Check it worked

Ask Grok for your priorities. The reply names the environment, host and workspace. It should say production, app.annsa.ai and your workspace. If it says anything else, stop and fix the connection before your agent writes anything.

04 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.

Your call: what your agent does without asking.

05 Try this first

Ask: what should I work on? If you use Grok to review rather than build, try: review this change and file what you find in Annsa. Grok first looks for an existing priority, so a repeat finding attaches to it. It then files the finding with a severity from P0 to P3 and a one-line reason. On an agent credential, that severity is a proposal until you confirm it.

06 If it doesn't connect

Tools missing: run the add command again and start a new session, because most clients load servers when a session starts.

Unauthorized or expired: reconnect Annsa from Grok's MCP settings. Don't retry the same call.

Empty list: a new workspace has nothing to rank yet. Bring in your feedback.

Next guideConnect your agent