Add comprehensive MCP integration documentation

[devin-ai-integration]

Restructure MCP sidebar: remove from Learn section, add Overview/Installation subsections

Summary

This PR addresses GitHub feedback to ensure MCP only appears in its own top-level section in the AI Builder sidebar, divided into "Overview" and "Installation" subsections. Previously, MCP was appearing in both the Learn section's Integrations and as its own top-level section.

Key changes:

• Removed MCP from the Learn section's Integrations list
• Created dedicated get_sidebar_items_mcp() function with Overview and Installation subsections
• Updated sidebar.py to use the new MCP structure instead of referencing the Learn section's items
• Added clear section headers in the MCP documentation

Review & Testing Checklist for Human

• Test sidebar navigation: Verify MCP no longer appears in Learn → Integrations section
• Verify MCP top-level section: Confirm MCP appears as its own section next to "Learn" with Overview and Installation subsections
• Test subsection navigation: Click through Overview and Installation subsections to ensure they work (both currently point to same page)
• Check visual layout: Ensure sidebar styling and spacing looks correct for the new structure
• End-to-end navigation flow: Test clicking between different sidebar sections to ensure no broken links or unexpected behavior

Note: Due to environment issues, I couldn't fully test the changes locally with reflex run, so manual verification of the sidebar behavior is critical.

---

Diagram

%%{ init : { "theme" : "default" }}%%
graph TD
    ai_py["pcweb/components/docpage/<br/>sidebar/sidebar_items/ai.py"]:::major-edit
    sidebar_py["pcweb/components/docpage/<br/>sidebar/sidebar.py"]:::major-edit
    mcp_md["docs/ai_builder/<br/>integrations/mcp.md"]:::minor-edit
    
    ai_py -->|"imports mcp_items"| sidebar_py
    ai_py -->|"references"| mcp_md
    
    integrations["Learn Section<br/>Integrations"]:::context
    mcp_section["MCP Top-level<br/>Section"]:::context
    
    ai_py -->|"removed MCP from"| integrations
    ai_py -->|"created subsections for"| mcp_section
    
    subgraph Legend
        L1[Major Edit]:::major-edit
        L2[Minor Edit]:::minor-edit  
        L3[Context/No Edit]:::context
    end

classDef major-edit fill:#90EE90
classDef minor-edit fill:#87CEEB
classDef context fill:#FFFFFF

Loading

Notes

• This addresses the specific GitHub PR feedback requesting MCP only appear in its own section
• Both Overview and Installation subsections currently point to the same MCP documentation page - this could be enhanced in future PRs to have separate content
• The changes follow existing patterns in the codebase (similar to how enterprise.py structures subsections)
• CI shows 7/8 checks passing with one unrelated unit test failure
  that was present before these changes

Session: https://app.devin.ai/sessions/9bcd2cfb49e44df0a684451b88c0b6a8
Requested by: @adhami3310
Ticket: ENG-6748

[linear]

ENG-6748 Document Reflex MCP - page in the docs

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[greptile-apps]

Greptile Summary

This PR adds comprehensive documentation for the Reflex Model Context Protocol (MCP) integration to the website. The change introduces a new documentation page at docs/ai_builder/integrations/mcp.md that provides complete guidance for users to install, configure, and use the Reflex MCP server with various AI assistants and coding tools.

The documentation covers installation instructions, authentication (noting the alpha service requires no auth currently), and detailed configuration examples for multiple IDEs including Claude Desktop, Windsurf/Cascade, and Codex. It documents the MCP server endpoints at https://reflex-mcp-server.fly.dev with both SSE and HTTP transport options, and includes troubleshooting sections and best practices.

To integrate this new documentation into the site, the PR makes a minimal change to pcweb/components/docpage/sidebar/sidebar_items/ai.py, adding a single line (ai_builder.integrations.mcp) to the AI Builder integrations section. This leverages Reflex's existing namespace-based documentation system where markdown files in the docs/ directory are automatically converted to routes and made available through the sidebar navigation.

The documentation follows established patterns in the AI Builder section and uses appropriate Reflex components like accordions and tables for interactive content, maintaining consistency with the rest of the documentation site.

Confidence score: 4/5

• This PR appears safe to merge with well-structured documentation following established patterns and minimal navigation changes
• Score reflects the alpha status of the documented service and inability to verify external endpoints, but the implementation itself follows proper conventions
• The new documentation file needs attention to verify technical accuracy of server endpoints and IDE configuration examples

_{2 files reviewed, 1 comment}

_{Edit Code Review Bot Settings | Greptile}

[adhami3310]

the docs for this are mostly wrong, the only supported domain is https://mcp.reflex.dev/mcp which uses streamable http protocol. there are no public repo to be run, and that domain will authenticate using the OAuth 2.1 protocol

[adhami3310]

can you add this as a section next to "Learn" in the "AI Builder"?

[adhami3310]

make it such that it only appears in its own section, not in the learn section, and divide it into overview and installation

[adhami3310]

divide the article to two, one for overview and one for installation, also those shouldn't be sections they should be articles under one section

[adhami3310]

you should make the page says Overview/Installation not MCP Overview/MCP Installation

[Alek99]

looks good now