Skip to main content

​
Overview

Create a new workspace with an isolated environment for your MCP servers. Workspaces provide multi-tenant security with workspace-scoped access tokens and credential isolation.

​
Syntax

ntcli workspace create <name> [options]

​
Arguments

​
name
string
required
Workspace name (must be ≤20 characters, alphanumeric and hyphens only)

​
Options

​
-d, --description
string
Optional description for the workspace
​
-v, --verbose
boolean
Enable verbose output to show detailed creation process

​
Examples

​
Basic Workspace Creation

ntcli workspace create my-project
Creates a workspace named “my-project” and automatically sets it as the active workspace.

​
Workspace with Description

ntcli workspace create data-analysis --description "Data analysis and AI tools workspace"

​
Verbose Creation

ntcli workspace create production --description "Production MCP servers" --verbose
Shows detailed information about the workspace creation process. 
ntcli workspace create my-app

​
Workspace Naming Rules

Workspace names must follow these rules:

Length Limit

Maximum 20 characters

Character Set

Alphanumeric characters and hyphens only

Case Sensitive

Names are case-sensitive

Unique Names

Must be unique within your account
Valid examples:
  • my-project
  • data-science-2024
  • prod-env
  • test123
Invalid examples:
  • my project (spaces not allowed)
  • this-is-a-very-long-workspace-name (too long)
  • prod_env (underscores not allowed)
  • my-project! (special characters not allowed)

​
What Happens When You Create a Workspace

1

Validation

ntcli validates the workspace name and checks for conflicts
2

API Call

Creates the workspace on the NimbleTools platform
3

Activation

Automatically sets the new workspace as your active workspace
4

Token Generation

Generates initial workspace access tokens

​
Workspace Features

Each workspace provides:

​
Isolated Environment

  • Separate MCP servers - Each workspace has its own server deployments
  • Independent scaling - Resource limits and scaling per workspace
  • Isolated networking - Workspace-specific endpoints and routing

​
Security & Access Control

  • Workspace-scoped tokens - Access tokens limited to workspace resources
  • Credential isolation - Secrets and API keys are workspace-specific
  • Independent permissions - User access controlled per workspace

​
Resource Management

  • Resource quotas - CPU, memory, and storage limits per workspace
  • Cost tracking - Usage and billing tracked per workspace
  • Monitoring - Logs and metrics isolated per workspace
Free Tier: Each account includes generous free tier limits. Additional workspaces and resources available with paid plans.

​
Post-Creation Steps

After creating a workspace, you typically want to:
  • Deploy Servers
  • Set Secrets
  • Generate Tokens
# Browse available servers
ntcli registry list

# Deploy an MCP server
ntcli server deploy nationalparks-mcp

​
Managing Multiple Workspaces

Common patterns for workspace organization:
Separate workspaces for different environments:
ntcli workspace create dev --description "Development environment"
ntcli workspace create staging --description "Staging environment"  
ntcli workspace create prod --description "Production environment"
One workspace per project or application:
ntcli workspace create web-app --description "Main web application"
ntcli workspace create mobile-api --description "Mobile app backend"
ntcli workspace create analytics --description "Data analytics pipeline"
Workspaces for different teams or purposes:
ntcli workspace create frontend-team --description "Frontend development tools"
ntcli workspace create data-science --description "ML and data analysis"
ntcli workspace create integrations --description "Third-party integrations"

​
Error Handling

Error: “Workspace name already exists”Solution: Choose a different name or check existing workspaces:
ntcli workspace list
ntcli workspace create my-project-v2
Error: “Invalid workspace name format”Solution: Follow naming rules (≤20 chars, alphanumeric + hyphens):
# ❌ Invalid
ntcli workspace create "my project"

# ✅ Valid  
ntcli workspace create my-project
Error: “Authentication required”Solution: Login first:
ntcli auth login
ntcli workspace create my-project
Error: “Workspace quota exceeded”Solution: Delete unused workspaces or upgrade your plan:
ntcli workspace list
ntcli workspace delete unused-workspace

workspace list

List all your workspaces and see which is active

workspace switch

Switch between existing workspaces

workspace delete

Delete a workspace and all its resources

server deploy

Deploy MCP servers to your new workspace

​
Next Steps

After creating a workspace:
  1. Set secrets: ntcli secrets set API_KEY=value
  2. Deploy servers: ntcli server deploy nationalparks-mcp
  3. Generate tokens: `ntcli token refresh
  4. Test integration: ntcli mcp tools server-name
Tip: The newly created workspace is automatically set as active. You can start deploying servers immediately!
⌘I