Quickstart: MCP Server for Repo Maintenance

Prereqs: Nix with flakes enabled and Codex CLI installed locally.
Install: nix profile install .#nixos-mcp (or nix develop .#mcp for a dev shell).
Run tests: ./scripts/mcp-server/run-tests.sh.
Launch MCP server: nixos-mcp (stdio mode).
Connect Codex CLI: Ensure .codex/config.toml points to nixos-mcp and .codex/requirements.toml allowlists it, then list tools via the MCP client to verify catalog.
Docs alignment: If adding/updating tools, run sync-docs to confirm docs match; update docs/ MCP section accordingly.
CI behavior: Gitea runs lint/format/tests when scripts/** or docs/** change; fix failures before merging.