> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ref.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# Warp OZ

> Launch Warp OZ agents from Ref Plans.

Warp OZ integration lets you launch Warp OZ agents directly from your plans and track their progress.

## Install the Ref MCP server in Warp OZ

Give Warp OZ access to your plans and tasks by connecting the **Ref Plans MCP server** with the streamable HTTP endpoint `https://api.plan.ref.tools/mcp`. Full steps for installing the MCP server, including API key setup, are in the **[Ref Plans MCP install guide](/plans/install/index)**.

This will allow Warp OZ agents to send messages back to a Ref agent orchestrator.

## Connect Warp OZ

1. Go to **Settings** in Ref Plans
2. Click the **Agent Settings** tab
3. Select the **Warp OZ** tab
4. Paste your Warp API key
5. Optionally enter an **Environment ID**

Warp API keys start with `wk-...`. In the Warp desktop app, open **Settings > Platform** and create an API key.

Most users with a single environment can leave **Environment ID** blank.

## Launch an agent

1. Open your plan and select a task
2. Click **Launch Agent** and choose **Warp OZ**
3. Review the prompt — Ref pre-populates it with the task details
4. Click **Launch**

## Status tracking

Ref tracks the Warp OZ agent status:

* **Working** — The agent is actively implementing the task
* **Finished** — The agent has completed its work
* **PR Created** — A pull request URL is shown when the agent creates one

You can monitor agent progress directly from your plan without switching to Warp.

## Get help

If you have any issues, please reach out to `help@ref.tools`. We're happy to help you get started!