#AI Chat System Documentation

Consolidated documentation for the Flash Turbo CMS AI Chat MCP integration feature.

#Main Guide

→ AI_CHAT_GUIDE.md - START HERE

Complete consolidated guide containing:

• Quick start for users and developers
• Architecture and component overview
• API endpoint reference
• Message format specifications
• Configuration and customization
• Testing procedures
• Troubleshooting guide
• Performance and security considerations
• Future enhancement plans

#Implementation Files

Code Location:

• API: apps/multi-store/src/app/(misc)/api/ai/chat-mcp/
• Manager UI: apps/multi-store/src/app/(manager)/[slug]/manager/ai-chat/
• Overlay: apps/multi-store/src/components/ai/overlay/AIChatOverlayModern.tsx
• CMS Block: apps/multi-store/src/blocks/AIChatOverlayModern/

#Feature Status

Status: ✅ Production Ready

Key Components:

• Modern streaming chat using streamText and useChat
• MCP server integration at /api/llm/mcp
• Manager page interface at /manager/ai-chat
• Floating overlay for any page
• CMS block for easy integration

#Archived Documentation

Legacy and session-specific docs are in docs/archive/:

• AI_CHAT_MODERN_GUIDE.md - Original modern implementation guide
• AI_CHAT_MCP_SERVER_SETUP.md - MCP setup reference
• AI_CHAT_WORK_PENDING.md - Feature tracking (archive)
• MERGE_SUMMARY_AI_CHAT.md - Merge details (archive)
• QUICK_START_MAIN.md - Original quick start (archive)

These are kept for historical reference only. Use AI_CHAT_GUIDE.md for current work.

#Quick Navigation

Need	Location
Quick setup	AI_CHAT_GUIDE.md
Add to page	AI_CHAT_GUIDE.md
Troubleshooting	AI_CHAT_GUIDE.md
Architecture	AI_CHAT_GUIDE.md
Testing	AI_CHAT_GUIDE.md
Security	AI_CHAT_GUIDE.md
History	docs/archive/ folder