Ctrlk
ProductLoginStart for Free
For the complete documentation index, see llms.txt. This page is also available as Markdown.

GitHub

Give an agent access to GitHub with a personal access token.

Required permissions

Tool
Required Permission
Description

Pull Requests

Pull requests

Pull requests and related comments, assignees, labels, milestones, and merges.Learn more.

Commits

Content

Repository contents, commits, branches, downloads, releases, and merges. Learn more.

Create Personal Access Token

Using the GitHub MCP server requires a personal access token

1

Navigate to your GitHub settings and click on Developer settings

2

Got to Fine-grained tokens and click on the Generate new token button

3

Enter the details for your personal access token:

  • Name, description and Expiration

  • Resource owner - we recommend setting your GitHub org as the owner

  • Repository access - select the repositories to which the agent should have access

  • Permissions - chose the permissions based on your enabled tools in ilert. In the screenshot below, the agent will have read access to code, metadata, and pull requests.

4

Click on Generate token

5

Copy your token and temporarily paste it somewhere secure (e.g. a private note). You will later need the token when setting up the GitHub MCP server in ilert.

Connect GitHub with agent

To connect GitHub with your AI SRE agent:

1

Navigate to Agents in the ilert navigation menu

2

Open the agent detail view for the agent you want to configure

3

Go to the Tools tab

4

Under the ilert hosted MCP servers section, locate the GitHub card

5

Click Connect on the GitHub card

6

In the connection dialog that appears:

  • Select connector: Choose "Create new connector" (or select an existing connector if you have one)

  • Type: Select Bearer Token from the dropdown

  • Secret name: Enter a name for your connector (e.g., "GitHub Production" or "GitHub Main")

  • Secret value: Paste the personal access token you created earlier

  • Host URL: Leave this field empty

7

Click Connect to complete the connection

8

After connecting, you can enable or disable specific tools needed for alert investigation, such as:

  • get_pull_request - Retrieve pull request information

  • get_pull_request_diff - Get pull request diff details

  • get_commit_diff - Get commit diff information

  • search_pull_requests - Search merged pull requests by title across an owner's or organization's repositories

The GitHub integration is now connected and ready to use for root cause analysis.

PreviousClickhouse
NextGrafana

Last updated

Was this helpful?