Skip to content

docs: document one-click GitHub MCP setup for AI agents #727

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
mintlify wants to merge 1 commit into from
Closed

docs: document one-click GitHub MCP setup for AI agents #727

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions guides/ai-agents/mcp-servers.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,26 @@ The agent decides when to call MCP tools based on the user's question and the ag

MCP servers are configured per project and can be attached to one or more agents in that project.

### One-click GitHub

If your organization has already installed the [Lightdash GitHub App](/self-host/customize-deployment/configure-github-for-lightdash) (the same integration used for dbt write-back and self-serve dbt syncing), org admins can connect the hosted GitHub MCP server in a single click.

<Steps>
<Step title="Open AI agent settings">
Go to **Settings → AI agents → MCP servers** for the project.
</Step>
<Step title="Click Connect GitHub">
Next to **Add MCP server**, click **Connect GitHub**. Lightdash mints a GitHub App installation token from your existing integration and registers the hosted GitHub MCP server (`https://api.githubcopilot.com/mcp/`) using that token.
</Step>
<Step title="Attach to an agent">
Edit any agent in the project and select **GitHub** under **MCP servers**.
</Step>
</Steps>

The button only appears when an org admin (with `manage:GitIntegration`) is viewing the settings and a GitHub App installation exists. The flow is idempotent — clicking it when a GitHub MCP server is already connected returns the existing server instead of duplicating it. The server inherits the repository scope of your GitHub App installation, so no extra OAuth or personal access token configuration is needed.

### Add any other server

<Steps>
<Step title="Open AI agent settings">
Go to **Settings → AI agents → MCP servers** for the project.
Expand Down
Loading