# Kopai Cloud

Send telemetry to Kopai Cloud and set up your team

Kopai Cloud is the hosted backend. Your app sends telemetry to a managed endpoint and your whole team reads it in one dashboard at `app.kopai.app`. It is free while in alpha, no credit card.

## Prerequisites

- An application instrumented with OpenTelemetry. The [Quickstart](/quickstart/) is the fastest way: your agent sets it up and tests it locally first. [Manual Setup](/manual-setup/) covers hand-wiring.

## Step 1: Create an Account

Sign up at [app.kopai.app/signup](https://app.kopai.app/signup). You sign in with a magic link sent to your email.

## Step 2: Generate a Backend Token

Your app authenticates to Kopai Cloud with a backend token. Creating tokens requires the owner or admin role.

1. Open **Settings** → **Access Tokens** in the dashboard
2. Click **Generate Token** and choose **Backend Token**
3. Copy the token. It is shown once.

Building a browser app? Use a **Frontend Token** with allowed origins instead. The [browser guide](/integration/languages/browser) covers that setup.

## Step 3: Point Your App at Kopai Cloud

Set two environment variables for your instrumented app:

```bash
export OTEL_EXPORTER_OTLP_ENDPOINT="https://otlp-http.kopai.app"
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer YOUR_BACKEND_TOKEN"
```

Your instrumentation stays identical to local. Only the endpoint and the auth header change.

## Step 4: Verify Ingestion

Open [app.kopai.app/observability](https://app.kopai.app/observability) and confirm traces, logs, and metrics are arriving from your app.

## Step 5: Invite Your Team

1. Go to **Team** in the dashboard
2. Click **Invite Member**

Invited members get the member role. They can read all telemetry. Creating tokens stays with owners and admins.

## Step 6: Authenticate the CLI

The CLI queries Kopai Cloud with its own read-only token. An owner or admin creates it:

1. Open **Settings** → **Access Tokens**
2. Click **Generate Token** and choose **CLI Token**
3. Copy the token

Then log in:

**npm:**

```bash
npx @kopai/cli login
```

**pnpm:**

```bash
pnpm dlx @kopai/cli login
```

**yarn:**

```bash
yarn dlx @kopai/cli login
```

Paste the token at the prompt. The CLI saves it to `./.kopairc` with the server URL `https://api.kopai.app/v2`. See [CLI authentication](/authentication/#cli-authentication) for flags, expiry, and logout.

## Next Steps

- [Authentication](/authentication/) — Token types, best practices, and the CLI config file
- [AI Agent Skills](/skills/) — Let your coding agent instrument apps and query telemetry