How decocms/studio works
deco Studio is an organization-focused AI workspace and control plane: users configure agents, connect governed MCP systems, select models, and expose capabilities to clients. The documented product also includes projects, virtual MCPs, observability, access control, multi-tenancy, bindings, and a store. The graph combines those documented capabilities with sampled API startup, Decopilot harness, storage, and monitoring components. Edges backed only by product-level documentation cite the README; uncertain implementation links are omitted. Unsampled subsystems are represented by their existing directories.
Main entry points: decopilot Agent harness · pipeline.ts Startup pipeline · api Studio API · routes MCP connections
Components 18
Clients and API
- Studio API
apps/api/src/api - Decopilot routes
apps/api/src/api/routes/decopilot
Agents and models
- Agent harness
apps/api/src/harnesses/lib/decopilot - Model providers
apps/api/src/ai-providers
Connections and governance
- MCP connections
apps/api/src/api/routes - Virtual MCPs
apps/api/src/api/routes/virtual-mcp.ts - Access control
apps/api/src/auth - Capability bindings
packages/bindings/src
Workspace platform
- Projects
apps/api/src/api/routes - Agent and tool store
apps/api/src/api/routes - Object storage
apps/api/src/object-storage - Usage observability
apps/api/src/monitoring/query-engine.ts
Runtime services
- Settings resolution
apps/api/src/settings/resolve-config.ts - Startup pipeline
apps/api/src/settings/pipeline.ts - Service provisioning
apps/api/src/services/ensure-services.ts - PostgreSQL database
apps/api/src/database/index.ts
Other components
- Team users
- Agent clients
Connections 16
- Team users → Studio API: configure workspace
README.md - Agent clients → Studio API: use MCP endpoint
README.md - Studio API → Decopilot routes: routes requests
- Decopilot routes → Agent harness: dispatches runs
- Agent harness → Model providers: selects models
- Agent harness → MCP connections: uses MCP tools
README.md - MCP connections → Virtual MCPs: composes toolsets
README.md - Access control → MCP connections: governs access
README.md - Agent harness → Capability bindings: uses contracts
README.md - Team users → Projects: organize work
README.md - Team users → Agent and tool store: discover capabilities
README.md - Agent harness → Object storage: stores artifacts
- Agent harness → Usage observability: accounts usage
README.md - Startup pipeline → Settings resolution: resolves config
apps/api/src/settings/pipeline.ts - Startup pipeline → Service provisioning: starts services
apps/api/src/settings/pipeline.ts - Startup pipeline → PostgreSQL database: runs migrations
apps/api/src/settings/pipeline.ts