• METRICS
  • HEALTH
  • REPORTS
  • HUMAN

How to report deployments and incidents with your AI

Connect LinearB to your AI client once. After that, you can update your engineering metrics by simply telling your agent what happened in your repos or logs.

Ask AI about this page

Short answer

How can I report deployments and incidents to LinearB using AI?

You tell your AI client about a recent Git commit or a service outage, and it uses the LinearB MCP to log that data. This keeps your delivery tracking and incident history accurate. You'll see the following outcomes.

Where your data lands.

Direct updates to your dashboard.

The AI maps your chat commands to specific LinearB records.

METRICS

Updated delivery stats

The AI uses record_new_deployment to push Git references into your LinearB dashboard. Your cycle time and throughput stay current.

HEALTH

Logged incident history

When you report a bug or outage, the AI uses record_new_incident to create a log. This populates your engineering health metrics.

REPORTS

Clean audit trails

Every deployment and incident reported via chat creates a traceable entry. You get a reliable history of what happened and when.

HUMAN

Manual review needed

The AI only logs what you tell it. You still need to verify that the Git refs or incident details you provide are correct before finishing the task.

The workflow

What your AI does when <the thing arrives>.

Your AI acts as the bridge between your technical activity and your LinearB dashboard.

  1. Capture context

    Your AI reads the Git commit hash or the error log you paste into the chat.

    record_new_deployment

  2. Log deployments

    The AI sends the deployment details to LinearB to update your delivery metrics.

    record_new_deployment

  3. Log incidents

    The AI records the incident details to ensure your health data reflects the outage.

    record_new_incident

  4. Confirm entry

    The AI tells you that the deployment or incident has been successfully recorded.

    record_new_deploymentrecord_new_incident

Try it

Copy these to start.

Use these prompts to trigger the LinearB tools.

Starting points

Swap out the bracketed info for your actual repo names, commit hashes, or incident IDs.

LinearB Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_RQu5BgeMc4kEdSux6KvMTpIFSZDUWY8Nip6OyVZ1/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — LinearB capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "linearb-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_RQu5BgeMc4kEdSux6KvMTpIFSZDUWY8Nip6OyVZ1/mcp"
    }
  }
}
Copy into chat04

  • Record a new deployment for the main repo using commit hash abc1234.

  • Log a new incident for the auth-service based on this error log: [paste log].

  • I just deployed version 2.1.0 to production, please update LinearB.

  • There was a critical incident in the payment gateway; record it now.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect LinearB once, then ask.

Click the link to authorize the connection. Your credentials stay encrypted, and you can immediately start using the tools in your preferred AI client.

Connect LinearB to your AI

FAQ

How this task behaves.

  • 01

    Can the AI delete existing deployment records?

    No. The AI can only record new deployments and incidents.

  • 02

    Does the AI automatically know when I push code to GitHub?

    No. The AI only acts when you explicitly tell it to record a deployment or an incident.

  • 03

    Can I use this to pull reports from LinearB?

    No. This specific task is for sending data to LinearB, not retrieving it.

  • 04

    Will the AI fix the code that caused the incident?

    No. The AI only logs the incident in LinearB so your metrics stay accurate.

  • 05

    Do I need to stay in the chat to finish the deployment?

    No. Once you give the command, the AI executes the tool and completes the record.

  • More questions about LinearB? The Connector page answers them. See everything the LinearB Connector can do

Connect LinearB to Claude, Cursor, ChatGPT & more