From a71253820b3cb440135e4b103f3dbe09e6bccd97 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 29 May 2026 21:04:12 +0000
Subject: [PATCH] docs: document one-click GitHub MCP setup for AI agents
---
guides/ai-agents/mcp-servers.mdx | 20 ++++++++++++++++++++
1 file changed, 20 insertions(+)
diff --git a/guides/ai-agents/mcp-servers.mdx b/guides/ai-agents/mcp-servers.mdx
index 75bba2a4..e0981510 100644
--- a/guides/ai-agents/mcp-servers.mdx
+++ b/guides/ai-agents/mcp-servers.mdx
@@ -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.
+
+
+
+ Go to **Settings → AI agents → MCP servers** for the project.
+
+
+ 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.
+
+
+ Edit any agent in the project and select **GitHub** under **MCP servers**.
+
+
+
+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
+
Go to **Settings → AI agents → MCP servers** for the project.