Linear is the issue tracker for many engineering teams that prefer speed and keyboard-driven workflows. Connecting Linear to clariBI brings cycle-level reporting and cross-team velocity into your AI analyses.
Why connect Linear
Linear gives great in-product visibility but cross-team or cross-time-window questions usually require copying data out. clariBI through Linear answers those directly.
Ask "What is throughput per team this cycle?", "Which projects shipped last month?", or "Find stale issues older than 30 days" and the AI engine routes to the right Linear tool.
How the connection works
clariBI talks to Linear through its hosted MCP server at https://mcp.linear.app/sse. Authentication uses an OAuth flow that clariBI registers itself for (no developer console setup on your side). Tokens stay encrypted server-side and never leave clariBI in clear form.
sequenceDiagram
actor U as You
participant C as clariBI
participant V as Linear
U->>C: Click Authorize with Linear
C->>V: Open OAuth authorization
V-->>U: Grant read access?
U->>V: Approve
V-->>C: Authorization code
C->>V: Exchange code for tokens
V-->>C: Access + refresh tokens
C->>C: Encrypt and store credentials
C-->>U: Connection ready
Available tools
clariBI exposes the read-only Linear tools that the vendor's MCP server publishes at connection time. Write operations (create, update, delete, send, refund) are filtered out by a name-pattern blocklist before any tool reaches the analysis engine, so connecting Linear cannot modify data on the vendor side.
The exact tool inventory depends on the Linear features your account has access to. After connecting, try a few natural-language questions to see what Linear data clariBI can pull.
Data flow during analysis
When you ask a question that maps to Linear, the AI engine routes to the right tool, reads the result, and pairs the answer with a chart you can pin to a dashboard.
sequenceDiagram
actor U as You
participant C as clariBI
participant AI as AI engine
participant V as Linear
U->>C: Ask a question about engineering issue and project data
C->>AI: Plan the analysis
AI->>V: Call the right tool
V-->>AI: Tool result
AI->>AI: Summarize and chart
C-->>U: Answer plus visual
Setting up the connection
- Open Data Sources in the clariBI sidebar.
- Click Add data source.
- Open the MCP Servers tab.
- Click the Linear card.
- Click Authorize with Linear.
- Sign in to Linear in the popup window and grant the requested read scopes.
- Back in clariBI, give your data source a name.
- Click Finish.
Permissions and data access
clariBI requests the standard Linear read scope, which covers issues, projects, teams, cycles, and workflow states. No issues or comments can be created or modified. Disconnect from Linear settings or from clariBI Settings.
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
| "Workspace switcher in popup is wrong" | You are signed into multiple Linear workspaces. | Sign out of unwanted workspaces in Linear, then reconnect. |