Skip to main content

​
Unlocking Context from Your Issue Trackers

With access to your issue management systems, Macroscope can:
  • Generate better code summaries: Using context from linked tickets and issue metadata, Macroscope can create more detailed and accurate code summaries
  • Create new tickets: Anyone on your team with access to Macroscope can ask Macroscope create new tickets, directly in Slack.
  • Generate better answers: Macroscope will use context from your ticketing systems — including linked commits and issue metadata — to generate richer answers in AMA.
Below are instructions and best practices for integrating Macroscope with Jira and Linear.

​
Jira

Macroscope can connect to your team’s Jira instance to get more information about the work being done and take action within Jira on your team’s behalf. When you connect Macroscope to Jira, you will set up the integration via an authorizing Jira account. Once you set up the integration, anyone on your team with access to Macroscope will be able to:
  • Ask Macroscope to create tickets in any Space that the authorizing account can access. Any issues created will be authored by the authorizing account.
  • Query Macroscope about tickets and Spaces that the authorizing account can access.
Recommendation: Create a Dedicated Jira AccountWe highly recommend creating a new Jira user specifically for Macroscope, scoped to the specific Spaces (a.k.a. Projects) you want Macroscope to have access to. This is because Macroscope inherits the permissions of the Jira account that authorizes the integration, and creating a dedicated user allows you to best control what Jira Spaces Macroscope has access to.For teams that use Google Workspace, we recommend spinning up a new email alias like [email protected] and using that email address to create a new Jira account.When you create this new Jira user, be sure to give it access to the specific Jira Spaces you want Macroscope to have access to.

​
Step-by-Step Jira Integration Instructions

1

Go to Macroscope Settings

In Settings, click Connections. Scroll down to the Jira section.
2

Sign in to Jira

First, make sure you are logged out of any personal Jira accounts on your browser.Click Connect Jira. You will be taken to a Jira sign in page.Sign in with the Jira account you want to authorize for Macroscope.
In certain cases, after linking Jira to Macroscope, a site admin may need to manually authorize the connection. In this case, ask a Jira site admin to:
  1. Go to Atlassian Administration → Apps → [your-site].atlassian.net → Connected apps
  2. Find Macroscope and click Authorize/Allow for the site.
After that, the Jira user you are connecting to Macroscope can complete the connection.
3

Review Project List

After you authorize Macroscope to access your Jira account, you will see a list of all of the Spaces that Macroscope has been granted access to. Any Spaces listed will be accessible to anyone on your team with access to Macroscope. Any Spaces not listed will not be accessible.
If you want to modify this list of Spaces, you will need to modify the permissions of the authorizing account in Jira and then re-authorize Macroscope with that account.
After you review the list, click Confirm Access to complete the integration.

​
Linear

​
Linear Permissions

When you connect Linear to Macroscope, you can choose which Linear teams Macroscope has access to. All issues and associated metadata within those teams will be available to anyone on your team with access to Macroscope.

​
Step-by-Step Linear Integration Instructions

1

Go to Macroscope Settings

In Settings, click Connections. Scroll down to the Linear section.
2

Sign in to Linear

Click Connect Linear. You will be taken to a Linear sign in page. Sign in with your Linear account.
3

Choose Team Access

Once you are signed in, Linear will prompt you to choose which teams Macroscope can access. All issues and metadata in those selected teams will be available to anyone using Macroscope.

You can select all public teams or only select teams…. If you select only select teams…, you will be prompted to select the teams you want Macroscope to have access to.
Linear permissions selection example
Click Authorize to complete.