Proxy Smart — Documentation ​

Comprehensive documentation for the Proxy Smart platform: a stateless FHIR proxy with OAuth 2.0, SMART App Launch 2.2.0, and an intelligent admin interface.

Platform Overview ​

Proxy Smart sits between SMART apps and FHIR servers, handling authentication and authorization without storing clinical data. It includes an admin dashboard, AI assistant with RAG-powered documentation search, MCP server integration, consent management, and access control.

Key Features ​

• SMART App Launch 2.2.0 — Full OAuth 2.0 with PKCE, JWT validation, scope-based access control, refresh token rotation
• Stateless FHIR Proxy — No clinical data stored; requests pass through to your FHIR servers
• Admin Dashboard — React UI for managing apps, users, servers, scopes, and identity providers
• AI Assistant & RAG — Built-in assistant with semantic documentation search (search_documentation tool)
• MCP Server — Streamable HTTP endpoint at /mcp exposing all admin tools + documentation search
• Consent Management — Patient consent app for authorization flows (consent-app/)
• DTR App — Documentation, Templates & Rules app (dtr-app/)
• Access Control — Physical access integrations (Kisi, UniFi Access)
• AI Skills System — Installable skills for extending AI assistant capabilities
• Docker-Ready — Mono-container and multi-container deployments

Documentation ​

Admin UI ​

• Dashboard Overview — System overview and health monitoring
• User Management — Healthcare users and FHIR associations
• SMART Apps — Application registration and management
• FHIR Servers — Server configuration and monitoring
• Scope Management — FHIR permissions and templates
• Access Control — Physical door management (Kisi, UniFi Access)
• Monitoring & Observability — OAuth, FHIR health, consent, and audit monitoring

AI & MCP ​

• MCP HTTP Server — Streamable HTTP endpoint architecture and usage
• AI MCP Integration — How the AI assistant connects to MCP servers
• Backend API Tools — Auto-generated tools from Elysia routes
• Backend MCP HTTP Client — HTTP-based MCP client
• Backend MCP Streamable Client — Streamable HTTP MCP client
• AI Interactive Actions — Interactive action system
• Adding Custom Tools — Guide for adding custom AI tools
• Action Quick Reference — AI action reference card
• Interactive Actions Guide — Detailed interactive actions docs

SMART on FHIR ​

• SMART 2.2.0 Implementation Checklist — Spec compliance status

Guides ​

• Version Management — Branching, versioning, and releases

AI Assistant ​

The platform includes an AI assistant powered by RAG (Retrieval Augmented Generation). It indexes all documentation in this docs/ directory using OpenAI embeddings and serves relevant context via:

• AI chat tool — search_documentation called by the assistant during conversations
• MCP endpoint — Available to external MCP clients at /mcp
• Public HTTP API — GET /docs/search/semantic?q=... for direct access

The assistant can answer questions about SMART on FHIR, platform configuration, OAuth flows, and admin operations using up-to-date documentation.

Additional Resources ​

• SMART App Launch Framework
• FHIR R4 Specification
• OAuth 2.0 RFC
• OpenID Connect

This documentation is indexed by the RAG knowledge base for AI-powered search.