Manage AI tool integrations

Overview

LinearB’s AI tool integrations provide one place to connect and manage external AI coding tools.

Each integration collects usage data from its provider and makes the supported metrics available in LinearB. Available data depends on the provider and connection type.

Open AI Tool Integrations

1. Go to Settings.
2. Open Company Settings.
3. Select AI Tools.
4. Select Integrations.

The Integrations sidebar displays your configured AI tool integrations. Select an integration to view its provider, connection type, status, configuration details, and available actions.

• Select Connected to view active integrations, including integrations that currently have a validation or collection error.
• Select Disconnected to view integrations that were previously disconnected.

Supported Providers and Connection Types

Data Available by Provider

Adoption and accepted-lines data appears in AI Analytics.

Model, token, and estimated-consumption data is available through Metrics Builder. Predefined consumption queries can be grouped by supported dimensions such as model, team, repository, or day.

Add an AI Tool Integration

1. Go to Settings → Company Settings → AI Tools → Integrations.
2. Click Add New.
3. Under Select AI provider, select the provider and click Continue.
4. Under Connection type, select the connection method and click Continue.
5. Under Main Settings, enter the requested credentials and configuration.
6. Follow any provider-specific instructions displayed in LinearB.
7. Click Connect.

LinearB validates the submitted configuration. When validation succeeds, the integration appears in the Connected list.

Edit an Integration

Edit mode lets you update the available configuration fields without disconnecting the integration.

1. Go to Settings → Company Settings → AI Tools → Integrations.
2. Select Connected.
3. Select the integration you want to update.
4. Under Main Settings, click Edit.
5. Update the available configuration fields.
6. Click Save changes to apply the update or Cancel to discard it.

What happens to historical data?

Editing an integration does not delete previously collected metrics.

• Saving an edit may trigger LinearB to recollect a recent window of provider data.
• Recollected records are updated in place and are not counted twice.
• Data older than the provider’s recollection window remains unchanged.
• The recollection window and processing time vary by provider and connection type.

Understand Integration Status

Connected

The integration is active and LinearB can collect data from the provider.

Connected with an error

An active integration with a validation or collection error remains under Connected and displays an error indicator. Select it to review the error and edit its configuration.

Disconnected

LinearB is no longer collecting new data through the integration. Previously collected data is preserved, and the integration remains available under Disconnected.

Disconnect an Integration

1. Open Settings → Company Settings → AI Tools → Integrations.
2. Select the integration in the Connected list.
3. Click Disconnect.
4. Review the confirmation message.
5. Click Disconnect to confirm.

LinearB stops collecting new data and moves the integration to the Disconnected list. Previously collected data is preserved.

Reconnect an Integration

1. Open Settings → Company Settings → AI Tools → Integrations.
2. Select Disconnected.
3. Select the integration you want to restore.
4. Click Reconnect.
5. Review the saved configuration and enter replacement credentials if required.
6. Complete validation to restore the integration.

LinearB resumes collecting new data when validation succeeds.

Duplicate Integration Rules

Only one active integration using the same provider and connection type can be connected at a time.

For example, two GitHub Copilot Classic token integrations cannot be active simultaneously.

• A failing integration still counts as active for this rule.
• To reconnect a previous integration with the same provider and connection type, first disconnect the currently active integration.
• A different connection type is managed as a separate integration.

Claude Code OpenTelemetry Data

Claude Code OpenTelemetry begins sending data after OpenTelemetry is enabled and the generated managed settings are deployed to your developers.

Learn more:

• Connect Claude Code using OpenTelemetry

Troubleshooting

The Integration Shows an Error

• Select the integration under Connected.
• Review the error displayed in its details.
• Confirm that the credential or token is still valid.
• Confirm that it has the permissions required by the provider.
• Verify organization, account, repository, AWS, and region settings as applicable.
• Under Main Settings, click Edit, correct the configuration, and click Save changes.

Saving an edit clears the current failure status. The next validation or collection attempt determines whether the integration is working successfully.

The Integration Is Connected but No Data Appears

• Confirm that users are actively using the connected AI tool.
• Verify that the configured organizations, accounts, or resources cover the expected users.
• Allow time for the provider to make usage data available.
• Review the provider-specific collection cadence and historical backfill window.
• For OpenTelemetry, confirm that the managed settings were deployed and approved.

An Integration Cannot Be Reconnected

• Confirm that its saved credentials are still valid.
• Enter replacement credentials during the reconnect flow if required.
• Check whether another active integration uses the same provider and connection type.
• If a duplicate is active, disconnect it before reconnecting the previous integration.

Configuration Guides

• Choose a GitHub Copilot connection
• Choose a Claude Code connection
• Connect Cursor to LinearB
• Connect Amazon Q Developer to LinearB
• Connect Kiro to LinearB

Related Articles

• Enable LinearB AI services
• AI Analytics: Adoption, Workflow, and Impact