EuConquisto Composer MCP

for step-by-step processes - **Course Organization**: Header widgets for section structure - **Visual Collections**: Gallery widgets for image sequences #### Step 4: Access Composer for Implementation ``` Generate a Composer URL for course creation ``` ### Widget Selection Strategy #### For Different Learning Styles **Visual Learners**: ``` Get information about the image widget Get information about the gallery widget ``` - Use image widgets for single concept illustration - Use gallery widgets for sequential visual content - Consider hotspot widgets for interactive visual exploration **Kinesthetic Learners**: ``` Get information about the hotspot widget ``` - Hotspot widgets provide interactive engagement - 25+ icon options for different interaction types - Perfect for hands-on exploration activities **Auditory/Reading Learners**: ``` Get information about the text widget Get information about the list widget ``` - Text widgets for detailed explanations - List widgets for structured information - 9 text subtypes for various content formats #### For Different Content Types **Course Structure**: ``` Get information about the header widget ``` - 44 properties for comprehensive course organization - 6 different templates for various needs - SCORM integration for LMS compatibility **Instructional Content**: ``` Get information about the list widget Get information about the text widget ``` - Lists for procedures and steps - Text for explanations and context - Multiple formatting options available **Assessment and Practice**: ``` Get information about the hotspot widget ``` - Interactive elements for engagement - Multiple icon options for different question types - Visual feedback capabilities ### Advanced Usage Patterns #### Multi-Widget Course Development 1. **Course Planning**: ``` Get information about the header widget Generate a Composer URL for course creation ``` 2. **Content Development**: ``` Get information about the text widget Get information about the image widget Get information about the list widget ``` 3. **Interactive Elements**: ``` Get information about the hotspot widget Get information about the gallery widget ``` 4. **Implementation**: ``` Generate a Composer URL for widget library ``` #### LMS Integration Workflow For courses requiring LMS integration: 1. **Analyze SCORM Capabilities**: ``` Get information about the header widget ``` *(Note the SCORM integration in Template 3)* 2. **Access LMS-Compatible Templates**: ``` Generate a Composer URL for templates ``` 3. **Validate Compatibility**: ``` Test the MCP server connection ``` ## 💡 Best Practices ### Effective Widget Analysis #### Before Requesting Analysis - Know your learning objectives - Understand your target audience - Consider technical constraints (LMS requirements, device compatibility) #### During Analysis Review - Pay attention to property counts (indicates complexity/flexibility) - Note special features that align with your needs - Consider subtype variations for different use cases #### After Analysis - Match widget capabilities to content requirements - Plan widget combinations for comprehensive learning experiences - Use Composer URLs to implement your design ### Content Creation Tips #### Start with Structure ``` Get information about the header widget Generate a Composer URL for course creation ``` Use header widgets to establish course hierarchy before adding content widgets. #### Layer Content Strategically 1. **Foundation**: Headers for structure 2. **Information**: Text widgets for core content 3. **Illustration**: Image/gallery widgets for visual support 4. **Interaction**: Hotspot widgets for engagement 5. **Organization**: List widgets for summaries and steps #### Validate Your Choices ``` Test the MCP server connection ``` Regular connection tests ensure your integration remains functional during long design sessions. ## 🔧 Troubleshooting ### Common Usage Issues #### Tool Not Responding **Symptoms**: Commands don't trigger MCP tools **Solution**: 1. Test connection first: ``` Test the EuConquisto MCP server connection ``` 2. If connection fails, check Claude Desktop integration 3. Restart Claude Desktop if necessary #### Invalid Widget Type **Symptoms**: Error message about invalid widget **Solution**: Use exact widget names: - `text` (not "Text" or "texto") - `image` (not "Image" or "imagem") - `header` (not "Header" or "cabecalho") - `list` (not "List" or "lista") - `gallery` (not "Gallery" or "galeria") - `hotspot` (not "Hotspot" or "interactive") #### URL Generation Issues **Symptoms**: URLs don't work or authentication fails **Solutions**: 1. Generate fresh URL: ``` Generate a Composer URL for widget library ``` 2. Use URLs promptly (JWT tokens expire) 3. Ensure HTTPS is working in your browser ### Getting Help #### Diagnostic Commands **Check Server Status**: ``` Test the MCP server connection ``` **Verify Widget Availability**: ``` Get information about the text widget ``` **Test URL Generation**: ``` Generate a Composer URL for test ``` #### Response Validation All successful responses should include: - `"success": true` field - Relevant data for the requested operation - Human-readable messages - Proper timestamps (for connection tests) ## 📚 Example Use Cases ### Case Study 1: Science Course Creation **Objective**: Create an interactive biology course about plant structures **Workflow**: 1. **Course Structure**: ``` Get information about the header widget ``` Use header widgets for major sections (Roots, Stems, Leaves, etc.) 2. **Content Development**: ``` Get information about the text widget Get information about the image widget ``` Text widgets for explanations, image widgets for plant diagrams 3. **Interactive Elements**: ``` Get information about the hotspot widget ``` Hotspot widgets for interactive plant part identification 4. **Implementation**: ``` Generate a Composer URL for course creation ``` ### Case Study 2: Corporate Training Module **Objective**: Develop a step-by-step process training module **Workflow**: 1. **Module Structure**: ``` Get information about the header widget Get information about the list widget ``` Headers for training phases, lists for step-by-step procedures 2. **Visual Support**: ``` Get information about the gallery widget ``` Gallery widgets for before/after process examples 3. **Assessment**: ``` Get information about the hotspot widget ``` Interactive hotspots for process validation 4. **LMS Integration**: ``` Generate a Composer URL for templates ``` Access SCORM-compatible templates ### Case Study 3: Educational Game Design **Objective**: Create an interactive learning game for history education **Workflow**: 1. **Game Structure**: ``` Get information about the hotspot widget ``` Primary widget for interactive game elements 2. **Supporting Content**: ``` Get information about the image widget Get information about the text widget ``` Images for historical scenes, text for context and instructions 3. **Implementation**: ``` Generate a Composer URL for widget library ``` Access full widget library for game development ## 🎯 Advanced Features ### Widget Combination Strategies #### Text + Image Combinations ``` Get information about the text widget Get information about the image widget ``` **Best For**: Explanatory content with visual support **Pattern**: Text for explanation → Image for illustration → Text for summary #### Gallery + Hotspot Combinations ``` Get information about the gallery widget Get information about the hotspot widget ``` **Best For**: Interactive visual exploration **Pattern**: Gallery for overview → Hotspot for detailed interaction #### Header + List + Text Combinations ``` Get information about the header widget Get information about the list widget Get information about the text widget ``` **Best For**: Structured educational content **Pattern**: Header for organization → List for overview → Text for details ### Performance Optimization #### Efficient Analysis Requests - Request specific widgets rather than analyzing all types - Use connection tests sparingly (only when troubleshooting) - Generate URLs when ready to use them (tokens expire) #### Batch Operations ``` Get information about the text widget Get information about the image widget Get information about the list widget ``` Analyze multiple widgets in sequence for comprehensive planning. ## 📊 Usage Analytics ### Track Your Usage Patterns #### Widget Analysis Frequency Monitor which widgets you analyze most often to understand your content creation patterns: - Text widget: General content creation - Image widget: Visual content focus - Hotspot widget: Interactive content preference - Header widget: Structured course development #### URL Generation Patterns Track Composer access patterns: - Widget library access: Exploration phase - Course creation access: Active development - Template access: Template-based approach ### Optimize Your Workflow #### Based on Analysis Patterns - Frequent text widget analysis → Text-heavy content strategy - Regular hotspot analysis → Interactive learning focus - Consistent header analysis → Structured course approach #### Based on Composer Access - Widget library focus → Exploratory approach - Course creation focus → Direct development - Template focus → Template-driven workflow ## 🔮 Future Capabilities ### Planned Enhancements The EuConquisto MCP integration is designed for extensibility. Future versions may include: #### Additional Widget Types - Video widgets for multimedia content - Quiz widgets for assessment - Simulation widgets for interactive learning #### Advanced Analysis Features - Widget recommendation based on learning objectives - Compatibility analysis between widget combinations - Performance optimization suggestions #### Enhanced Composer Integration - Direct content creation through MCP - Real-time collaboration features - Advanced template customization ### Staying Updated #### Version Monitoring ``` Test the MCP server connection ``` Regular connection tests will show current server version and capabilities. #### Feature Discovery New tools and capabilities will be automatically available through the MCP integration without requiring manual updates. ## 📋 Quick Reference ### Essential Commands | Purpose | Command | |---------|---------| | **Server Status** | `Test the MCP server connection` | | **Text Analysis** | `Get information about the text widget` | | **Image Analysis** | `Get information about the image widget` | | **Header Analysis** | `Get information about the header widget` | | **List Analysis** | `Get information about the list widget` | | **Gallery Analysis** | `Get information about the gallery widget` | | **Hotspot Analysis** | `Get information about the hotspot widget` | | **Composer Access** | `Generate a Composer URL for [purpose]` | ### Widget Selection Quick Guide | Content Type | Recommended Widget | Analysis Command | |--------------|-------------------|------------------| | **Explanatory Text** | Text Widget | `Get information about the text widget` | | **Visual Content** | Image Widget | `Get information about the image widget` | | **Course Structure** | Header Widget | `Get information about the header widget` | | **Step-by-Step** | List Widget | `Get information about the list widget` | | **Image Collections** | Gallery Widget | `Get information about the gallery widget` | | **Interactive Elements** | Hotspot Widget | `Get information about the hotspot widget` | ### Composer Access Quick Guide | Purpose | Command | |---------|---------| | **General Access** | `Generate a Composer URL` | | **Widget Exploration** | `Generate a Composer URL for widget library` | | **Course Development** | `Generate a Composer URL for course creation` | | **Template Browsing** | `Generate a Composer URL for templates` | | **Testing** | `Generate a Composer URL for integration test` | ## 🎓 Learning Path ### Beginner (First Week) 1. **Day 1-2**: Test connection and explore basic widget analysis 2. **Day 3-4**: Generate Composer URLs and explore the platform 3. **Day 5-7**: Create first simple content using 2-3 widget types ### Intermediate (Week 2-3) 1. **Week 2**: Explore all 6 widget types and their capabilities 2. **Week 3**: Develop multi-widget content strategies and workflows ### Advanced (Week 4+) 1. **Optimize workflows** based on your content creation patterns 2. **Develop templates** for efficient content creation 3. **Master widget combinations** for complex educational experiences ## 💬 Support and Community ### Getting Help #### Technical Issues 1. Test connection first: `Test the MCP server connection` 2. Check Claude Desktop integration status 3. Review error messages for specific guidance #### Usage Questions - Refer to widget analysis results for capability questions - Use Composer platform documentation for implementation details - Consult this user guide for workflow suggestions #### Feature Requests - Document desired capabilities and use cases - Consider how new features would integrate with existing workflows - Provide specific examples of needed functionality ### Best Practices Sharing #### Effective Patterns - Share successful widget combinations - Document efficient workflows - Provide examples of effective educational content #### Common Challenges - Widget selection uncertainty → Use comprehensive analysis - Complex content structure → Start with header widgets - Interactive element design → Explore hotspot capabilities --- ## 📜 Document Information **Document Version**: 1.0 **User Guide Version**: v0.1.3 **Creation Date**: 2025-06-09 **Last Updated**: 2025-06-09 **Review Status**: Phase 3 Documentation Complete **Target Audience**: Content Creators, Educators, Developers **Prerequisites**: Claude Desktop with MCP Integration **Difficulty Level**: Beginner to Advanced **Estimated Learning Time**: 1-4 weeks depending on complexity **Dependencies**: TASK-F002 Phase 2 Complete **Validation**: User Workflows Tested ✅ **Quality Gate**: User Guide Complete --- *EuConquisto Composer MCP Server PoC - Complete User Guide* *TASK-F002 Phase 3 Documentation | Educational Content Creation Workflows | © 2025 EuConquisto Development Team*