Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
22 changes: 19 additions & 3 deletions agents/lightdash-mcp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,22 @@ Setting up MCP is quick and straightforward. You can connect your AI assistant t
- A Lightdash Cloud account or Enterprise account with MCP enabled
- An MCP-compatible AI assistant (e.g., Claude.ai, Claude Desktop, ChatGPT, OpenAI Codex)

### Find your instance name

Your instance name is the subdomain of the URL you use to open Lightdash in your browser. Open Lightdash, look at the address bar, and take the part before `.lightdash.cloud`:

| Your Lightdash URL | Instance name | MCP URL |
| ------------------------------------- | ------------- | ---------------------------------------------- |
| `https://app.lightdash.cloud/...` | `app` | `https://app.lightdash.cloud/api/v1/mcp` |
| `https://eu1.lightdash.cloud/...` | `eu1` | `https://eu1.lightdash.cloud/api/v1/mcp` |
| `https://acme.lightdash.cloud/...` | `acme` | `https://acme.lightdash.cloud/api/v1/mcp` |

<Note>
For most Lightdash Cloud users the instance name is `app` or `eu1`. That's expected, not a placeholder you need to change. Only dedicated instances have a company-specific name like `acme`.
</Note>

If you self-host Lightdash on your own domain, the MCP endpoint lives at `https://<your-lightdash-host>/api/v1/mcp` instead. See [MCP for self-hosted instances](/self-host/enterprise-features/mcp).

### Network requirements

If your organization uses a corporate firewall, VPN, or internet security tool, the following domains must be allowlisted for MCP to work correctly:
Expand Down Expand Up @@ -84,7 +100,7 @@ Set up MCP in the [Claude.ai](https://claude.ai) web app, and it will automatica
![Enter Lightdash as the name and your instance MCP URL in the configuration form](/images/agents/lightdash-mcp/claude-ai-03-fill-out-name-and-mcp-url.png)
</Frame>
- **Name:** Lightdash (or any name you prefer)
- **URL:** `https://<your_instance_name>.lightdash.cloud/api/v1/mcp`
- **URL:** `https://<your_instance_name>.lightdash.cloud/api/v1/mcp` (commonly `app` or `eu1`, see [Find your instance name](#find-your-instance-name))
4. **Connect and Authenticate**

Click the "Connect" button to initiate the authentication process.
Expand Down Expand Up @@ -169,7 +185,7 @@ ChatGPT support for MCP is coming soon\! Stay tuned for updates.
<Frame>
![Select Streamable HTTP and enter your Lightdash instance MCP URL](/images/agents/lightdash-mcp/codex-01-add-mcp-server.png)
</Frame>
- **URL:** `https://<your_instance_name>.lightdash.cloud/api/v1/mcp`
- **URL:** `https://<your_instance_name>.lightdash.cloud/api/v1/mcp` (commonly `app` or `eu1`, see [Find your instance name](#find-your-instance-name))

3. **Authenticate**

Expand All @@ -188,7 +204,7 @@ For developers using Claude Code CLI:
claude mcp add lightdash https://<your_instance_name>.lightdash.cloud/api/v1/mcp -t http
```

Replace `<your_instance_name>` with your actual Lightdash instance name.
Replace `<your_instance_name>` with your actual Lightdash instance name (commonly `app` or `eu1`, see [Find your instance name](#find-your-instance-name)).

<Accordion title="Setup instructions">
1. **Use the /mcp command in Claude Code**
Expand Down
2 changes: 1 addition & 1 deletion integrations/snowflake-cortex.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ For more details, see the [Agent skills guide](/workflow/install-agent-skills).

## Lightdash MCP

The [Lightdash MCP](/agents/lightdash-mcp) searches your semantic layer and executes queries, and it works in Snowsight Cortex as well as locally. Add it to Cortex with your instance's MCP URL, replacing `<yourapp>` with your Lightdash instance name:
The [Lightdash MCP](/agents/lightdash-mcp) searches your semantic layer and executes queries, and it works in Snowsight Cortex as well as locally. Add it to Cortex with your instance's MCP URL, replacing `<yourapp>` with your Lightdash instance name (commonly `app` or `eu1`, see [Find your instance name](/agents/lightdash-mcp#find-your-instance-name)):

```bash
cortex mcp add lightdash https://<yourapp>.lightdash.cloud/api/v1/mcp
Expand Down
Loading