Skip to Content
Knowledge🔌 Connectors🔗 GitHub

GitHub Connector

One GitHub connection syncs repositories into Knowledge and gives agents GitHub’s own MCP server  as a tool. When connecting, members choose Let agents use GitHub (on by default) and Sync into Knowledge with a repository to sync.

  • Knowledge. Each synced repository is one source, read with the connection’s token and synced on the chosen schedule.
  • Tools. By default agents use the read-only endpoint https://api.githubcopilot.com/mcp/readonly. Also let agents make changes (issues, comments, pull requests) is off by default; see Letting agents make changes.

Members connect this service from Settings > Connectors. See Connectors for the full GitHub setup.

Connect with a personal access token

Always available, with no admin setup. Create a fine-grained personal access token  for the repositories DocsGPT should read, with Contents set to Read-only. Add read-only Issues and Pull requests if agents should read those through the tools. Paste the token when you pick GitHub in Settings > Connectors.

Sign in with GitHub (optional, a GitHub App)

An admin can register a GitHub App so members can Sign in with GitHub and choose repositories when they install the app. Register the app with the redirect URI from Admin > Connectors as its callback URL, create a client secret, then set:

GITHUB_CLIENT_ID=Iv23li...        # the app's Client ID
GITHUB_CLIENT_SECRET=your-client-secret
GITHUB_APP_SLUG=docsgpt-acme      # from the app's public link, github.com/apps/<slug>

Restart the API and the worker. The app’s permissions and installation options are listed in Sign in with GitHub.

Public repositories

The GitHub tile in Add knowledge ingests a public repository from its URL without a connection. GITHUB_ACCESS_TOKEN, if set, only raises GitHub’s rate limit there. For a private repository, use a GitHub connection.

🔗 Confluence🔗 Linear