Worksona MCP Server

# 🚀 Worksona MCP Server - Quick Start Guide Your Worksona MCP server has been built successfully! Follow these steps to integrate it with Claude Desktop. ## ✅ What's Built - **Complete MCP Server** with 100+ Worksona agents - **4 Coordination Modes**: Sequential, Parallel, Review, Executive - **6 MCP Tools**: `activate_agent`, `coordinate_team`, `suggest_agents`, `research_workflow`, `list_agents`, `agent_info` - **Automatic Agent Discovery** from the bundled agents directory - **Memory Management** for cross-agent context ## 🔧 Configure Claude Desktop ### Step 1: Find Your Config File **macOS**: `~/.claude-desktop/config.json` **Windows**: `%APPDATA%/Claude/config.json` ### Step 2: Add MCP Server Configuration Add this to your Claude Desktop config file: ```json { "mcpServers": { "worksona-agents": { "command": "/usr/local/bin/worksona-mcp-server" } } } ``` > **Note**: No API key needed! The MCP server automatically detects it's running inside Claude Desktop and uses Claude's built-in AI processing. ### Step 3: Restart Claude Desktop Close and reopen Claude Desktop to load the MCP server. ## 🎮 Test Your Installation ### Basic Agent Test Try this in Claude Desktop: ``` I need help creating API documentation for my REST service ``` **Expected Result**: Claude will automatically use the `activate_agent` tool with the `doc-writer` agent. ### Multi-Agent Test Try this: ``` Build a complete user authentication system with security review ``` **Expected Result**: Claude will use `coordinate_team` to coordinate multiple agents (backend-architect, security-auditor, frontend-developer). ### Agent Discovery Test Try this: ``` What agents do you have available for database optimization? ``` **Expected Result**: Claude will use `suggest_agents` or `list_agents` to show database specialists. ## 🔍 Available MCP Tools Your server provides these tools to Claude: | Tool | What It Does | Example | |------|-------------|---------| | `activate_agent` | Single expert agent | "Create a React component" | | `coordinate_team` | Multiple agents working together | "Build full-stack app with security" | | `suggest_agents` | Find the right agent for your task | "Who can help with performance?" | | `list_agents` | Browse all available agents | "Show me all frontend agents" | ## 🎯 Usage Examples ### Single Agent (Level 1 Usage) ``` Create a comprehensive README file for my project ``` → Activates `doc-writer` agent ### Team Coordination (Level 3 Usage) ``` Design and implement a secure payment processing system ``` → Coordinates `backend-architect` + `security-auditor` + `payment-integration` specialists ### Research Workflow (Level 4 Usage) ``` Research the competitive landscape for AI coding assistants ``` → Deploys research team: `search-specialist` + `content-analyzer` + `competitive-analyst` ## 🛠️ Troubleshooting ### Server Won't Start 1. Check the console output when starting Claude Desktop 2. Verify the file path in config.json is correct 3. Test the server manually: `./start.sh` ### No Tools Available 1. Restart Claude Desktop after configuration changes 2. Check that config.json syntax is valid 3. Verify the MCP server can find agents directory ### Agents Not Loading 1. Check that WORKSONA_AGENTS_PATH environment variable is set (if using custom path) 2. Verify agent metadata.json files exist and are valid 3. Look for error messages in the console ## 🎉 Success Indicators You'll know it's working when: - ✅ Claude Desktop shows "Connected to MCP servers" or similar - ✅ Claude can activate individual agents by name - ✅ Claude can coordinate multiple agents for complex tasks - ✅ You see agent responses with execution details and suggested next steps ## 📞 Need Help? - Check the main README.md for detailed troubleshooting - Verify Claude Desktop MCP documentation - Test individual components by running `./start.sh` manually **Congratulations! Your Worksona MCP Server is ready to transform Claude Desktop into a powerful multi-agent coordination platform! 🎊**