Docs

Configure the Linear MCP Server

Updated 1 min read

Overview

Linear operates an official hosted MCP server at mcp.linear.app. Access is authorized through OAuth 2.1 with dynamic client registration.

1. Add the MCP server to your gateway config

In the mcp_servers section of your gateway configuration add the following entry:

  - name: linear
    description: "Linear's official hosted MCP server for issues, projects, and roadmaps."
    url: https://mcp.linear.app/mcp
    transport_type: streamablehttp
    authentication:
      type: oauth
      grant_type: authorization_code
      issuer: "https://mcp.linear.app"
      redirect_uri: "<CALLBACK_URL>"
      scopes:
        - read
        - write
      pkce_enabled: true

Replace the placeholder value:

  • <CALLBACK_URL> — your Dtwo gateway’s OAuth callback URL, found in the Configuration section for your gateway in the Dtwo UI.

2. Deploy and verify

Save the configuration and deploy the gateway.

Then, in your AI client, ask it to authorize Linear via the gateway. This opens the Linear login screen — sign in as the user whose permissions the agent should inherit, and approve the consent prompt. Once authorized, confirm the server’s tools appear and run a quick call to make sure the connection works.

Having trouble? Email support@dtwo.ai.