Quickstart

Three ways to get data into Trefur, none of which installs anything from us. Start with whichever matches what you run; you can add the others at any time.

1. Connect your AI platforms

Sign in to app.trefur.com (a workspace is created for you), open Sources → Connections and pick a platform: Google Workspace, Microsoft 365, OpenAI, Anthropic, Slack and more. You approve read-only access on the platform's own consent screen, and the first scan starts straight away.

Integrations lists every platform and what each connection shows.

2. Send OpenTelemetry traces

Any OpenTelemetry SDK or collector can send traces to Trefur over OTLP/HTTP, with a protobuf or JSON body. First create a telemetry key:

  1. Sign in to app.trefur.com and choose Add agent.
  2. Name the agent, answer where it runs, and choose Continue.
  3. Open Advanced: use a telemetry key, then choose Create a telemetry key.
  4. Copy the key. It is shown once, belongs to this agent alone and expires in 90 days.
Treat the key as a secret. Keep it in your platform's secret store or environment, never in source.

Then point your trace exporter at Trefur:

export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://api.trefur.com/v1/traces
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="Authorization=Bearer%20trf_obs_..."

Or, in an OpenTelemetry Collector:

exporters:
  otlphttp/trefur:
    traces_endpoint: https://api.trefur.com/v1/traces
    headers:
      authorization: "Bearer trf_obs_..."

Spans that follow the OpenTelemetry GenAI semantic conventions need no mapping. The API reference has the endpoint's full contract.

3. Turn on Claude Code telemetry

Claude Code exports its own usage metrics and API request events over OpenTelemetry. Create a telemetry key as above for an agent named, for example, claude-code, then set:

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=https://api.trefur.com/v1/metrics
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=https://api.trefur.com/v1/logs
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer trf_obs_..."

Claude Code covers what Trefur records and how to roll the settings out to a team.

4. See it in Trefur

Open app.trefur.com. After you create a telemetry key, the app waits for the agent's first event and shows when it arrives.

What's next?