Connect Spexus to your AI agent

Spexus integrates with AI agents through MCP and passes epics, user stories, requirements, acceptance criteria, and steering documents without manual copy-paste.

Step 1: Download Spexus MCP

Download the archive from the releases page and unpack the binary into a convenient directory such as `/usr/local/bin/`.

OS File
macOS (Apple Silicon) rms-ai-darwin-arm64.tar.gz
macOS (Intel) rms-ai-darwin-amd64.tar.gz
Linux (x64) rms-ai-linux-amd64.tar.gz
Windows rms-ai-windows-amd64.zip
tar -xzf rms-ai-darwin-arm64.tar.gz
mv spexus-mcp /usr/local/bin/spexus-mcp

Step 2: Initialize the client

On first launch, run the initialization and provide the server address `https://app.spexus.ai`, your username, and your password.

/usr/local/bin/spexus-mcp -i

Step 3: Connect it to your AI agent

Claude Code
claude mcp add spexus /usr/local/bin/spexus-mcp

Verification: ask the agent to show the list of epics.

OpenAI Codex CLI
codex mcp add spexus /usr/local/bin/spexus-mcp

Verification: ask Codex to show the list of epics.

OpenCode
opencode mcp add

Follow the wizard and provide `/usr/local/bin/spexus-mcp` as the command.

Other AI agents
{
  "mcpServers": {
    "spexus": {
      "command": "/usr/local/bin/spexus-mcp",
      "args": [],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Cursor: `.cursor/mcp.json`, Windsurf: `.windsurf/mcp.json`.

Step 4: Verify the connection

Launch your AI agent and ask: "Show the epics from Spexus." If everything is configured correctly, the agent will call the MCP server and return the list of epics.

Step 5: Give the agent its first task

Now you can immediately use the connection in real work. Ask the agent: "Create a new epic on the topic of ..." and then describe what you want to build, what result you need, and which context matters.

Create a new epic on the topic of ...

If MCP is configured correctly, the agent can create a new epic directly in Spexus and start refining the requirements in dialogue.

What the AI agent gets after connection

Capability Description
Read epics and user stories Full product context: what we are building and why
Read requirements and acceptance criteria Detailed specifications for code generation
Read steering documents Architecture, code style, and team standards
Create and update entities Refine requirements directly in dialogue with AI
Search the full knowledge base Fast lookup for the right context
Inspect the hierarchy Complete epic view: stories -> requirements -> acceptance criteria

Usage examples

"Create a user story for PDF report export inside epic EP-093"

"Review requirements for US-354 and implement the Hero section component for the homepage"

"Check the current code against acceptance criteria AC-1160"

Troubleshooting

Problem Fix
Server does not start Check execution permissions: `chmod +x /usr/local/bin/spexus-mcp`
The agent cannot see the tools Restart the agent after adding the configuration
Connection error Verify the path to `spexus-mcp` or add the binary to PATH