Skip to Content
MCP ServersSetup ExamplesGitHub

GitHub MCP Server

This guide walks through connecting the GitHub MCP server to auxilia. GitHub uses static OAuth credentials, so you need to create a GitHub OAuth App first.

1. Create a GitHub OAuth app

  1. Go to GitHub Developer Settings 
  2. OAuth Apps → New OAuth App
  3. Fill in:
    • Application name: auxilia MCP
    • Homepage URL: your deployment URL, e.g. https://auxilia.example.com
    • Authorization callback URL: 
      <FRONTEND_URL>/api/backend/mcp-servers/oauth/callback
      For local development: 
      http://localhost:3000/api/backend/mcp-servers/oauth/callback
  4. Click Register application
  5. Copy the Client ID
  6. Click Generate a new client secret and copy it

2. Install the GitHub MCP server

In auxilia, navigate to MCP Servers:

  1. Find GitHub in the official servers list
  2. Click Install
  3. Enter the Client ID and Client Secret

3. Connect your account

  1. Click Connect on the GitHub server card
  2. Review the permissions on GitHub’s authorization page and click Authorize
  3. You’re redirected back to auxilia

4. Add to an agent

  1. Open an agent’s configuration page
  2. Click Add MCP Server → GitHub
  3. Set tool permissions — PR / issue creation and commit-writing tools are good candidates for needs approval

Alternative: personal access token

If you’d rather skip OAuth, connect with a GitHub PAT instead:

  1. Go to GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens 
  2. Generate new token → pick the repositories and permissions the agent needs
  3. Copy the token
  4. In auxilia, Add MCP Server as a custom server, auth type API key, URL https://api.githubcopilot.com/mcp, token pasted into the API key field

The PAT is tied to a single GitHub account and has a fixed expiration, but it’s simpler than OAuth for personal or single-user workspaces.

HubSpotBigQuery