Skip to content

Commit dcafaeb

Browse files
author
Lasim
committed
fix(docs): update terminology from "server deployments" to "server configurations" for clarity across documentation
1 parent 4a73cbf commit dcafaeb

5 files changed

Lines changed: 23 additions & 26 deletions

File tree

docs/development/backend/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ import { Database, Shield, Plug, Settings, Mail, TestTube, Wrench, BookOpen } fr
99

1010
# DeployStack Backend Development
1111

12-
The DeployStack backend is a modern, high-performance Node.js application built with **Fastify**, **TypeScript**, and **Drizzle ORM**. It's specifically designed for managing MCP (Model Context Protocol) server deployments with enterprise-grade features including authentication, role-based access control, and an extensible plugin system.
12+
The DeployStack backend is a modern, high-performance Node.js application built with **Fastify**, **TypeScript**, and **Drizzle ORM**. It's specifically designed for managing MCP (Model Context Protocol) server configurations with enterprise-grade features including authentication, role-based access control, and an extensible plugin system.
1313

1414
## Technology Stack
1515

docs/development/frontend/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sidebar: Getting Started
66

77
# DeployStack Frontend Development
88

9-
The DeployStack frontend is a modern web application built with Vue 3, TypeScript, and Vite, specifically designed for managing MCP (Model Context Protocol) server deployments. This guide covers everything you need to know to develop and contribute to the frontend.
9+
The DeployStack frontend is a modern web application built with Vue 3, TypeScript, and Vite, specifically designed for managing MCP (Model Context Protocol) server configurations. This guide covers everything you need to know to develop and contribute to the frontend.
1010

1111
## Technology Stack
1212

docs/development/index.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Development Guide
3-
description: Complete development documentation for DeployStack - covering frontend, backend, and contribution guidelines for the MCP server deployment platform.
3+
description: Complete development documentation for DeployStack - covering frontend, backend, and contribution guidelines for the MCP server management platform.
44
icon: FileCode
55
---
66

@@ -9,13 +9,13 @@ import { Code2, Server, GitBranch, Users, Shield } from 'lucide-react';
99

1010
# DeployStack Development
1111

12-
Welcome to the DeployStack development documentation! DeployStack is a comprehensive enterprise platform for deploying and managing Model Context Protocol (MCP) servers, featuring a cloud control plane, local gateway proxy, and modern web interface for team-based MCP server orchestration.
12+
Welcome to the DeployStack development documentation! DeployStack is a comprehensive enterprise platform for managing Model Context Protocol (MCP) servers, featuring a cloud control plane, local gateway proxy, and modern web interface for team-based MCP server orchestration.
1313

1414
## Architecture Overview
1515

1616
DeployStack implements a sophisticated Control Plane / Data Plane architecture for enterprise MCP server management:
1717

18-
- **Frontend**: Vue 3 + TypeScript web application providing the management interface for MCP server deployments
18+
- **Frontend**: Vue 3 + TypeScript web application providing the management interface for MCP server configurations
1919
- **Backend**: Fastify-based cloud control plane handling authentication, team management, and configuration distribution
2020
- **Gateway**: Local secure proxy that runs on developer machines, managing MCP server processes and credential injection
2121
- **Shared**: Common utilities and TypeScript types used across all services

docs/onboard-new-team-members.mdx

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,6 @@ This guide walks you through adding new developers to your existing DeployStack
1717

1818
Before inviting team members, make sure:
1919

20-
- Your team has available member slots
2120
- You have Team Administrator or Team Owner privileges
2221
- Your team MCP servers are properly configured and tested
2322
- You're not trying to add members to your default team (personal teams don't support additional members)
@@ -189,7 +188,7 @@ deploystack status --verbose
189188
- **Team MCP Servers**: Access to all configured team servers
190189
- **Shared Credentials**: Automatic credential injection (no manual setup required)
191190
- **Team Environment Variables**: Access to team-wide environment settings
192-
- **Deployment History**: View team's MCP server deployment logs
191+
- **Process History**: View team's MCP server process logs
193192

194193
## Step 6: Team Orientation
195194

docs/roles.mdx

Lines changed: 17 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -22,22 +22,22 @@ User roles determine what actions a person can perform in DeployStack. Think of
2222
- Manage roles and permissions
2323
- Access all system features
2424
- Manage all teams
25-
- View cloud credentials metadata across all teams (no credential values shown)
25+
- View MCP server credentials metadata across all teams (no credential values shown)
2626
- **MCP Catalog**: Full management of global MCP servers and categories
2727
- **MCP Oversight**: View all team MCP servers across the platform (read-only)
2828

2929
**Important**: The first person to register automatically becomes a Global Administrator.
3030

31-
**Note**: Global Administrators can see that teams have cloud credentials but cannot view the actual credential values for security reasons.
31+
**Note**: Global Administrators can see that teams have MCP server credentials but cannot view the actual credential values for security reasons.
3232

3333
### Global User
34-
**Who needs this**: Regular users who want to deploy applications.
34+
**Who needs this**: Regular users who want to configure MCP servers.
3535

3636
**What they can do**:
3737
- View and edit their own profile
38-
- Create up to 3 teams
38+
- Create multiple teams
3939
- Manage their own teams
40-
- Deploy applications through their teams
40+
- Configure MCP servers through their teams
4141
- **MCP Catalog**: Browse and view global MCP servers only
4242

4343
**Note**: This is the default role for new users.
@@ -48,11 +48,11 @@ User roles determine what actions a person can perform in DeployStack. Think of
4848
**What they can do**:
4949
- Manage their team's settings
5050
- View team members
51-
- **Add new members to their teams** (up to 3 members total)
51+
- **Add new members to their teams**
5252
- **Change member roles** (promote team_user to team_admin, or demote)
5353
- **Remove team members** (except team owners)
5454
- **Transfer team ownership** to another team member
55-
- Manage team deployments
55+
- Manage team MCP server configurations
5656
- Delete teams they own (except default teams)
5757
- **MCP Catalog**: View global servers + full management of team MCP servers
5858

@@ -79,7 +79,6 @@ The following table shows exactly what each role can do with team member managem
7979
- **Team admins** can only manage team_users, not other team_admins or owners
8080
- **Team owners** have full control over their teams (except default teams)
8181
- **Global admins** can override most restrictions but still cannot modify default teams
82-
- **3-member limit** applies to all teams (owner + 2 additional members maximum)
8382

8483
## MCP Catalog Permissions
8584

@@ -100,7 +99,7 @@ The MCP (Model Context Protocol) Catalog has specific permissions based on your
10099
- **Team Isolation**: Teams can only manage their own servers, not other teams' servers
101100

102101
### Team User
103-
**Who needs this**: Basic team members who participate in deployments.
102+
**Who needs this**: Basic team members who participate in MCP server configuration.
104103

105104
**What they can do**:
106105
- View team information
@@ -112,13 +111,13 @@ The MCP (Model Context Protocol) Catalog has specific permissions based on your
112111

113112
## Understanding Teams
114113

115-
Teams are groups where users organize their deployment projects. Here's how teams work:
114+
Teams are groups where users organize their MCP server configurations. Here's how teams work:
116115

117116
### Team Basics
118-
- **Automatic Team**: Every user gets their own team when they register
119-
- **Team Limit**: Users can create up to 3 teams total
117+
- **Automatic Team**: Every user gets their own default team when they register
118+
- **Multi-User Support**: Teams support multiple members with role-based access control
120119
- **Team Owner**: The person who created the team has full control
121-
- **Single User Teams**: Currently, each team has one user (multi-user teams coming soon)
120+
- **Default Team Protection**: Your personal default team cannot have additional members added
122121

123122
### Team Management
124123
- **Create Teams**: Use descriptive names for your different projects
@@ -134,13 +133,13 @@ Teams are groups where users organize their deployment projects. Here's how team
134133

135134
### Small Team
136135
- **Administrator**: One person manages the system and users
137-
- **Team Members**: Everyone else is a Global User with their own teams
138-
- **Collaboration**: Users can share deployment information outside the system
136+
- **Team Members**: Everyone else is a Global User who can join teams
137+
- **Collaboration**: Users can collaborate within shared teams
139138

140139
### Organization
141140
- **System Admin**: Global Administrator manages the DeployStack installation
142141
- **Project Leads**: Team Administrators manage specific project teams
143-
- **Developers**: Global Users participate in deployments
142+
- **Developers**: Global Users participate in team configurations
144143

145144
## Managing User Roles
146145

@@ -183,8 +182,7 @@ All users can:
183182
- **Delete teams**: Remove teams you no longer need
184183

185184
### Team Limitations
186-
- **3 Team Maximum**: You can only create 3 teams total
187-
- **One User per Team**: Teams currently support single users
185+
- **Default Team Protection**: Your personal default team cannot have additional members
188186
- **Owner Control**: Only team owners can modify team settings
189187

190188
## Security and Access Control
@@ -209,7 +207,7 @@ All users can:
209207

210208
### Can't Create Teams
211209
**Problem**: "Create Team button is disabled"
212-
**Solution**: You may have reached the 3-team limit. Delete unused teams or contact your administrator.
210+
**Solution**: Contact your administrator if you're unable to create teams.
213211

214212
### Can't Change Role
215213
**Problem**: "I want to be an administrator"

0 commit comments

Comments
 (0)