System design

Architecture

DCOS is a field-deployable stack: Claude Desktop orchestrates local MCP servers that read CRM truth, search account memory, and research the web — then persona instructions shape the output.

High-level view

Nothing in this diagram runs as a multi-tenant SaaS. The rep's laptop (or their Cloud project) holds credentials and indices; Claude calls tools over MCP when a session is active.

Components

Client

Claude Desktop

Chat UI, Cowork tasks, and scheduled Routines. Loads local .mcpb extensions for DCOS and Jina.

MCP

DCOS extension

13+ tools: Salesforce queries, ES search, note indexing, connector calls, index setup. Runs in-process via bundled Node.

MCP

Jina extension

Web search and URL extraction for news, earnings, competitive signals — woven into account prep and briefs.

Data

Elasticsearch

Account memory: notes, synced opps, activities, signals. Full-text search powers delta comparison across briefs.

External

Salesforce

System of record. Browser SSO via sf CLI — live SOQL at brief time plus optional background sync to ES.

Optional

Connectors

Pluggable internal tools in connectors.yaml — Slack, Elastic KB, support APIs — via dcos_connector_call.

Morning brief data flow

  1. Load profiledcos_user_profile returns persona (AVP, AE, …) and account watchlist from ~/.config/dcos/.
  2. Refresh CRMdcos_sfdc_sync pulls opportunity changes into dcos_opportunities.
  3. Internal contextdcos_search across notes, prior briefs, activities, and signals per account.
  4. External research — Jina parallel_search_web for trigger events, leadership changes, competitive news.
  5. Synthesize — Persona instructions format an Executive Daily Brief with MEDDPIC gaps and one action per account.
  6. Persistdcos_add_note saves findings so tomorrow's brief can diff against today.
Design principle: CRM numbers come from tools, not from the model. Instructions explicitly forbid inventing ACV, stage, or close dates.

Elasticsearch indices

IndexContents
dcos_notes MEDDPIC notes, brief findings, rep commentary — primary memory for search
dcos_opportunities Salesforce opportunities synced for full-text search and territory rollups
dcos_activities Tasks, events, and activity history linked to accounts
dcos_signals External and internal signals (news hooks, health indicators, expansion cues)

Persona routing

One install, multiple lenses. Profile + prompt choose how Claude prioritizes and formats output:

PersonaPrimary output
AVP / LeaderTerritory pulse, rep handoffs, MEDDPIC heat map, leadership talking points
Account ExecutiveDeal scorecard, discovery questions, talk track, next action per opp
SDRTrigger events, ICP fit, outbound hooks — pre-qualify I, M, C only
Solution ArchitectDecision criteria matrix, PoC plan, architecture talking points
Customer ArchitectCustomer health, expansion plays, advocacy opportunities

In Cursor, persona subagents can run in parallel for AVP rollups. In Claude Desktop, project instructions and prompt templates provide the same routing.

Deployment models

Field laptop (default)

Elastic Cloud

Always-on sync (optional)

Background sfdc-sync on a timer keeps ES fresh without Claude running. Scheduled Claude Routines read deltas on a cadence — see Always-on account agent.

Security & credentials

SecretWhere it lives
Elasticsearch API key ~/.config/dcos/env.sh — seeded by installer, read by MCP at runtime
Salesforce session Salesforce CLI auth store — browser SSO, not pasted into Claude UI
Jina API key env.sh — prompted during install; used by Jina MCP extension
Connector tokens connectors.yaml — optional, per-connector configuration

MCP extensions run locally in Claude's UtilityProcess. CRM and ES calls never route through a DCOS-hosted cloud API.

Build vs buy

DCOS trades platform breadth for sales depth: native Salesforce, MEDDPIC coaching, Elasticsearch you control, and field-first installers. Generic AI platforms optimize for many departments and centralized IT — different job, different architecture.

More questions? See Q&A or the leadership brief in the source repo (docs/LEADERSHIP-BUILD-VS-BUY.md).