zed -linear

This MCP server extension integrates the Unofficial Linear MCP Server as a context source for Zed's Agent Panel. It allows Zed to fetch and display Linear context, leveraging a Linear access token to access the account's MCP data. To use it, provide your Linear API key via the extension's configuration so that Zed can authenticate with Linear and retrieve the MCP data. The context is exposed under the server name mcp-server-linear and can be referenced in Zed's context_servers configuration alongside any other context providers you use. If you prefer the official Linear MCP Server, you can point the configuration to the official endpoint instead; the extension is designed to work with either, though the official server may offer more managed features.

Prerequisites:

• Access to Zed and the Agent Panel integration where you can configure context_servers.
• A Linear account with an access token for API authentication.

1. Obtain your Linear API key by visiting https://linear.app/<your-org>/settings/account/security and generating a personal API token.
2. Update your Zed configuration to include the Linear MCP context server:

• In your Zed project configuration, add a context_servers entry like:

  { "context_servers": { "mcp-server-linear": { "settings": { "linear_api_key": "<LINEAR_API_KEY>" } } } }

3. If you prefer using the official Linear MCP Server, you can configure the context with the official endpoint instead:

{ "context_servers": { "mcp-server-linear": { "url": "https://mcp.linear.app/mcp", "headers": { "Authorization": "Bearer <your linear token>" } } } }

4. Restart the Zed Agent/Service to apply the new context server configuration.
5. Open the Agent Panel to verify that the Linear MCP context is available and perform actions supported by the MCP integration.

Notes and tips:

• If you use the unofficial Linear MCP Server, ensure you configure the Linear API key securely and avoid exposing it in public repositories.
• The official Linear MCP Server is hosted and managed by Linear; using the official endpoint may simplify maintenance.
• The Authorization header is optional if you rely on the linear_api_key setting within the extension configuration; use the method that aligns with your deployment.
• When changing tokens, regenerate and update the configuration promptly to avoid authentication errors.
• If you encounter connectivity issues, verify network access to https://mcp.linear.app/mcp and ensure the API key has the required permissions.
• This extension expects the context to be provided as a linear MCP source; if you add multiple context servers, ensure unique names and proper merging in Zed’s configuration.