@cequenceai/mcp-cli/demo-no-refresh.md

Cequence MCP CLI - Command-line tool for setting up Cequence MCP servers with AI clients

# Descope Authentication Fix Demo

## Problem Statement
- **Issue**: Descope authentication was causing frequent re-authentication prompts due to refresh token problems
- **Impact**: Poor user experience with constant authentication interruptions
- **Root Cause**: Descope sometimes has issues with OAuth refresh token flows

## Solution Implemented
- **Approach**: Added `--no-refresh` flag to disable problematic refresh tokens
- **Package**: Custom `@cequenceai/mcp-remote@1.0.3` with enhanced OAuth control
- **Integration**: Updated `@cequenceai/mcp-cli@1.0.8` to use custom package

## Testing Demonstration

### Test 1: Verify Flag Recognition
```bash
# Test help documentation
npx @cequenceai/mcp-remote@1.0.3 --help
# Expected: Usage shows --no-refresh flag

# Test flag parsing
npx @cequenceai/mcp-remote@1.0.3 https://test.example.com --no-refresh --debug
# Expected: "Token refresh disabled - will not request refresh_token grant type"
```

### Test 2: CLI Integration
```bash
# Generate Claude configuration with standard CLI
npx @cequenceai/mcp-cli@1.0.8 claude --url "https://your-server.com/mcp" --name "Test Server"
# Expected: Configuration uses @cequenceai/mcp-remote package
```

### Test 3: Manual Configuration Testing
Users experiencing Descope issues can manually add `--no-refresh`:

**Before (problematic):**
```json
{
  "mcpServers": {
    "server": {
      "command": "npx",
      "args": ["-y", "@cequenceai/mcp-remote", "https://server.com/mcp"]
    }
  }
}
```

**After (fixed):**
```json
{
  "mcpServers": {
    "server": {
      "command": "npx",
      "args": ["-y", "@cequenceai/mcp-remote", "https://server.com/mcp", "--no-refresh"]
    }
  }
}
```

## Business Value
- ✅ **Immediate Fix**: Solves Descope authentication issues for affected users
- ✅ **User Control**: Users can easily enable/disable refresh tokens as needed
- ✅ **Backward Compatible**: No breaking changes to existing configurations
- ✅ **Future-Proof**: Can be applied to any OAuth provider with similar issues

## Deployment Status
- ✅ **Published**: `@cequenceai/mcp-remote@1.0.3` available on npm
- ✅ **CLI Updated**: `@cequenceai/mcp-cli@1.0.8` uses custom package
- ✅ **Portal Integration**: UI configurations updated
- ✅ **Tested**: Flag recognition and functionality verified

## Next Steps
1. Document the fix in user-facing documentation
2. Communicate solution to users experiencing Descope issues
3. Monitor for reduced authentication-related support tickets