Skip to content

Commit 4a73cbf

Browse files
author
Lasim
committed
fix(docs): clarify terminology in teams documentation for consistency in server management references
1 parent 1286240 commit 4a73cbf

1 file changed

Lines changed: 31 additions & 31 deletions

File tree

docs/teams.mdx

Lines changed: 31 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,25 @@
11
---
22
title: Teams Structure in DeployStack
3-
description: Organize your MCP server deployments with teams - your workspace for managing servers, credentials, and environment variables in DeployStack.
3+
description: Organize your MCP server management with teams - your workspace for managing servers, credentials, and environment variables in DeployStack.
44
sidebar: Teams
55
---
66

77
# Teams
88

9-
Teams are the organizational foundation of DeployStack, serving as dedicated workspaces where you manage all your MCP server deployments, cloud provider credentials, and environment variables. Think of teams as isolated containers that keep your deployment resources organized and secure.
9+
Teams are the organizational foundation of DeployStack, serving as dedicated workspaces where you manage all your MCP server configurations, cloud provider credentials, and environment variables. Think of teams as isolated containers that keep your team resources organized and secure.
1010

1111
## Overview
1212

1313
In DeployStack, teams provide:
1414

15-
- **Isolated Workspaces**: Each team maintains its own separate environment for deployments
15+
- **Isolated Workspaces**: Each team maintains its own separate environment for MCP server management
1616
- **Resource Organization**: All your MCP servers, credentials, and settings are organized within teams
17-
- **Access Control**: Team-based permissions ensure secure access to your deployment resources
17+
- **Access Control**: Team-based permissions ensure secure access to your team resources
1818
- **Multi-Project Support**: Create multiple teams to organize different projects or environments
1919
- **Team Collaboration**: Teams support multiple members with role-based access control
2020
- **Default Team Protection**: Your personal default team cannot have additional members added
2121

22-
Every team acts as a complete deployment environment, containing everything needed to deploy and manage MCP servers across various cloud providers.
22+
Every team acts as a complete team environment, containing everything needed to configure and manage MCP servers through the DeployStack Gateway.
2323

2424
## Getting Started with Teams
2525

@@ -32,35 +32,35 @@ When you register for DeployStack, a default team is automatically created for y
3232
- **Description**: Automatically set as "[username]'s team"
3333
- **Role**: You become the Team Administrator with full control
3434

35-
This default team is immediately ready for use - you can start deploying MCP servers right away.
35+
This default team is immediately ready for use - you can start configuring MCP servers right away.
3636

3737
### Additional Teams
3838

3939
You can create additional teams beyond your automatically created default team to organize different projects or environments.
4040

4141
## What Teams Contain
4242

43-
Teams serve as comprehensive containers for all your deployment resources:
43+
Teams serve as comprehensive containers for all your team resources:
4444

4545
### MCP Server Settings
4646
- **Team MCP Servers**: Private MCP servers visible only to your team members
47-
- **Global MCP Server Access**: Browse and deploy community-wide MCP servers
47+
- **Global MCP Server Access**: Browse and use community-wide MCP servers
4848
- **Server Management**: Team administrators can create, edit, and delete team servers
4949
- **Version Control**: Track different versions of your team's MCP servers
5050
- **GitHub Integration**: Automatic synchronization with GitHub repositories (see [GitHub App Integration Guide](/github-application))
5151
- **Custom Configurations**: Team-specific server settings and parameters
52-
- **Deployment History**: Complete logs and monitoring data for team deployments
52+
- **Process History**: Complete logs and monitoring data for team MCP servers
5353

54-
### Cloud Provider Credentials
55-
- **local MCP Servers**: Credentials for local MCP environments
56-
- **Google Cloud**: API tokens and service configurations
54+
### MCP Server Credentials
55+
- **API Keys and Tokens**: Secure storage for MCP server authentication
56+
- **Service Credentials**: Authentication tokens for various MCP server integrations
5757

5858
### Global Environment Variables
5959
- **Node.js Environment Variables**: Custom env vars for Node.js-based MCP servers
6060
- **Reusable Variables**: Environment variables that can be applied across multiple servers
6161
- **Secure Storage**: All environment variables are encrypted and securely stored
6262

63-
These global environment variables allow you to define common settings once and apply them to multiple MCP servers within the same team, streamlining your deployment process.
63+
These global environment variables allow you to define common settings once and apply them to multiple MCP servers within the same team, streamlining your MCP server management.
6464

6565
## Team Management
6666

@@ -151,7 +151,7 @@ Teams support two distinct roles with different capabilities:
151151

152152
#### Team Administrator
153153
- **Full team management**: Can add/remove members, change roles, transfer ownership
154-
- **Resource access**: Full access to all team resources and deployments
154+
- **Resource access**: Full access to all team resources and MCP servers
155155
- **Team settings**: Can modify team name, description, and all configurations
156156
- **Member management**: Can promote team users to admins or demote admins to users
157157

@@ -231,7 +231,7 @@ These restrictions ensure that every user always has a personal, private team fo
231231

232232
Each team maintains complete isolation:
233233

234-
- **Separate Credentials**: Cloud provider credentials are team-specific
234+
- **Separate Credentials**: MCP server credentials are team-specific
235235
- **Independent Servers**: MCP servers in one team don't affect others
236236
- **Isolated Variables**: Environment variables are scoped to individual teams
237237
- **Secure Boundaries**: No cross-team access to resources
@@ -253,7 +253,7 @@ Each team maintains complete isolation:
253253

254254
#### Deleting a Team (Non-Default Only)
255255

256-
1. **Prepare the Team**: Remove all MCP servers and configurations
256+
1. **Prepare the Team**: Remove all MCP server configurations
257257
2. **Access Management**: Click "Manage" on the team you want to delete
258258
3. **Find Danger Zone**: Scroll down to the "Danger Zone" section
259259
4. **Click Delete**: Click the "Delete Team" button
@@ -283,9 +283,9 @@ For each team, you can:
283283

284284
- **Update Team Name**: Modify the display name
285285
- **Edit Description**: Change or add team descriptions
286-
- **Manage Credentials**: Add, update, or remove cloud provider credentials
286+
- **Manage Credentials**: Add, update, or remove MCP server credentials
287287
- **Configure Variables**: Set up global environment variables
288-
- **Monitor Deployments**: View all MCP servers and their status
288+
- **Monitor MCP Servers**: View all MCP servers and their status
289289

290290
### Understanding Team Slugs
291291

@@ -312,7 +312,7 @@ Team slugs serve as unique identifiers:
312312

313313
For non-default teams, multiple safety measures protect against accidental deletion:
314314

315-
1. **Active Server Check**: Teams with active MCP servers **cannot be deleted**
315+
1. **Active Server Check**: Teams with configured MCP servers **cannot be deleted**
316316
2. **Confirmation Dialog**: A modal dialog requires explicit confirmation
317317
3. **Clear Warning**: The interface clearly explains the consequences
318318
4. **Two-Step Process**: You must first remove all servers, then confirm deletion
@@ -321,7 +321,7 @@ For non-default teams, multiple safety measures protect against accidental delet
321321

322322
To delete a non-default team, you must:
323323

324-
1. **Stop All Running MCP Servers**: Ensure no servers are currently deployed or running
324+
1. **Stop All Running MCP Servers**: Ensure no servers are currently configured or running
325325
2. **Remove All Server Configurations**: Delete all MCP server settings and configurations
326326
3. **Access Danger Zone**: Navigate to the "Danger Zone" section in team management
327327
4. **Confirm Deletion**: Click delete and confirm in the popup dialog
@@ -330,10 +330,10 @@ To delete a non-default team, you must:
330330

331331
When you delete a team, you lose **everything** associated with it:
332332

333-
- **All MCP Server Settings**: Complete server configurations and deployment history
334-
- **All Cloud Provider Credentials**: Stored API keys, tokens, and authentication data
333+
- **All MCP Server Settings**: Complete server configurations and process history
334+
- **All MCP Server Credentials**: Stored API keys, tokens, and authentication data
335335
- **All Global Environment Variables**: Custom environment settings and variables
336-
- **Complete Deployment History**: Logs, monitoring data, and historical information
336+
- **Complete Process History**: Logs, monitoring data, and historical information
337337

338338
### No Recovery Options
339339

@@ -362,16 +362,16 @@ Global administrators have enhanced visibility into all teams across the system:
362362
- **`teams.delete`**: Delete teams (after removing all servers)
363363
- **`teams.manage`**: Full team management capabilities
364364

365-
### Deployment Capabilities
365+
### MCP Server Management Capabilities
366366

367367
Your team role affects your ability to:
368368

369-
- Deploy new MCP servers
369+
- Configure new MCP servers
370370
- Modify server configurations
371-
- Manage cloud provider credentials
371+
- Manage MCP server credentials
372372
- Set up environment variables
373-
- Monitor deployment status
374-
- Access deployment logs
373+
- Monitor MCP server status
374+
- Access process logs
375375

376376
## Getting the Most from Teams
377377

@@ -385,9 +385,9 @@ Consider creating separate teams for:
385385

386386
Within each team:
387387

388-
- **Group Related Servers**: Deploy related MCP servers in the same team
389-
- **Shared Credentials**: Use the same cloud provider credentials across servers
388+
- **Group Related Servers**: Configure related MCP servers in the same team
389+
- **Shared Credentials**: Use the same MCP server credentials across servers
390390
- **Common Variables**: Leverage global environment variables for consistency
391391
- **Logical Organization**: Use descriptive names and descriptions
392392

393-
Teams provide the foundation for organized, secure, and efficient MCP server deployment in DeployStack. By understanding how teams work, you can effectively manage your deployment resources and maintain clean separation between different projects and environments.
393+
Teams provide the foundation for organized, secure, and efficient MCP server management in DeployStack. By understanding how teams work, you can effectively manage your team resources and maintain clean separation between different projects and environments.

0 commit comments

Comments
 (0)