Claude Desktop Setup Guide
Complete guide to integrating Bootspring with Claude Desktop using MCP (Model Context Protocol).
Overview#
Claude Desktop is Anthropic's official desktop application for Claude. Bootspring integrates via MCP to provide:
- Project Context - Claude understands your codebase
- Expert Agents - Access 35+ specialized AI agents
- Skill Patterns - Apply production-ready patterns
- Workflows - Multi-phase development orchestration
Prerequisites#
- Claude Desktop installed
- Bootspring CLI installed (
npm install -g bootspring) - Node.js 18+ installed
- Bootspring account (free tier works)
Installing Claude Desktop#
macOS#
- Download from claude.ai/download
- Open the
.dmgfile - Drag Claude to Applications
- Launch Claude Desktop
- Sign in with your Anthropic account
Windows#
- Download from claude.ai/download
- Run the installer
- Follow installation prompts
- Launch Claude Desktop
- Sign in with your Anthropic account
Linux#
AppImage:
Snap (when available):
MCP Server Setup#
Automatic Installation#
The easiest way to configure Bootspring MCP:
This command:
- Locates Claude Desktop config
- Adds Bootspring MCP server entry
- Configures API key
- Verifies connection
Verify Installation#
Expected output:
MCP Server Status
=================
Server: bootspring
Status: Configured ✓
Config: ~/.config/Claude/claude_desktop_config.json
Connection test: Success ✓
Available tools: 12
Available resources: 3
Tools:
✓ bootspring_context
✓ bootspring_agent
✓ bootspring_skill
✓ bootspring_workflow
...
Manual Configuration#
If automatic setup fails, configure manually.
macOS:
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
Windows:
Edit %APPDATA%\Claude\claude_desktop_config.json:
Linux:
Edit ~/.config/Claude/claude_desktop_config.json:
Restart Claude Desktop#
After configuration, restart Claude Desktop:
- Quit Claude Desktop completely
- Relaunch the application
- Check for "bootspring" in the tools menu
Available MCP Tools#
bootspring_context#
Get project context and understanding.
Usage in Claude:
Use bootspring_context to understand the project structure.
Returns:
- Project overview
- Tech stack
- Architecture summary
- Key files and patterns
bootspring_agent#
Invoke expert agents for specialized tasks.
Usage in Claude:
Use bootspring_agent to invoke the security-expert and review the authentication flow.
Available agents:
frontend-expertbackend-expertdatabase-expertsecurity-expertperformance-experttesting-expert- And 30+ more
bootspring_skill#
Apply skill patterns to generate code.
Usage in Claude:
Use bootspring_skill to apply the api-endpoint pattern for a user registration endpoint.
Available patterns:
patterns/api-endpointpatterns/react-componentpatterns/prisma-crudauth/jwt- And 50+ more
bootspring_workflow#
Start and manage development workflows.
Usage in Claude:
Use bootspring_workflow to start the feature-development workflow for implementing user notifications.
Available workflows:
preseed- Idea to documentationseed- Project scaffoldingfeature-development- Full feature lifecyclesecurity-audit- Security review- And more
bootspring_generate#
Regenerate project context.
Usage in Claude:
Use bootspring_generate to update the project context after recent changes.
bootspring_quality#
Run quality checks.
Usage in Claude:
Use bootspring_quality with the pre-commit preset to check code quality.
bootspring_todo#
Manage project todos and tasks.
Usage in Claude:
Use bootspring_todo to add "Implement error handling" to the task list.
MCP Resources#
project://context#
Access current project context.
Usage:
Read the project://context resource to understand the codebase.
project://config#
Access Bootspring configuration.
Usage:
Read project://config to see available agents and settings.
project://agents#
List available agents and their capabilities.
Usage:
Read project://agents to see which experts I can invoke.
Using Bootspring in Claude#
Basic Workflow#
- Start a conversation about your project
- Request context: "Use bootspring_context to understand my project"
- Get help: "Use bootspring_agent to invoke the frontend-expert for this component"
- Apply patterns: "Use bootspring_skill to apply the form-validation pattern"
Example Conversations#
Understanding the codebase:
User: I'm working on a Next.js project. Help me understand the architecture.
Claude: I'll use the project context to understand your codebase.
[Uses bootspring_context]
Based on the context, your project is a Next.js 14 application with:
- App Router architecture
- Prisma for database (PostgreSQL)
- JWT sessions for authentication
- Tailwind CSS for styling
The main routes are...
Getting expert help:
User: I need to optimize my database queries. They're getting slow.
Claude: Let me invoke the database expert to analyze this.
[Uses bootspring_agent: database-expert]
The database expert recommends:
1. Add indexes on frequently queried columns
2. Use connection pooling
3. Implement query result caching
...
Applying patterns:
User: Create a new API endpoint for user preferences.
Claude: I'll apply the API endpoint pattern for this.
[Uses bootspring_skill: patterns/api-endpoint]
Here's the endpoint following your project's patterns:
[Generated code]
Configuration Options#
API Key Management#
Environment variable (recommended for CI):
Direct key (for personal use):
Custom Node Path#
If Node.js isn't in the default path:
nvm Users#
For nvm installations:
macOS/Linux:
Project-Specific Configuration#
For project-specific settings:
Multiple Projects#
Project Switching#
Claude Desktop uses the current working directory. To switch projects:
- Open a new conversation
- Ask Claude to read context from a specific directory
Or configure multiple servers:
Troubleshooting#
MCP Server Not Appearing#
-
Check configuration file exists
Loading code block... -
Validate JSON syntax
Loading code block... -
Restart Claude Desktop completely
-
Check logs
- macOS:
~/Library/Logs/Claude/ - Windows:
%LOCALAPPDATA%\Claude\logs\ - Linux:
~/.local/share/Claude/logs/
- macOS:
Connection Errors#
Tool Invocation Failures#
-
Check API key
Loading code block... -
Verify project initialization
Loading code block... -
Test tool manually
Loading code block...
Permission Errors#
macOS:
Linux:
Node.js Not Found#
Security Best Practices#
API Key Protection#
- Never commit API keys to version control
- Use environment variables for CI/CD
- Rotate keys regularly via dashboard
- Use read-only keys when possible
Permission Scopes#
Configure minimal permissions:
Network Security#
MCP communicates locally. For remote setups:
- Use SSH tunneling
- Enable TLS
- Configure firewall rules
Advanced Configuration#
Custom MCP Server#
Run your own MCP server:
Debug Mode#
Enable verbose logging:
Health Checks#
Monitor MCP server health:
Uninstalling#
Remove MCP Configuration#
Or manually edit the config file and remove the bootspring entry.
Verify Removal#
- Restart Claude Desktop
- Verify "bootspring" no longer appears in tools