Skip to main content

Check out Port for yourself ➜ 

GitHub MCP connector

This page covers setting up the GitHub MCP connector. The GitHub MCP connector relies on the general MCP connectors features - refer to that page for an overview of how MCP connectors work.

The GitHub MCP server uses manual OAuth client registration, which means you need to create a GitHub OAuth app before configuring the connector in Port.

Setup steps​

1. Create a GitHub OAuth app​

In your GitHub organization settings, create a new OAuth app with the following fields:

  • Application name: Any recognizable name, e.g. Port MCP Connector.
  • Homepage URL: https://app.getport.io
  • Authorization callback URL: https://api.port.io/v1/mcp-servers/oauth/callback
US region

If your Port organization is on the US region, use https://api.us.port.io/v1/mcp-servers/oauth/callback as the callback URL instead.

After registering the app, copy the Client ID and generate a Client Secret (copy it immediately - it is only shown once).

For more information on creating a GitHub OAuth app, see the GitHub documentation.

2. Configure the connector in Port​

In Port, open the GitHub MCP connector (go to Data Sources > MCP Servers > GitHub), expand Advanced OAuth Settings, and fill in:

  • OAuth Client ID: The client ID from step 1.
  • OAuth Client Secret: The client secret from step 1.
  • OAuth Scope: repo,read:org (minimum required scope).

Save and publish the connector.

3. Authenticate and use​

Follow the standard MCP connector authentication steps. Users will be redirected through the GitHub OAuth flow when they first connect.