​
What are Workspaces?

Workspaces are isolated environments within the NimbleTools MCP Platform. Each workspace provides a secure, multi-tenant space where you can deploy and manage MCP servers with complete isolation from other workspaces.

​
Key Benefits

Complete Isolation

Each workspace has isolated servers, secrets, tokens, and resources

Secure by Default

Workspace-scoped access tokens and encrypted credential storage

Easy Organization

Organize projects, environments, or teams with separate workspaces

Independent Scaling

Each workspace scales independently with its own resource limits

​
Workspace Architecture

​
Multi-Tenant Security

Each workspace operates in complete isolation:

​
Resource Isolation

Resource TypeIsolation LevelDescription
MCP ServersCompleteEach workspace deploys its own server instances
SecretsCompleteAPI keys and credentials are workspace-specific
NetworkingCompleteSeparate endpoints and routing per workspace

​
Common Workspace Patterns

​
Environment-Based Organization

Separate workspaces for different deployment environments: 
ntcli workspace create dev --description "Development environment"
ntcli workspace switch dev

# Deploy development versions
ntcli server deploy nationalparks-mcp --version latest
ntcli secrets set NPS_API_KEY=dev-key-here

​
Project-Based Organization

One workspace per project or application: 
ntcli workspace create web-app --description "Main web application backend"
ntcli server deploy nationalparks-mcp
ntcli server deploy weather-mcp
ntcli secrets set WEATHER_API_KEY=key1

​
Team-Based Organization

Workspaces for different teams or departments:

​
Workspace Lifecycle

​
Creation and Setup

1

Create Workspace

ntcli workspace create my-project --description "Project description"
2

Set Active Workspace

ntcli workspace switch my-project
# Or use interactive selection
ntcli workspace select
3

Configure Secrets

ntcli secrets set API_KEY=your-key
ntcli secrets set DATABASE_URL=postgresql://...
4

Deploy Servers

ntcli server deploy nationalparks-mcp
ntcli server deploy weather-mcp

​
Daily Operations

Common workspace management tasks:
TaskCommandDescription
Switch workspacentcli workspace switch prodChange active workspace
List workspacesntcli workspace listView all workspaces and active status
View serversntcli server listSee deployed servers in current workspace
Check secretsntcli secrets listView configured secrets (values hidden)
Generate tokensntcli token refresh --no-expiryCreate long-lived access tokens

​
Cleanup and Deletion

# List workspace resources before deletion
ntcli server list
ntcli secrets list

# Delete individual resources first (optional)
ntcli server remove nationalparks-mcp
ntcli secrets unset API_KEY

# Delete entire workspace
ntcli workspace delete my-project --force

​
Access Control & Security

​
Workspace-Scoped Tokens

Each workspace uses isolated access tokens: 
# Generate workspace-specific token
ntcli workspace switch dev
ntcli token refresh --no-expiry
# Token only works for 'dev' workspace

# Switch workspace, get different token
ntcli workspace switch prod  
ntcli token refresh --no-expiry
# Token only works for 'prod' workspace

​
Credential Isolation

Secrets and API keys are completely isolated: 
ntcli workspace switch dev
ntcli secrets set DATABASE_URL=postgresql://dev-db/myapp
ntcli secrets set API_KEY=dev-api-key
Even with the same secret names, values are completely separate and secure.

​
Best Practices

Environment Separation

Use separate workspaces for dev, staging, and production

Descriptive Naming

Use clear, descriptive names and descriptions for workspaces

Secret Management

Use workspace-specific secrets, never share credentials

Regular Cleanup

Delete unused workspaces to avoid unnecessary costs

​
Workspace Naming Conventions

​
Integration with Claude Desktop

Each workspace can generate its own Claude Desktop configuration: 
# Switch to desired workspace
ntcli workspace switch prod

# Generate Claude config for this workspace's servers
ntcli server claude-config nationalparks-mcp
The generated configuration includes workspace-specific endpoints and tokens, ensuring Claude Desktop only accesses the intended workspace.

workspace create

Create a new workspace

workspace list

List all workspaces

workspace switch

Switch active workspace

workspace delete

Delete a workspace