Complete Workflow Example

Overview

This example demonstrates a complete workflow using ntcli from initial setup through Claude Desktop integration. We’ll deploy multiple MCP servers, configure secrets, and set up production-ready scaling.

Prerequisites

Node.js 20+ installed
NPM or Yarn package manager
A NimbleTools account (created during authentication)

Step-by-Step Workflow

1. Installation and Setup

Install ntcli

npm install -g @nimbletools/ntcli
ntcli --version

Authenticate

ntcli auth login
# Follow OAuth flow in browser

Verify authentication

ntcli auth status

2. Workspace Management

Create development workspace

ntcli workspace create data-analysis --description "Data analysis and research workspace"

Create production workspace

ntcli workspace create production --description "Production MCP servers"

List workspaces

ntcli workspace list

Expected output:

📁 Workspaces:

✅ data-analysis (active)
   Description: Data analysis and research workspace
   Created: 2024-01-15

📁 production  
   Description: Production MCP servers
   Created: 2024-01-15

3. Browse and Deploy MCP Servers

Explore available servers

ntcli registry list

You’ll see servers like:

nationalparks-mcp - US National Parks data
finnhub-mcp - Stock market data
reverse-text-mcp - Text manipulation tools

Get detailed server information

ntcli registry show nationalparks-mcp

This shows capabilities, required environment variables, and documentation.

Deploy National Parks server

ntcli server deploy nationalparks-mcp

Wait for successful deployment message.

Deploy additional servers

ntcli server deploy finnhub-mcp
ntcli server deploy reverse-text-mcp

4. Configure Secrets and Environment Variables

Set National Parks API key

# Get free API key from https://www.nps.gov/subjects/developer/api-documentation.htm
ntcli secrets set NPS_API_KEY=your-nps-api-key-here

Set Finnhub API key

# Get free API key from https://finnhub.io/register
ntcli secrets set FINNHUB_API_KEY=your-finnhub-api-key-here

Verify secrets

ntcli secrets list

Expected output:

🔐 Secrets in workspace 'data-analysis':

NPS_API_KEY=***************
FINNHUB_API_KEY=***************

5. Test MCP Server Functionality

Test National Parks server

# List available tools
ntcli mcp tools nationalparks-mcp

# Search for parks in Wyoming
ntcli mcp call nationalparks-mcp find_parks --arg stateCode="WY"

# Search for specific park
ntcli mcp call nationalparks-mcp search_parks --arg query="Yellowstone"

Test Finnhub server

# List available tools
ntcli mcp tools finnhub-mcp

# Get stock quote
ntcli mcp call finnhub-mcp get_quote --arg symbol="AAPL"

# Get company profile
ntcli mcp call finnhub-mcp get_company_profile --arg symbol="TSLA"

Test text manipulation server

# List available tools
ntcli mcp tools reverse-text-mcp

# Reverse text
ntcli mcp call reverse-text-mcp reverse_text --arg text="Hello World"

# Convert to uppercase
ntcli mcp call reverse-text-mcp to_uppercase --arg text="hello world"

6. Production Setup

Switch to production workspace

ntcli workspace switch production

Deploy servers with production configuration

# Deploy to production workspace
ntcli server deploy nationalparks-mcp
ntcli server deploy finnhub-mcp

Set production secrets

ntcli secrets set NPS_API_KEY=your-production-nps-key
ntcli secrets set FINNHUB_API_KEY=your-production-finnhub-key

Verify production deployment

ntcli server list --verbose

7. Generate Long-Lived Tokens

Create non-expiring token for development

ntcli workspace switch data-analysis
ntcli token refresh 
ntcli token show

Save this token for CI/CD or long-running applications.

Create production token

ntcli workspace switch production
ntcli token refresh 
ntcli token show

8. Claude Desktop Integration

Generate Claude Desktop configuration

# Switch to desired workspace
ntcli workspace switch data-analysis

# Generate config for each server
ntcli server claude-config nationalparks-mcp
ntcli server claude-config finnhub-mcp
ntcli server claude-config reverse-text-mcp

Combine configurations

Create a complete Claude Desktop config file:

{
  "mcpServers": {
    "nationalparks-mcp": {
      "command": "npx",
      "args": [
        "@nimbletools/mcp-http-bridge",
        "--endpoint",
        "https://mcp.nimbletools.ai/v1/workspaces/your-workspace-id/servers/nationalparks-mcp/mcp",
        "--token",
        "your-workspace-token",
        "--insecure"
      ]
    },
    "finnhub-mcp": {
      "command": "npx",
      "args": [
        "@nimbletools/mcp-http-bridge",
        "--endpoint", 
        "https://mcp.nimbletools.ai/v1/workspaces/your-workspace-id/servers/finnhub-mcp/mcp",
        "--token",
        "your-workspace-token",
        "--insecure"
      ]
    },
    "reverse-text-mcp": {
      "command": "npx",
      "args": [
        "@nimbletools/mcp-http-bridge",
        "--endpoint",
        "https://mcp.nimbletools.ai/v1/workspaces/your-workspace-id/servers/reverse-text-mcp/mcp", 
        "--token",
        "your-workspace-token",
        "--insecure"
      ]
    }
  }
}

Restart Claude Desktop

Restart Claude Desktop to load the new configuration.

9. Test Claude Desktop Integration

Test National Parks integration

Ask Claude: “Find national parks in Wyoming and tell me about Yellowstone”

Test stock data integration

Ask Claude: “Get the current stock price for Apple and Tesla, and compare their performance”

Test text manipulation

Ask Claude: “Reverse this text: ‘Hello from NimbleTools’ and then convert it to uppercase”

Advanced Workflow Examples

Scaling and Monitoring

# Scale up for high traffic
ntcli workspace switch production
ntcli server scale nationalparks-mcp 5
ntcli server scale finnhub-mcp 3

# Monitor performance
ntcli server logs nationalparks-mcp --lines 100 --follow
ntcli server info nationalparks-mcp --verbose

CI/CD Integration Example

#!/bin/bash
# deploy.sh - Example deployment script

set -e

# Authenticate (assumes CI environment variables are set)
ntcli auth login --non-interactive

# Deploy to staging
ntcli workspace switch staging
ntcli server deploy my-mcp-server --version $BUILD_VERSION
ntcli secrets set API_KEY=$STAGING_API_KEY

# Run tests
ntcli mcp call my-mcp-server health_check
if [ $? -eq 0 ]; then
  echo "Staging tests passed"
  
  # Deploy to production
  ntcli workspace switch production
  ntcli server deploy my-mcp-server --version $BUILD_VERSION
  ntcli secrets set API_KEY=$PRODUCTION_API_KEY
  
  # Scale for production load
  ntcli server scale my-mcp-server 3
  
  echo "Production deployment complete"
else
  echo "Staging tests failed, aborting production deployment"
  exit 1
fi

Monitoring and Maintenance

Regular Maintenance Tasks

Weekly Health Checks

# Check all workspace servers
for workspace in $(ntcli workspace list --json | jq -r '.[].name'); do
  echo "Checking workspace: $workspace"
  ntcli workspace switch $workspace
  ntcli server list
  
  # Test MCP connectivity
  ntcli mcp connect --timeout 10000
done

Token Rotation

# Rotate tokens monthly for security
ntcli workspace switch production
ntcli token refresh 

# Update Claude Desktop config with new token
ntcli server claude-config nationalparks-mcp

Log Analysis

# Check for errors in server logs
ntcli server logs nationalparks-mcp --lines 1000 | grep -i error
ntcli server logs finnhub-mcp --lines 1000 | grep -i error

# Monitor resource usage
ntcli server info nationalparks-mcp --verbose

Complete Command Summary

Here’s a reference of all commands used in this workflow:

Setup & Auth
Workspaces
Registry & Servers
Secrets & Tokens
MCP Testing

npm install -g @nimbletools/ntcli
ntcli --version
ntcli auth login
ntcli auth status
ntcli auth logout  # When needed

Next Steps

After completing this workflow, you can:

Explore more MCP servers from the community registry
Build custom applications using the deployed servers via HTTP API
Set up monitoring and alerting for production workloads
Create custom MCP servers and deploy them to the platform
Integrate with CI/CD pipelines for automated deployments

Congratulations! You now have a complete, production-ready MCP deployment with Claude Desktop integration. Your AI assistant can now access real-time data from multiple sources securely and reliably.

Platform Architecture

Integrations

Advanced Topics

Examples

Overview

Prerequisites

Step-by-Step Workflow

1. Installation and Setup

2. Workspace Management

3. Browse and Deploy MCP Servers

4. Configure Secrets and Environment Variables

5. Test MCP Server Functionality

6. Production Setup

7. Generate Long-Lived Tokens

8. Claude Desktop Integration

9. Test Claude Desktop Integration

Advanced Workflow Examples

Scaling and Monitoring

CI/CD Integration Example

Monitoring and Maintenance

Regular Maintenance Tasks

Complete Command Summary

Next Steps

Platform Architecture

Integrations

Advanced Topics

Examples

​Overview

​Prerequisites

​Step-by-Step Workflow

​1. Installation and Setup

​2. Workspace Management

​3. Browse and Deploy MCP Servers

​4. Configure Secrets and Environment Variables

​5. Test MCP Server Functionality

​6. Production Setup

​7. Generate Long-Lived Tokens

​8. Claude Desktop Integration

​9. Test Claude Desktop Integration

​Advanced Workflow Examples

​Scaling and Monitoring

​CI/CD Integration Example

​Monitoring and Maintenance

​Regular Maintenance Tasks

​Complete Command Summary

​Next Steps

Overview

Prerequisites

Step-by-Step Workflow

1. Installation and Setup

2. Workspace Management

3. Browse and Deploy MCP Servers

4. Configure Secrets and Environment Variables

5. Test MCP Server Functionality

6. Production Setup

7. Generate Long-Lived Tokens

8. Claude Desktop Integration

9. Test Claude Desktop Integration

Advanced Workflow Examples

Scaling and Monitoring

CI/CD Integration Example

Monitoring and Maintenance

Regular Maintenance Tasks

Complete Command Summary

Next Steps