npm package: @stepsequencer/mcp-server
Description: MCP server for accessing StepSequencer business models in Claude Desktop
Author: StepSequencer
Latest version: 0.3.4

# StepSequencer MCP Server

Access your StepSequencer business models directly in Claude Desktop and other AI assistants.

## Quick Setup

### 1. Get Your API Key

1. Sign in to [StepSequencer](https://stepsequencer.ai)
2. Go to Settings → API Keys
3. Click "Generate New API Key"
4. Copy the key (starts with `ss_ak_`)

### 2. Install and Configure

Add this to your Claude Desktop config file:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
	"mcpServers": {
		"stepsequencer": {
			"command": "npx",
			"args": ["-y", "@stepsequencer/mcp-server"],
			"env": {
				"STEPSEQUENCER_API_KEY": "ss_ak_your_api_key_here",
				"STEPSEQUENCER_API_URL": "https://stepsequencer.ai"
			}
		}
	}
}
```

For local development, use:

```json
{
	"mcpServers": {
		"stepsequencer": {
			"command": "npx",
			"args": ["-y", "@stepsequencer/mcp-server"],
			"env": {
				"STEPSEQUENCER_API_KEY": "ss_ak_your_api_key_here",
				"STEPSEQUENCER_API_URL": "http://localhost:3000"
			}
		}
	}
}
```

### 3. Alternative: Local Installation

If you prefer installing locally first:

```bash
npm install -g @stepsequencer/mcp-server
```

Then use this config:

```json
{
	"mcpServers": {
		"stepsequencer": {
			"command": "stepsequencer-mcp-server",
			"args": [],
			"env": {
				"STEPSEQUENCER_API_KEY": "ss_ak_your_api_key_here",
				"STEPSEQUENCER_API_URL": "https://stepsequencer.ai"
			}
		}
	}
}
```

## Environment Detection

The server automatically detects your environment:

- **Production**: Uses `https://stepsequencer.ai` by default
- **Development**: Uses `http://localhost:3000` when development indicators are detected
- **Manual Override**: Set `STEPSEQUENCER_API_URL` to use a specific URL

## Available Tools

### `get_business_models`

List all your business models

### `get_business_model`

Get detailed information about a specific business model

- **name**: Business model name (e.g., "emerald landscape design")

### `get_business_concepts`

Get all business concepts for a specific business model

- **name**: Business model name

## Usage Examples

```
Claude: "Show me all my business models"
Claude: "Get details for my 'emerald landscape design' business model"
Claude: "What are the key concepts in my SaaS business model?"
```

## Troubleshooting

### Common Issues

1. **"API key required" error**

   - Make sure `STEPSEQUENCER_API_KEY` is set in your config
   - Verify the key format starts with `ss_ak_`

2. **Connection errors**

   - Check your internet connection
   - Verify the API key is valid in StepSequencer Settings

3. **"No business models found"**
   - Create business models in StepSequencer first
   - Check API key has correct permissions

### Manual Testing

Test the server directly:

```bash
STEPSEQUENCER_API_KEY=ss_ak_your_key npx @stepsequencer/mcp-server
```

## Security

- API keys are specific to your account
- Keys can be regenerated anytime in StepSequencer Settings
- Revoke keys anytime from StepSequencer Settings
- Keys only provide read access to your business models

## Support

- Documentation: [StepSequencer Docs](https://stepsequencer.ai/docs)
- Issues: [GitHub Issues](https://github.com/your-org/stepsequencer)