Skip to content

Commit e53bafc

Browse files
committed
Added MCP Picker instructions
1 parent 1eae3a4 commit e53bafc

File tree

2 files changed

+36
-8
lines changed

2 files changed

+36
-8
lines changed

docs/concepts/mcp.md

Lines changed: 36 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,13 @@ Run the setup command in your terminal for your IDE of choice from the [Supporte
2828
Install the [Defang CLI](/docs/getting-started.mdx#install-the-defang-cli) using [Curl](https://curl.se/) or [Homebrew](https://brew.sh/)
2929

3030
```bash
31-
defang mcp setup --client=<your-ide>
31+
defang mcp setup
3232
```
3333

34+
An interactive prompt will appear asking you to select your IDE(s) from a list of supported IDE(s). Select your IDE(s) by using the spacebar and arrow keys to navigate and press enter to confirm your selection.
35+
![Picker](/img/mcp-concept/mcp-picker.png)
36+
37+
Please ensure that your selected IDE(s) are updated to the latest version to ensure compatibility.
3438
:::
3539

3640
Once the command completes, you may need to restart your IDE for the changes to take effect.
@@ -39,6 +43,12 @@ Once the MCP Server is running, you can access the Defang MCP tools directly thr
3943

4044
That's it! Feel free to explore our [Example Prompts](#example-prompts) to get ideas on how to interact with the AI agent and make the most of the Defang MCP Server.
4145

46+
Note that we still support the previous client selection method using `--client=<your-ide>` flag, but it is not recommended.
47+
48+
```bash
49+
defang mcp setup --client=<your-ide>
50+
```
51+
4252
Note that `npx` installation is supported, but not recommended.
4353

4454
```bash
@@ -52,9 +62,11 @@ npx -y defang@latest mcp setup --client=<your-ide>
5262
Setup command:
5363

5464
```bash
55-
defang mcp setup --client=cursor
65+
defang mcp setup
5666
```
5767

68+
Select `cursor` from the [interactive prompt](#installation).
69+
5870
Once setup is complete, you can interact with the AI coding agent using Defang-related actions like `check defang services` or [other prompts](#example-prompts). Here's an example of what it could look like:
5971

6072
![Cursor](/img/mcp-concept/cursor.png)
@@ -64,9 +76,15 @@ Once setup is complete, you can interact with the AI coding agent using Defang-r
6476
Setup command:
6577

6678
```bash
67-
defang mcp setup --client=windsurf
79+
defang mcp setup
6880
```
6981

82+
Select `windsurf` from the [interactive prompt](#installation).
83+
84+
:::warning
85+
Windsurf currently does not support [MCP prompts](https://docs.windsurf.com/windsurf/cascade/mcp#general-information), therefore BYOC providers (AWS, GCP) cannot be set up through Windsurf. You can still use Playground as your deployment provider or setup AWS/GCP using the Defang CLI or another supported IDE.
86+
:::
87+
7088
Once setup is complete, you can interact with the AI coding agent using Defang-related actions like `check defang services` or [other prompts](#example-prompts). Here's an example of what it could look like:
7189

7290
![Windsurf](/img/mcp-concept/windsurf.png)
@@ -76,9 +94,11 @@ Once setup is complete, you can interact with the AI coding agent using Defang-r
7694
Setup command:
7795

7896
```bash
79-
defang mcp setup --client=vscode
97+
defang mcp setup
8098
```
8199

100+
Select `vscode` from the [interactive prompt](#installation).
101+
82102
Once setup is complete, you can interact with the AI coding agent using Defang-related actions like `check defang services` or [other prompts](#example-prompts). Here's an example of what it could look like:
83103

84104
![VS Code](/img/mcp-concept/vscode.png)
@@ -88,9 +108,11 @@ Once setup is complete, you can interact with the AI coding agent using Defang-r
88108
Setup command:
89109

90110
```bash
91-
defang mcp setup --client=vscode-insiders
111+
defang mcp setup
92112
```
93113

114+
Select `vscode-insiders` from the [interactive prompt](#installation).
115+
94116
Once setup is complete, you can interact with the AI coding agent using Defang-related actions like `check defang services` or [other prompts](#example-prompts). Here's an example of what it could look like:
95117

96118
![VS Code](/img/mcp-concept/vscode-insiders.png)
@@ -100,9 +122,11 @@ Once setup is complete, you can interact with the AI coding agent using Defang-r
100122
Setup command:
101123

102124
```bash
103-
defang mcp setup --client=kiro
125+
defang mcp setup
104126
```
105127

128+
Select `kiro` from the [interactive prompt](#installation).
129+
106130
Once setup is complete, you can interact with the AI coding agent using Defang-related actions like `check defang services` or [other prompts](#example-prompts). Here's an example of what it could look like:
107131

108132
![Kiro](/img/mcp-concept/kiro.png)
@@ -114,9 +138,11 @@ While this is not an IDE in the traditional sense, it can support MCP servers. F
114138
Setup command:
115139

116140
```bash
117-
defang mcp setup --client=claude-desktop
141+
defang mcp setup
118142
```
119143

144+
Select `claude-desktop` from the [interactive prompt](#installation).
145+
120146
Once setup is complete, you can interact with the AI coding agent using Defang-related actions like `check defang services` or [other prompts](#example-prompts). Here's an example of what it could look like:
121147

122148
![Claude Desktop](/img/mcp-concept/claude-desktop.png)
@@ -128,9 +154,11 @@ While this is not an IDE in the traditional sense, it can support MCP servers. F
128154
Setup command:
129155

130156
```bash
131-
defang mcp setup --client=claude-code
157+
defang mcp setup
132158
```
133159

160+
Select `claude-code` from the [interactive prompt](#installation).
161+
134162
Once setup is complete, you can interact with the AI coding agent using Defang-related actions like `check defang services` or [other prompts](#example-prompts). Here's an example of what it could look like:
135163

136164
![Claude Code](/img/mcp-concept/claude-code.png)
51 KB
Loading

0 commit comments

Comments
 (0)