Skip to main content
Connect GitHub’s MCP server to let Conversion AI chats and agents read a repository, create branches, push commits, and open pull requests. This guide uses GitHub’s remote MCP server, hosted at api.githubcopilot.com. There is nothing to install, run, or keep updated.

Before you begin

Make sure you have:
  • A Conversion Administrator account to add MCP servers
  • A GitHub account with access to the repositories you want to connect
  • Approval from a GitHub organization owner, if the repositories belong to an organization that requires approval for fine-grained tokens

Create a fine-grained personal access token

The GitHub MCP server has no setting to limit which repositories it can reach. The token you give it is the only boundary, so scope it to exactly the repositories and permissions your agents need.
1

Open the token settings

In GitHub, go to Settings → Developer settings → Personal access tokens → Fine-grained tokens and click Generate new token.
2

Choose the owner and repositories

3

Set the repository permissions

Add any of these if your agents need them:
The server URL in the next section enables GitHub’s default tools: repositories, issues, pull requests, and users. Actions, Discussions, and security alert tools are off by default. To turn on every tool group, use https://api.githubcopilot.com/mcp/x/all as the server URL. See GitHub’s remote server documentation for other options.
4

Copy the token

Click Generate token and copy it. GitHub does not show it again.
Treat the token like a password. Don’t save it in a file that gets committed to a repository.

Add the server in Conversion

1

Open the MCP server settings

In Conversion, go to Settings → AI and open the Connections tab. In the MCP servers section, click Add MCP server.
2

Fill in the server details

Include the word Bearer and a space before the token. Keep the trailing slash on the server URL: use .../mcp/, not .../mcp.
3

Save the server

Click Add server. Conversion inspects the server and lists its tools on the server page.
The header value is shared with the whole workspace. Every member who can use Conversion AI chats or agents with this server gets the token’s access to the selected repositories.

Choose which tools can run

Open the GitHub server page and review the Tools tab. Set each tool to Auto-approve, Require approval, or Disabled. For example, you can auto-approve read tools and require approval for tools that push code or open pull requests. See AI Connections for what each mode does.

Test the connection

  1. Start a Conversion AI chat.
  2. Ask it to list the open pull requests in one of the repositories you selected.
  3. Confirm that it returns results from that repository.
If the server shows Unreachable or the tools list says Unable to connect, check the server URL, the Bearer prefix, and whether the token has expired or is still waiting for organization approval. Then click Try again or Refresh tools.