# Linear

This guide walks through connecting Linear to DuploCloud by registering the Linear MCP server, adding a provider, configuring credentials with your Linear API key, creating a scope, and querying Linear data through the AI agent.

***

## Step 1 — Generate a Linear API Key

In Linear, open the workspace menu (top-left) and click **Settings**.

![Linear settings menu](/files/2EhwI5mBviOMPwQynsFW)

Navigate to **Security & access** in the left sidebar. Scroll down to the **Personal API keys** section and click **New API key**. Give it a name, click **Create**, and copy the generated key — it is only shown once.

![Personal API keys section with key created](/files/WdKJozzQxGuF9YVz6dKJ)

***

## Step 2 — Register the Linear MCP Server

In DuploCloud, go to **AI Admin** → **MCP Servers** and click **+ Add Server**.

![MCP Servers list](/files/9SwjiMZBO4Ky62Rq1NTD)

Fill in the MCP server details:

* **Name** — e.g. `Linear`
* **Provider Type** — select **Other**, then type `other` in the **Specify Provider Type** field
* **API Endpoint** — `https://mcp.linear.app/mcp`

![Add MCP Server form](/files/5XDr2feVbTxloMbgm8ug)

Click **Create**.

***

## Step 3 — Add a Linear Provider

Go to **AI Admin** → **Providers** → **IT** and click the **Other** tab.

![Other providers list](/files/GQEnCgBP6Qwpb2F6wca9)

Click **+ Add** and fill in:

* **Name** — e.g. `Linear`
* **Type** — select **Other**
* **Account ID** — any identifying label; Linear does not require a specific account ID so this field can be set to any value

![Add Provider form](/files/RhkXsM79GqXJUsOixR18)

Click **Create Provider**.

***

## Step 4 — Add Credentials

The new provider opens on the **Credentials** tab. Click **+ Add** and fill in:

* **Name** — e.g. `Linear-credentials`
* **Key** — `LINEAR_API_KEY` (this is the only accepted key name for Linear credentials)
* **Value** — paste the API key copied from Linear in Step 1
* **Sensitive** — toggle on to store the key securely

![Add Credential form](/files/y9nlMRLYP5DiGq6swZ9l)

Click **Create**.

***

## Step 5 — Add a Scope

Switch to the **Scope** tab and click **+ Add**. Fill in:

* **Name** — e.g. `Linear-Test-MCP`
* **Credential** — select the credential created in Step 4
* **MCP Server** — select the Linear MCP server registered in Step 2
* **Resource Map** — add two keys:
  * `Authorization` → your Linear API key value (note: the key name is case-sensitive — use `Authorization` exactly as written)
  * `type` → `http`

![Add Scope form](/files/Q0rii30y6E797v3EoWzB)

Click **Create**.

***

## Step 6 — Use Linear in a Ticket

Go to **AI DevOps** → **HelpDesk** → **Add Ticket**. Select **generic-agent** and choose your Linear scope from the scope dropdown.

![Selecting the Linear scope in a ticket](/files/Al9TCpH4JvMVtz2fX4gp)

Enter your request — for example, asking the agent to list your issues.

![Ticket with Linear prompt entered](/files/N3iPGjRfrAjfGlXhjtVj)

Click **Create Ticket**. The agent connects to Linear via the MCP server and returns the results.

![Agent querying Linear issues](/files/sf1hvgoXyg4bJrERFnyh)

![Linear issues listed by the agent](/files/vRicNkZZusuAdGaV4mla)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.duplocloud.com/docs/getting-started/integrating-mcp-servers/linear.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.