Onboard New Team Members

This guide walks you through adding new developers to your existing DeployStack team. Before starting, ensure you already have:

• A configured team with MCP servers set up
• Team Administrator privileges
• The new member's email address

Prerequisites

Before inviting team members, make sure:

• You have Team Administrator or Team Owner privileges
• Your team MCP servers are properly configured and tested
• You're not trying to add members to your default team (personal teams don't support additional members)

Step 1: New Member Account Setup

The new team member needs to complete these steps first:

# Install the DeployStack Gateway globally
npm install -g @deploystack/gateway

# Verify installation
deploystack --version

# Login to DeployStack
deploystack login

# This will open a browser window for authentication
# Follow the prompts to complete login

# Start the gateway
deploystack start

# Verify gateway is running
deploystack status

Step 2: Invite Team Member

Add Member to Your Team

1. Navigate to Teams: Go to your DeployStack dashboard and click on "Teams"
2. Select Your Team: Find the team you want to add members to and click "Manage"
3. Add New Member: Click "Add Member" and enter the new member's email address

Read more about Roles: Team Roles

Step 3: Complete Team Setup

After the team invitation is accepted, the new member needs to:

# List available teams
deploystack teams

# Switch to your team (replace with actual team number)
deploystack teams --switch 2

# Verify team context
deploystack status

{
  "mcpServers": {
    "brightdata": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "user-managed-token"
      }
    },
    "github": {
      "command": "npx",
      "args": ["@github/mcp"],
      "env": {
        "GITHUB_TOKEN": "user-managed-token"
      }
    }
  }
}

{
  "mcpServers": {
    "deploystack": {
      "url": "http://localhost:9095/sse",
      "name": "DeployStack Gateway",
      "description": "Enterprise MCP Gateway with team-based access control"
    }
  }
}

Step 4: Verify Team Access

Test MCP Tool Access

# List all available team MCP tools
deploystack mcp

# Verify gateway status with team context
deploystack status --verbose

Step 5: Test Team Access

Verify Team MCP Servers

1. Open VS Code: Launch VS Code or restart if already open
2. Test MCP Connection: Use Claude or MCP-compatible tools to verify access
3. Check Available Tools: Confirm all team MCP servers are accessible
4. Test Credentials: Verify that API calls work without manual credential setup

Confirm Team Resources

• Team MCP Servers: Access to all configured team servers
• Shared Credentials: Automatic credential injection (no manual setup required)
• Team Environment Variables: Access to team-wide environment settings
• Process History: View team's MCP server process logs

Step 6: Team Orientation

Brief New Members On

Available MCP Servers:

• Which servers are configured for the team
• What each server is used for
• Any usage guidelines or best practices

Team Workflows:

• How the team uses MCP tools in development
• Any specific processes or conventions
• Who to contact for technical support

Security Guidelines:

• Never manually manage API credentials (handled by DeployStack)
• Always use the DeployStack Gateway for MCP access
• Report any authentication or access issues immediately

Next Steps

Once new team members are successfully onboarded:

• Share Team Documentation: Provide any team-specific MCP usage guides
• Schedule Training: Consider hands-on training for complex MCP workflows
• Gather Feedback: Collect feedback on the onboarding process for improvements

New team members should now have secure, credential-free access to all team MCP servers through the DeployStack Gateway, enabling them to be productive immediately without complex setup or credential management.