Tutorial

How to Run Claude Code Sessions on Linear Tickets

An r/VibeCodeDevs post wired Claude Code to Linear via two MCPs. Walk-through adding Scavio for out-of-repo grounding.

An r/VibeCodeDevs thread documented two MCPs in one Claude Code session: Linear official MCP (hosted, OAuth) for tickets + Lanes' local MCP for board state. This walks adding Scavio for the third slot — out-of-repo grounding.

Prerequisites

  • Claude Code CLI
  • Linear workspace
  • Lanes desktop app (or another local-board MCP)
  • Scavio API key

Walkthrough

Step 1: Attach Linear MCP (hosted, OAuth)

One CLI line.

Bash
claude mcp add linear https://mcp.linear.app/mcp
# Browser opens for OAuth on first call

Step 2: Attach Lanes local MCP (or equivalent)

Local board state.

Bash
claude mcp add lanes http://localhost:5353
# Lanes desktop app must be running

Step 3: Attach Scavio MCP for out-of-repo grounding

Web search, docs, Stack Overflow.

Bash
claude mcp add scavio https://mcp.scavio.dev/mcp --header 'x-api-key: $SCAVIO_API_KEY'

Step 4: Set explicit routing rules

Prevents tool confusion.

Text
// 'For ticket lookups, call linear. For local board state and session scrollback, call lanes. For framework docs, GitHub issues, Stack Overflow, or any out-of-repo info, call scavio.'

Step 5: Start a session from a Linear ticket

End-to-end flow.

Text
// 'Open ticket ENG-1234 from Linear. Read the description. Show me the relevant files in repo via lanes/git. Check the related Stack Overflow thread the ticket links via scavio.'

Step 6: Close-loop: write the change, post comment back to Linear

Linear MCP supports comment.

Text
// 'After committing, add a comment to ENG-1234 summarizing the fix.'

Python Example

Python
# Per-ticket cost: ~$0.05-0.20 in Scavio + LLM tokens depending on session length.

JavaScript Example

JavaScript
// MCP setup, not application code.

Expected Output

JSON
Claude Code session driven from Linear tickets, with local repo state via Lanes and out-of-repo grounding via Scavio. Three named MCPs, no overlap, clean tool surface.

Related Tutorials

Frequently Asked Questions

Most developers complete this tutorial in 15 to 30 minutes. You will need a Scavio API key (free tier works) and a working Python or JavaScript environment.

Claude Code CLI. Linear workspace. Lanes desktop app (or another local-board MCP). Scavio API key. A Scavio API key gives you 500 free credits per month.

Yes. The free tier includes 500 credits per month, which is more than enough to complete this tutorial and prototype a working solution.

Scavio has a native LangChain package (langchain-scavio), an MCP server, and a plain REST API that works with any HTTP client. This tutorial uses the raw REST API, but you can adapt to your framework of choice.

Start Building

An r/VibeCodeDevs post wired Claude Code to Linear via two MCPs. Walk-through adding Scavio for out-of-repo grounding.