From 01558ce2fa20feb5574ff2cad6589ffe9674c4b2 Mon Sep 17 00:00:00 2001 From: Tori Whaley Date: Mon, 25 May 2026 07:21:31 -0400 Subject: [PATCH] docs: document PAT auth and custom headers for Lightdash MCP Clarifies that the MCP endpoint also accepts Personal Access Token and service account auth alongside OAuth, and documents the X-Lightdash-Project and X-Lightdash-User-Attributes headers used by headless agents. Co-Authored-By: Claude Opus 4.7 --- references/integrations/lightdash-mcp.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/references/integrations/lightdash-mcp.mdx b/references/integrations/lightdash-mcp.mdx index e5921622..f92e6f52 100644 --- a/references/integrations/lightdash-mcp.mdx +++ b/references/integrations/lightdash-mcp.mdx @@ -227,8 +227,10 @@ If you're building your own agents or automated workflows, you can integrate dir - **Transport**: Lightdash MCP exposes a StreamableHTTP transport endpoint at `https://.lightdash.cloud/api/v1/mcp` - **Debugging**: Use `@modelcontextprotocol/inspector` to inspect and debug the MCP connection -- **Authentication**: Requires OAuth 2.0 flow for secure authentication +- **Authentication**: For interactive setups use OAuth 2.0. For headless agents and automated workflows, you can authenticate with a Personal Access Token by passing `Authorization: ApiKey ` instead. Create the token under **Settings → Personal access tokens** for the user whose permissions and attributes you want the integration to use. Service account tokens are also supported on plans that include them. - **Documentation**: See the [MCP specification](https://modelcontextprotocol.io/docs) for implementation details +- **Pin a project (optional)**: pass `X-Lightdash-Project: ` to scope the MCP session to a specific project, skipping the `set_project` step. +- **Override user attributes per request (optional)**: pass `X-Lightdash-User-Attributes: ` to override the authenticated user's attributes for that request (useful for row-level security when an agent acts on behalf of different end-users). {/*