Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commit b6cca0d

Browse files
Add Cursor MCP integration setup instructions (#145)
# Add Cursor integration to Lightdash MCP guide This PR adds documentation for setting up the Lightdash Model Connector Protocol (MCP) integration with Cursor. The new section includes: - Step-by-step instructions for configuring MCP in Cursor - JSON configuration example for connecting to Lightdash - Authentication workflow details - Five new screenshots showing the setup process: - Opening Cursor settings - Adding MCP connection JSON - Authentication needed state - Approving the connection in Lightdash - Successfully connected state The guide follows the same format as the existing Claude and Perplexity integration instructions.
2 parents 6550ce6 + 5c8a961 commit b6cca0d

File tree

6 files changed

+82
-8
lines changed

6 files changed

+82
-8
lines changed

‎guides/lightdash-mcp.mdx

Lines changed: 82 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ Set up MCP in the [Claude.ai](https://claude.ai) web app, and it will automatica
4343
<Accordion title="Setup instructions">
4444

4545
1. **Access Settings in Claude.ai**
46-
46+
4747
Navigate to your profile menu (bottom-left corner) and select Settings.
4848

4949
<Frame>
@@ -54,7 +54,7 @@ Set up MCP in the [Claude.ai](https://claude.ai) web app, and it will automatica
5454
</Frame>
5555

5656
2. **Add Custom Connector**
57-
57+
5858
In the Settings menu, select "Connectors" from the sidebar, then click "Add custom connector".
5959

6060
<Frame>
@@ -65,7 +65,7 @@ Set up MCP in the [Claude.ai](https://claude.ai) web app, and it will automatica
6565
</Frame>
6666

6767
3. **Configure Connection**
68-
68+
6969
Fill in the connection details with your Lightdash instance information.
7070

7171
<Frame>
@@ -79,7 +79,7 @@ Set up MCP in the [Claude.ai](https://claude.ai) web app, and it will automatica
7979
- **URL:** `https://<your_instance_name>.lightdash.cloud/api/v1/mcp`
8080

8181
4. **Connect and Authenticate**
82-
82+
8383
Click the "Connect" button to initiate the authentication process.
8484

8585
<Frame>
@@ -90,7 +90,7 @@ Set up MCP in the [Claude.ai](https://claude.ai) web app, and it will automatica
9090
</Frame>
9191

9292
5. **Complete OAuth Flow**
93-
93+
9494
Log in to your Lightdash account and approve the connection when prompted.
9595

9696
<Frame>
@@ -101,9 +101,9 @@ Set up MCP in the [Claude.ai](https://claude.ai) web app, and it will automatica
101101
</Frame>
102102

103103
6. **Configure Permissions (Optional)**
104-
104+
105105
Optionally configure which MCP tools Claude can access and set any additional permissions.
106-
106+
107107
<Frame>
108108
<img
109109
src="/images/guides/mcp/claude-ai-06-OPTIONAL-configure.png"
@@ -143,7 +143,7 @@ ChatGPT support for MCP is coming soon! Stay tuned for updates.
143143
alt="Fill out name, description, MCP URL and select OAuth"
144144
/>
145145
</Frame>
146-
146+
147147
- **Name:** Lightdash (or any name you prefer)
148148
- **Description:** Connect to Lightdash data analytics
149149
- **URL:** `https://<your_instance_name>.lightdash.cloud/api/v1/mcp`
@@ -216,6 +216,80 @@ After authentication, you can start asking questions about your Lightdash data d
216216

217217
</Accordion>
218218

219+
220+
#### Cursor
221+
222+
Follow the instructions below to set up MCP in Cursor.
223+
224+
<Accordion title="Setup instructions">
225+
226+
1. **Open the Cursor settings and select the MCP & Integrations tab**
227+
228+
<Frame>
229+
<img
230+
src="/images/guides/mcp/cursor-01-settings.png"
231+
alt="Open Cursor settings"
232+
/>
233+
</Frame>
234+
235+
2. **Add a new MCP connection**
236+
237+
<Frame>
238+
<img
239+
src="/images/guides/mcp/cursor-02-settings-json.png"
240+
alt="Add a new MCP connection"
241+
/>
242+
</Frame>
243+
244+
<Info>
245+
Copy and paste the following JSON into the `mcp` array and save the file:
246+
247+
```json
248+
{
249+
"mcpServers": {
250+
"lightdash": {
251+
"url": "https://<your_instance_name>.lightdash.cloud/api/v1/mcp"
252+
}
253+
}
254+
}
255+
256+
```
257+
258+
Replace `<your_instance_name>` with your actual Lightdash instance name.
259+
</Info>
260+
261+
3. Authenticate with Lightdash
262+
263+
Navigate back to the MCP & Integrations tab and click the "Connect" button.
264+
265+
<Frame>
266+
<img
267+
src="/images/guides/mcp/cursor-03-needs-auth.png"
268+
alt="Authenticate with Lightdash"
269+
/>
270+
</Frame>
271+
272+
4. Approve the connection in Lightdash
273+
274+
<Frame>
275+
<img
276+
src="/images/guides/mcp/cursor-04-approve.png"
277+
alt="Approve the connection in Lightdash"
278+
/>
279+
</Frame>
280+
281+
5. Start using MCP
282+
283+
You should be able to see Lightdash MCP Connection and listing available tools.
284+
285+
<Frame>
286+
<img
287+
src="/images/guides/mcp/cursor-05-success.png"
288+
alt="Successfully connected to Lightdash"
289+
/>
290+
</Frame>
291+
</Accordion>
292+
219293
#### Custom Integration (For Developers)
220294

221295
If you're building your own agents or automated workflows, you can integrate directly with Lightdash MCP:
165 KB
Loading[フレーム]
76.3 KB
Loading[フレーム]
161 KB
Loading[フレーム]

‎images/guides/mcp/cursor-04-approve.png

109 KB
Loading[フレーム]

‎images/guides/mcp/cursor-05-success.png

191 KB
Loading[フレーム]

0 commit comments

Comments
(0)

AltStyle によって変換されたページ (->オリジナル) /