Simplify MCP documentation per GitHub feedback

devin-ai-integration[bot] · adhami3310 · devin-ai-integration[bot] · commit 85c1160d826a · 2025-07-29T00:26:18.000Z
- Remove all spacing elements (rx.box height elements) - Remove hardcoded examples and detailed explanations - Remove entire Best Practices and Troubleshooting sections - Remove Other MCP Clients table section - Simplify Available Tools section to just mention capabilities - Add link to official MCP documentation - Keep only essential installation and IDE configuration info Addresses all GitHub comments from @adhami3310 on PR #1549 Co-Authored-By: khaleel@reflex.dev <khaleel.aladhami@gmail.com>
diff --git a/docs/ai_builder/integrations/mcp.md b/docs/ai_builder/integrations/mcp.md
@@ -4,18 +4,9 @@
 import reflex as rx
 ```
 
-The Reflex Model Context Protocol (MCP) integration provides AI assistants and coding tools with structured access to Reflex framework documentation and component information. This enables intelligent assistance while developing Reflex applications.
+The Reflex [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) integration provides AI assistants and coding tools with structured access to Reflex framework documentation and component information. This enables intelligent assistance while developing Reflex applications.
 
-## What is Model Context Protocol (MCP)?
-
-Model Context Protocol (MCP) is a standardized way for AI tools to access external data sources and services. The Reflex MCP server provides real-time access to:
-
-- **Component Documentation**: Complete documentation for all Reflex components with source code
-- **Documentation Sections**: Hierarchical access to all Reflex documentation
-- **Resource Discovery**: Browse available components and documentation as MCP resources
-- **Tool-based Access**: Retrieve specific documentation through standardized MCP tools
-
-The Reflex MCP server is deployed at `https://mcp.reflex.dev/mcp` and uses streamable HTTP transport for maximum compatibility with different AI tools.
+The Reflex MCP server is deployed at `https://mcp.reflex.dev/mcp` and provides access to component documentation and Reflex documentation through standardized MCP tools.
 
 ## Installation
 
@@ -29,31 +20,7 @@ To use the Reflex MCP integration, you'll need to configure your AI assistant or
 
 ## Authentication
 
-```python eval
-rx.box(height="1rem")
-```
-
-```python eval
-rx.accordion.root(
-    rx.accordion.item(
-        header="Authentication Details",
-        content=rx.box(
-            rx.text("The Reflex MCP server uses ", rx.el.span("OAuth 2.1 protocol", font_weight="bold"), " for secure authentication."),
-            rx.box(height="0.5rem"),
-            rx.text("• ", rx.el.span("Reflex account required", font_weight="bold")),
-            rx.text("• ", rx.el.span("OAuth 2.1 authentication", font_weight="bold")),
-            rx.text("• ", rx.el.span("Secure token-based access", font_weight="bold")),
-            rx.box(height="0.5rem"),
-            rx.text("Authentication is handled automatically through your MCP client configuration when you provide your Reflex credentials."),
-        ),
-    ),
-    variant="surface",
-)
-```
-
-```python eval
-rx.box(height="1rem")
-```
+The Reflex MCP server uses OAuth 2.1 protocol for secure authentication. You'll need a valid Reflex account, and authentication is handled automatically through your MCP client configuration when you provide your Reflex credentials.
 
 ## IDE and Coding Assistant Integration
 
@@ -103,138 +70,7 @@ env = { "MCP_PROXY_URL" = "https://mcp.reflex.dev/mcp" }
 
 Note: Codex requires MCP servers to communicate over stdio. The `@modelcontextprotocol/server-proxy` adapter bridges the connection to the HTTP-based Reflex MCP server.
 
-### Other MCP Clients
-
-For other MCP-compatible tools, use this endpoint:
-
-```python eval
-rx.table.root(
-    rx.table.header(
-        rx.table.row(
-            rx.table.column_header_cell("Transport"),
-            rx.table.column_header_cell("URL"),
-            rx.table.column_header_cell("Authentication"),
-        ),
-    ),
-    rx.table.body(
-        rx.table.row(
-            rx.table.row_header_cell(rx.code("HTTP")),
-            rx.table.cell(rx.code("https://mcp.reflex.dev/mcp")),
-            rx.table.cell("OAuth 2.1 via MCP client"),
-        ),
-    ),
-    width="100%",
-)
-```
 
 ## Available Tools
 
-The Reflex MCP server provides several tools for accessing documentation and component information:
-
-### Component Documentation
-
-**`get_component_doc`** - Retrieve comprehensive documentation for any Reflex component, including markdown documentation, Python source code, and related component sources.
-
-Example usage: "Show me the Button component documentation"
-
-**`list_components`** - Browse all available Reflex components organized by category.
-
-Example usage: "What form components are available in Reflex?"
-
-### Documentation Access
-
-**`list_doc_sections`** - Explore the complete Reflex documentation structure hierarchically.
-
-Example usage: "What documentation sections are available?"
-
-**`get_doc`** - Read any specific documentation file from the Reflex documentation.
-
-Example usage: "Show me the getting started guide"
-
-## Best Practices
-
-### Effective Usage
-
-1. **Be Specific**: When asking for component documentation, specify the exact component name for best results.
-
-2. **Explore Categories**: Use `list_components` to discover components by category before diving into specific documentation.
-
-3. **Leverage Context**: The MCP server provides rich context including source code, which helps AI assistants give more accurate advice.
-
-4. **Documentation Structure**: Use `list_doc_sections` to understand the full scope of available documentation before asking specific questions.
-
-### Optimization Tips
-
-- **Component Discovery**: Start with category-based searches to find the right components for your use case
-- **Source Code Access**: The server provides both documentation and source code, enabling deeper understanding of component behavior
-- **Related Components**: Component documentation includes information about related components through YAML frontmatter parsing
-
-## Troubleshooting
-
-### Connection Issues
-
-**Problem**: AI assistant cannot connect to the MCP server
-
-**Solutions**:
-- Verify your internet connection
-- Check that the server is running by visiting `https://mcp.reflex.dev/mcp`
-- Ensure your MCP client configuration uses the correct URL format
-- Verify your OAuth 2.1 authentication credentials are valid
-
-### Configuration Problems
-
-**Problem**: MCP server not appearing in your AI tool
-
-**Solutions**:
-- Double-check the configuration file syntax (JSON/TOML formatting)
-- Restart your AI assistant after adding the configuration
-- Verify the configuration file is in the correct location for your tool
-- Check your AI tool's documentation for MCP setup requirements
-
-### Limited Functionality
-
-**Problem**: Some tools or documentation not accessible
-
-**Solutions**:
-- Some features may be temporarily unavailable during updates
-- Check the server status at `https://mcp.reflex.dev/mcp`
-- Verify your authentication credentials are properly configured
-- Report issues to the Reflex team for investigation
-
-### Performance Issues
-
-**Problem**: Slow responses from the MCP server
-
-**Solutions**:
-- The server is hosted and may experience occasional latency
-- Large documentation requests may take longer to process
-- Consider breaking complex queries into smaller, specific requests
-- Check your network connection stability
-
-## Server Status
-
-You can check if the Reflex MCP server is running by visiting: `https://mcp.reflex.dev/mcp`
-
-The endpoint will show server information and available MCP capabilities.
-
-```python eval
-rx.box(height="1rem")
-```
-
-```python eval
-rx.accordion.root(
-    rx.accordion.item(
-        header="Alpha Service Notice",
-        content=rx.box(
-            rx.text("⚠️ ", rx.el.span("ALPHA VERSION", font_weight="bold"), ": This MCP server is currently in alpha and under active development."),
-            rx.box(height="0.5rem"),
-            rx.text("• Features may change without notice"),
-            rx.text("• Occasional downtime for updates and improvements"),
-            rx.text("• Your feedback helps improve the service"),
-            rx.box(height="0.5rem"),
-            rx.text("We appreciate your patience as we continue to enhance the Reflex MCP integration."),
-        ),
-    ),
-    variant="surface",
-)
-```
+The Reflex MCP server provides tools for accessing component documentation and Reflex documentation through standardized MCP capabilities.
