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.
Jira
We recommend creating a new Jira user specifically for Macroscope. This is because Macroscope inherits the permissions of the Jira account that authorizes the integration. Creating a dedicated user allows you to best control what Jira Spaces Macroscope has access to.What Your Team Can Do with Macroscope and Jira
When you connect Macroscope to Jira, 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.
Tips for Setting Up a Dedicated Jira Account
When you create the new Jira user, be sure to give it access to the specific Jira Spaces (a.k.a. Projects) you want Macroscope to have access to. For teams that use Google Workspace, we recommend spinning up a new email alias likelinda+macroscope@yourcompany.com and using that email address to create a new Jira account.
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
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.
We recommend creating a dedicated Jira account just for Macroscope, because Macroscope inherits the permissions of the Jira account that authorizes the integration.
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.After you review the list, click Confirm Access to complete the integration.
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.
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.
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.
