> ## 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.

# Devin

> Launch Devin sessions from Ref Plans.

Devin integration lets you launch Devin sessions directly from your plans and track their progress.

## Install the Ref MCP server in Devin

Give Devin access to your plans and tasks by connecting the **Ref Plans MCP server** in Devin’s MCP marketplace (streamable HTTP endpoint `https://api.plan.ref.tools/mcp`). Full steps—URL, API key header, and plan-specific URLs—are in **[Connect Devin to Ref Plans](/plans/install/devin)**.

This will allow Devins to send messages back to a Ref agent orchestrator.

## Connect Devin

1. Go to **Settings** in Ref Plans
2. Click the **Agent Settings** tab
3. Select the **Devin** tab
4. Enter your Devin API key

## Launch an agent

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

## Status tracking

Ref tracks the Devin session status:

* **Working** — The session is actively running
* **Blocked** — The session needs input or has encountered an issue
* **Finished** — The session has completed its work
* **Expired** — The session has timed out

You can monitor session progress directly from your plan without switching to the Devin dashboard.

## Get help

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