Skip to content

Commit 116edfc

Browse files
authored
Merge pull request #213 from deploystackio/fix/quick-start
docs: Revise quick start guide for clarity and conciseness
2 parents 8834fe2 + 5800b09 commit 116edfc

File tree

1 file changed

+10
-71
lines changed

1 file changed

+10
-71
lines changed

docs/quick-start.mdx

Lines changed: 10 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -43,54 +43,12 @@ By the end of this guide, you'll have:
4343
<Step>
4444
**Explore Your Dashboard**
4545

46-
Once logged in, you'll see:
47-
- **Teams**: Your personal default team (automatically created)
48-
- **MCP Catalog**: Browse available MCP servers
49-
- **Team Settings**: Manage your team and credentials
46+
Once logged in, you'll see preinstalled MCP servers in your dashboard.
47+
We have preinstalled popular MCP servers like Sequential Thinking. You can add more whenever you want to.
5048
</Step>
5149
</Steps>
5250

53-
## Step 2: Configure Your First MCP Server
54-
55-
Let's set up a popular MCP server to get you started quickly.
56-
57-
<Steps>
58-
<Step>
59-
**Browse the MCP Catalog**
60-
61-
1. Navigate to the **MCP Catalog** in your dashboard
62-
2. Browse available MCP servers (GitHub, BrightData, Weather, etc.)
63-
3. Click on a server that interests you to see its details
64-
</Step>
65-
66-
<Step>
67-
**Add an MCP Server to Your Team**
68-
69-
For this example, let's add the GitHub MCP server:
70-
71-
1. Find "GitHub MCP Server" in the catalog
72-
2. Click **"Add to Team"**
73-
3. Select your default team
74-
4. You'll be prompted to add credentials
75-
</Step>
76-
77-
<Step>
78-
**Configure Credentials**
79-
80-
Add your GitHub token securely:
81-
82-
1. **Create a GitHub Token**: Go to [GitHub Settings > Personal Access Tokens](https://github.com/settings/tokens)
83-
2. **Generate a new token** with appropriate permissions
84-
3. **Add to DeployStack**: Paste the token in the credentials field
85-
4. **Save**: Your credentials are encrypted and stored securely
86-
</Step>
87-
</Steps>
88-
89-
<Callout type="info">
90-
**Security Note**: Your credentials are encrypted and never exposed to your local environment. The DeployStack Gateway injects them securely at runtime.
91-
</Callout>
92-
93-
## Step 3: Install and Configure the Gateway
51+
## Step 2: Install and Configure the Gateway
9452

9553
The DeployStack Gateway runs locally and connects your development tools to your team's MCP servers.
9654

@@ -103,12 +61,6 @@ The DeployStack Gateway runs locally and connects your development tools to your
10361
```bash
10462
npm install -g @deploystack/gateway
10563
```
106-
107-
Verify the installation:
108-
109-
```bash
110-
deploystack --version
111-
```
11264
</Step>
11365

11466
<Step>
@@ -124,21 +76,8 @@ The DeployStack Gateway runs locally and connects your development tools to your
12476
- Open a browser window for authentication
12577
- Download your team's MCP server configurations
12678
- Set up secure credential access
127-
</Step>
128-
129-
<Step>
130-
**Start the Gateway**
131-
132-
Start the gateway to begin using your MCP servers:
133-
134-
```bash
135-
deploystack start
136-
```
137-
138-
The gateway will:
139-
- Start all your configured MCP servers as background processes
140-
- Expose them at `http://localhost:9095/sse`
141-
- Inject credentials securely without exposing them to you
79+
80+
Login command will pull your MCP configurations and credentials from the cloud.deploystack.io and start the DeployStack gateway.
14281
</Step>
14382

14483
<Step>
@@ -157,7 +96,7 @@ The DeployStack Gateway runs locally and connects your development tools to your
15796
</Step>
15897
</Steps>
15998

160-
## Step 4: Connect Your Development Environment
99+
## Step 3: Connect Your Development Environment
161100

162101
Now connect VS Code or Cursor to use your team's MCP servers.
163102

@@ -170,6 +109,7 @@ Now connect VS Code or Cursor to use your team's MCP servers.
170109
**Location**: `.vscode/settings.json` or global VS Code settings
171110

172111
**Before** (manual MCP server management):
112+
173113
```json
174114
{
175115
"mcpServers": {
@@ -185,6 +125,7 @@ Now connect VS Code or Cursor to use your team's MCP servers.
185125
```
186126

187127
**After** (DeployStack Gateway):
128+
188129
```json
189130
{
190131
"mcpServers": {
@@ -208,7 +149,7 @@ Now connect VS Code or Cursor to use your team's MCP servers.
208149
</Step>
209150
</Steps>
210151

211-
## Step 5: Explore Your Setup
152+
## Step 4: Explore Your Setup
212153

213154
Now that everything is connected, explore what you can do:
214155

@@ -242,8 +183,6 @@ Now that everything is connected, explore what you can do:
242183

243184
Back in the [DeployStack dashboard](https://cloud.deploystack.io):
244185
- Add more MCP servers to your team
245-
- Invite team members (if you have a team)
246-
- Monitor usage and activity
247186
- Manage credentials securely
248187
</Step>
249188
</Steps>
@@ -272,7 +211,7 @@ deploystack logs
272211
deploystack mcp
273212

274213
# Update configurations from cloud
275-
deploystack sync
214+
deploystack refresh
276215

277216
# Switch teams (if you have multiple)
278217
deploystack teams

0 commit comments

Comments
 (0)