> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macroscope.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Organization IP Allow Lists

> Allow Macroscope's IP addresses if your GitHub organization restricts access by IP

If your GitHub organization uses an [IP allow list](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization), GitHub only accepts traffic from approved IP addresses. Macroscope connects from a fixed set of IPs, which must be allowed before it can access your repos.

<Note>
  Most organizations do not use an IP allow list. Follow this guide only if an admin has enabled one.
</Note>

## Symptoms

When an allow list blocks Macroscope, GitHub returns:

> Although you appear to have the correct authorization credentials, the `<your-org>` organization has an IP allow list enabled, and your IP address is not permitted to access this resource.

Until the IPs are added, all GitHub-backed features are unavailable: code review, repo sync, commit and PR summaries, and Status.

## Macroscope IP addresses

```text theme={null}
34.170.244.124
35.202.65.220
34.186.132.116
34.102.54.30
```

## Add the IPs

An organization owner can add all four addresses:

<Steps>
  <Step title="Open the allow list settings">
    **Organization settings → Security → IP allow list** (`https://github.com/organizations/<your-org>/settings/security`).
  </Step>

  <Step title="Add each address">
    Select **Add**, enter an IP, label it `Macroscope`, and save. Repeat for all four.
  </Step>

  <Step title="Confirm enforcement">
    Ensure **Enable IP allow list** is checked.
  </Step>
</Steps>

Access resumes automatically once the IPs are allowed. No change is required on the Macroscope side.

<Tip>
  If your allow list also covers [GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps), keep that setting enabled so Macroscope's IPs are honored. Still blocked? [Contact support](/contact).
</Tip>
