Integrations

Trace is the evidence layer — other Molar products produce traces; Trace consumes, displays, and shares them. Third-party tools connect via CI ingest, GitHub App, Slack unfurl, and the public MCP surface.

Molar platform

Guard + Mender (native)

Setup: Enable trace capture in Guard project settings when auto-capture ships (default on for new projects). Today: @molar/trace-capture on Cartographer runners or POST /v1/traces/ingest.

Deep link: GitHub check annotation → trace.molar.it/traces/{id} with failure step selected.

Tag line: failure → trace → mender.

Cartographer (agent runs)

Cartographer exports Playwright tests from discovered flows; Guard runs those tests; Trace captures the Guard execution. Cartographer itself can also emit traces during exploratory crawls.

Capture is provided by the @molar/trace-capture package — installed with the CLI and Guard runner.

Clones (state panel)

Trace shows what each clone returned during the run. Layer 2 replay calls POST /api/clones/world/restore — impossible without Molar-owned simulators.

Molar dashboard (app.molar.it)

• One sign-in across Guard, Cartographer, Clones, and Trace
• App switcher and shared run history
• Central hub: recent failures, shortId search — deep links into Trace
• Billing and usage on one invoice for bundle orgs

MCP at mcp.molar.cloud exposes Trace tools alongside Cartographer, Guard, and Clones — see the capability manifest at docs.molar.it/.well-known/molar-capabilities.json.

CI systems

Playwright (first-class)

// Automatic when using @molar/trace-capture with Guard/Cartographer runner
import { startTraceCapture } from "@molar/trace-capture";

await startTraceCapture({ scenarioSlug: "checkout-stripe" });
// ... test ...
await finalizeTraceCapture();

Artifacts uploaded to object store; dashboard row appears within seconds of run end.

Manual ingest after CI:

# Upload bundle from CI artifact
curl -X POST "$TRACE_API/v1/traces/ingest" \
  -H "Authorization: Bearer $MOLAR_API_KEY" \
  -F "bundle=@trace-bundle.tar.zst" \
  -F "scenario_slug=checkout-stripe" \
  -F "source=ci" \
  -F "commit_sha=$GITHUB_SHA"

Cypress

GitHub Actions

Pattern:

1. Guard action or molar run completes
2. Workflow uploads trace bundle OR relies on automatic cloud capture
3. gh pr comment with trace short_id link
4. Check run annotation includes "Open trace"

Example annotation URL: https://app.molar.it/r/xY9zQ2mNp

GitHub App

Important: Debugger uses the GitHub App installation token — not the user's login OAuth token. Prevents confused-deputy when user OAuth would be over-scoped.

Install: Org settings → Integrations → GitHub → select repos.

Slack

Configure when shipped: Trace settings → Integrations → Slack → OAuth to workspace.

Linear / Jira

No native bi-directional sync in v1 — use public share links:

1. Share modal → public-read, 7-day expiry, hide Debugger
2. Paste https://app.molar.it/r/{shortId} into ticket
3. Embed mode: /r/{shortId}/embed for iframe in Linear document

MCP (coding agents)

Endpoint: https://mcp.molar.cloud (OAuth 2.1 + PKCE)

Scopes:

Claude Code / Cursor install:

{
  "mcpServers": {
    "molar": {
      "url": "https://mcp.molar.cloud",
      "auth": "oauth"
    }
  }
}

Solo dev: PAT or static org token on standalone Cartographer MCP (local only — not production).

Agent workflow example:

1. CI fails → agent receives short_id in check output
2. get_trace → signed URLs + failure summary
3. molar_debug_run → ask "why did step 7 fail?"
4. Engineer patches locally → molar_replay_trace from step 6
5. Human promotes to Mender

External observability

Trace captures synthetic test runs with Clone state and Layer 2 — complement your existing monitoring stack. Export of trace summary.json via webhook is available from the Trace API.

For production incidents, link Guard prod-monitor traces — same viewer, source=schedule.

EU data residency

Pin workspace to eu-west-1 (Team+): workers, S3 bucket, and Debugger API calls stay in-region (. Share links still work globally but data at rest remains EU when enabled.

Integration checklist

See Quick start and Workers & ingestion for pipeline details.