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

# Connect the Linear MCP server

> Connect Linear's hosted MCP server to Spojit with OAuth or an API key, including the read-only endpoint, to find, create, and update issues and projects.

Linear hosts an MCP server with tools for finding, creating, and updating issues, projects, and comments. Connect it to Spojit to open issues from support tickets, move work between states, or report on a cycle from a workflow.

<Note>
  Spojit connects to this server through a [custom MCP server](/connectors/remote-mcp-servers/custom) connection, so you add it with **Add custom server** rather than from the connector catalog. Linear maintains it and decides which tools it offers; see [Linear's MCP documentation](https://linear.app/docs/mcp) for the current list.
</Note>

## Before you start

* A Linear account in the workspace you want to connect. Each connection is tied to one workspace; to use another, add a second connection.

## Server URL

| Access         | URL                                   |
| -------------- | ------------------------------------- |
| Read and write | `https://mcp.linear.app/mcp`          |
| Read only      | `https://mcp.linear.app/mcp/readonly` |

## Connect in Spojit

<Steps>
  <Step title="Add a custom server">
    Go to **Connections** and click **Add custom server**. Enter a **Name** such as `Linear` and paste the **Server URL**.
  </Step>

  <Step title="Keep Auto authentication">
    Leave **Authentication** on **Auto**, choose a visibility, and click **Save & connect**.
  </Step>

  <Step title="Approve access in Linear">
    Linear opens its authorization page. Choose the workspace and approve. Spojit marks the connection **Connected** and refreshes the token automatically.
  </Step>
</Steps>

### Alternative: an API key

Linear also accepts a personal API key as a bearer token. Create one in your Linear account settings (give it only the **Read** permission for read-only access), then choose **Token** in Spojit, paste the key, keep **Header name** `Authorization` and **Prefix** `Bearer`, and click **Add**.

## Use it in a workflow

Add a **Connector** node, pick your Linear server under **Custom Servers**, and choose **Agent Mode** or **Direct Mode**. See [Use a custom server in a workflow](/connectors/remote-mcp-servers/custom#use-a-custom-server-in-a-workflow).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Tools act on the wrong workspace">
    Reconnecting does not switch workspaces within an existing sign-in. Add a separate connection for each workspace.
  </Accordion>
</AccordionGroup>

## Learn more

* [Linear MCP server](https://linear.app/docs/mcp)

<Snippet file="start-free.mdx" />