Adeptia MCP Server

%%{init: {
  'theme': 'dark',
  'themeVariables': {
    'primaryColor': '#1e1e3f',
    'primaryTextColor': '#ffffff',
    'primaryBorderColor': '#0A4ECD',
    'lineColor': '#3C7BEF',
    'secondaryColor': '#16213e',
    'tertiaryColor': '#0f3460',
    'fontSize': '14px'
  }
}}%%
%% Adeptia MCP Server Architecture - Strangler Fig Pattern
%% Reference: /kb-development/core/02-standards/diagrams/
%% Updated: January 14, 2026 - Added direct DB access path (not recommended)

flowchart LR
    subgraph clients[" "]
        direction TB
        c_title["AI APPLICATIONS
Any MCP-compatible client"]
        aa5["Adeptia v5
Automate UI"]
        forge["Adeptia MCP UI
AI Integration"]
        assistants["Claude, Cody, Zed
AI Assistants"]
        ides["Cursor, Replit, VS Code
AI Code Editors"]
    end

    subgraph transport[" "]
        direction TB
        tr_title["TRANSPORTS"]
        stdio["stdio
CLI / Desktop"]
        http["HTTP
Web Apps"]
    end

    subgraph mcp[" "]
        direction TB
        m_title["ADEPTIA MCP SERVER"]
        mcpcore["MCP
Standardized Protocol"]
    end

    subgraph tools[" "]
        direction TB
        t_title["MCP CAPABILITIES"]
        discovery["Discovery
Connectors & Templates"]
        validation["Validation
Config & Mapping"]
        workflow["Workflow
Create & Deploy"]
        monitoring["Monitoring
Dashboard & Logs"]
    end

    subgraph router[" "]
        direction TB
        r_title["BACKEND ROUTER"]
        route["Route by Capability
Strangler Fig"]
    end

    subgraph api[" "]
        a_title["API LAYER"]
        direct_db["Automate v5 SQL
Direct SQL (brute-force)"]
        connect_api["Automate v5 API
WebRunner (read) / Runtime (execute)"]
        new_api["New Services
Modern Stack (H2 2026)"]
    end

    subgraph data[" "]
        d_title["DATA"]
        database["Automate v5 DB
PostgreSQL"]
        v6db["v6 Database
Future"]
        kb["Knowledge Base
Integration KB + Qdrant"]
    end

    subgraph backend[" "]
        b_title["EXECUTION"]
        platform["Automate v5
Current Runtime"]
        future["v6 Platform
Future"]
    end

    assistants --> stdio
    ides --> stdio
    forge --> http
    aa5 --> http
    stdio --> mcpcore
    http --> mcpcore
    mcpcore --> discovery
    mcpcore --> validation
    mcpcore --> workflow
    mcpcore --> monitoring
    discovery --> route
    validation --> route
    workflow --> route
    monitoring --> route
    route --> connect_api
    route --> direct_db
    route -.-> new_api
    connect_api --> platform
    new_api -.-> platform
    new_api -..-> future
    platform --> database
    future -..-> v6db
    direct_db -.-> database
    route -.-> kb

    classDef titleStyle fill:none,stroke:none,color:#64748b,font-size:12px
    classDef clientBox fill:#1e293b,stroke:#3b82f6,stroke-width:2px,color:#fff
    classDef transportBox fill:#1e293b,stroke:#22c55e,stroke-width:2px,color:#fff
    classDef mcpBox fill:#1a2e1a,stroke:#22c55e,stroke-width:3px,color:#fff
    classDef toolsBox fill:#1e3a5f,stroke:#3b82f6,stroke-width:2px,color:#fff
    classDef routerBox fill:#2d1f3d,stroke:#a855f7,stroke-width:2px,color:#fff
    classDef connectApiBox fill:#2d2a1a,stroke:#f59e0b,stroke-width:2px,color:#fff
    classDef newApiBox fill:#1a2e1a,stroke:#22c55e,stroke-width:2px,stroke-dasharray:5 5,color:#fff
    classDef backendBox fill:#0d2847,stroke:#64748b,stroke-width:2px,color:#fff
    classDef futureBox fill:#1a2e1a,stroke:#22c55e,stroke-width:2px,stroke-dasharray:8 4,color:#86efac
    classDef directDbBox fill:#3d1a1a,stroke:#ef4444,stroke-width:2px,stroke-dasharray:5 5,color:#fca5a5
    classDef dataBox fill:#1e293b,stroke:#64748b,stroke-width:2px,color:#fff
    classDef invisible fill:none,stroke:none

    class c_title,m_title,t_title,r_title,a_title,b_title,tr_title,d_title titleStyle
    class assistants,ides clientBox
    class forge mcpBox
    class aa5 connectApiBox
    class stdio,http transportBox
    class mcpcore mcpBox
    class discovery,validation,workflow,monitoring toolsBox
    class route mcpBox
    class connect_api connectApiBox
    class new_api newApiBox
    class platform connectApiBox
    class future futureBox
    class direct_db directDbBox
    class database connectApiBox
    class v6db futureBox
    class kb dataBox
    class clients,transport,mcp,tools,router,api,backend,data invisible

      

AI Applications → Transports → MCP Server → Backend Router → API Layer → Execution