Documentation Index
Fetch the complete documentation index at: https://docs.msportal.ai/llms.txt
Use this file to discover all available pages before exploring further.
Architecture reference: proactive data flow. This map shows the proactive side of MSPortal. It shows how insights from integrations and assessments become Goals, Planner items, Budgets, Meetings and Reports. Reactive and operational data (PSA tickets and projects) flow to reporting through a separate pipeline, shown on the right side of the diagram.
The diagram
Legend
| Marker | Meaning |
|---|---|
| Gray block with plug icon | Integration: external system MSPortal syncs from (PSA, RMM, M365, Backup & Security) |
| White block | MSPortal module: a native feature built on top of the integration data |
| Dashed amber block | External / reactive: PSA-sourced projects and tickets that flow straight to reporting |
| Solid teal arrow | Primary flow: the main path a record takes through the pipeline |
| Gray arrow | Data feed: supporting data that enriches a downstream module |
| Dashed amber arrow | External pipeline: reactive PSA data routed to reports and MSP Tools |
| Dashed teal arrow | Writeback to integration: a record MSPortal creates or updates in the source system (for example, a PSA project created from the Onboarding Portal) |
| Teal circle badge | Item appears in Reports & Dashboards |
| Amber circle badge | Item can be added to a Meeting agenda |
Reading the diagram
The diagram is laid out in stages, left-to-right on integrations and top-to-bottom on flow.Onboarding
Kickoff intake and client setup. The Onboarding Portal writes a project back to your PSA and pulls survey responses in for the first engagement.
Stage 0 · Integrations
M365, RMM, Backup & Security, and PSA connect once and continuously feed the rest of the pipeline. The PSA block spans both the proactive side (Tool Stack reconciliation) and the reactive side (Projects and Tickets).
Stage 1 · Collect
Five input sources land data in MSPortal: Surveys, Microsoft 365, Backup & Security, Devices, and Tool Stack. Each is its own module with its own views and filters.
Stage 2 · Refine
Goals capture what the client wants to achieve. Compliance scores controls against frameworks. Both feed the Planner.
Stage 3 · Plan
The Planner is the center of the system. Every item carries title, status, priority, start/due dates, estimated hours and cost, linked devices, linked source, assignee, and company.
Stage 4 · Budget
Budgets roll labor up from planner hours and roll projects and products up from planner cost estimates and PSA items. A Forecast widget projects the budget forward.
Stage 5 · Present
Meetings are the live client-facing output. Reports & Dashboards is the single reporting surface. Three formats: block-based reports, dashboards, and narrative reports.
Reactive rail
On the right, Projects and Tickets flow from PSA directly into Reports & Dashboards without passing through Planner. Ticket Trends and Financial Reporting roll up into Client Health for a portfolio view.
What the Planner is actually for
The Planner is the MSP’s pre-sales roadmap for each client. It’s where the vCIO or Account Manager lays out the next several years of IT work in plain, estimated form, so the client can look at it and say “yes, that’s what I expected” before anyone writes a formal quote. Items on the planner are estimates, not quotes. They carry rough hours, rough costs, and a rough timeline. The point is to drive a conversation, get verbal approval in a QBR, and then spin up the real quoting process inside the PSA only once the client has blessed the direction.Pre-sales roadmapping
Every goal, compliance finding, tool-stack recommendation, and device end-of-life surfaces as a planner item the AM can walk a client through. The planner is the single place the client sees “here’s what your next few quarters, and next few years, of IT look like.”
Estimates, not quotes
Hours and dollar figures on planner items are directional. They feed Budgets and the forecast so the client can see spend shape. The formal quote only gets created in the PSA after the client approves the plan verbally.
Years in advance
Add items well ahead of time: a firewall refresh in 2028, the annual cyber-insurance renewal, the Windows Server upgrade that follows an M365 migration. The planner is where the MSP remembers the work the client hasn’t asked about yet.
vCIO / Account Manager owned
The planner is operated by the person who owns the client relationship, typically the vCIO or Account Manager. Technicians don’t live here; they live in the PSA. The planner is the account strategy layer above the PSA.
What a planner item looks like
Every item, regardless of origin, carries the same core attributes:| Attribute | What it holds |
|---|---|
| Title & status | Name, status, priority |
| Dates & hours | Start, due, estimated hours |
| Cost estimate | Directional dollar figure used by Budgets |
| Linked devices | Which machines the work affects |
| Linked source | The goal, compliance control, tool, or survey that originated the item, so you can always trace “why is this on the roadmap?” |
| Assignee & company | Who owns it, which client |
- Firewall replacement (estimated hardware cost, 3 hours install, scheduled for Q3 next year)
- Annual cyber-insurance renewal (reminder + renewal cost, recurring)
- Microsoft 365 license review (2 hours, tied to the contract renewal)
- Server refresh (estimated CAPEX, scheduled 2 years out against the hardware’s EOL date)
- Compliance remediation for a failed CIS control (tied to the compliance finding)
- Standard onboarding steps for a newly acquired location
The unified reporting surface
Reports & Dashboards is one surface that pulls from the full proactive pipeline and from reactive PSA data. It offers three formats:Block-based reports
Widget grid. Build once as a template, reuse across clients.
Dashboards
Live metrics, real-time views. Drop them into the meeting or the client portal.
Narrative reports
Long-form QBRs and executive summaries. Claude generates the narrative from the same data.
Writebacks: MSPortal updates the source system
A handful of flows write back to the integration they came from. These appear as dashed teal arrows in the diagram.- Onboarding Portal → PSA. When a client completes the kickoff intake, MSPortal creates a project in your PSA so the onboarding work lives where your team already operates.
- Devices → PSA. Warranty dates, end-of-life status, and other device fields sync back to PSA assets so your techs see the same numbers on a ticket as your AM sees in Budgets.
The reactive rail
The right-hand side of the diagram is a separate pipeline. PSA-sourced Projects and Tickets do not pass through Planner. They land directly in Reports & Dashboards alongside the proactive data, so the client sees one unified report whether the work was planned or reactive.MSP Tools: your internal, cross-client view
Everything in the MSP Tools column of the diagram is for your staff, not your clients. The proactive pipeline and the reactive rail both feed it. While Meetings and Reports & Dashboards are how you show a single client how they’re doing, MSP Tools is how you look across every client at once and run your MSP.Ticket Trends
Weekly, per-company, and per-category ticket analytics rolled up from PSA. Use it to spot the client whose ticket volume is climbing week-over-week, or the category (password resets, printer issues) that’s eating your help desk.
Financial Reporting
Revenue efficiency, seat pricing, and support cost per client. Pulls PSA invoices and contracts on one side and planner/budget data on the other. Tells you which contracts are margin-healthy and which need repricing.
Client Health
A portfolio view across every client in your book. Combines trend signals (ticket volume, compliance posture, Secure Score drift) with financial signals (margin, utilization) and scores each client. The place the owner or COO starts every Monday.
Tool Stack
Your MSP’s reference catalog of standard products: the “every-client essentials” you want in place at each account (EDR, MFA, backup, patching, DNS filtering). Used during planning to see where a client’s actual stack differs from your baseline.
Who uses MSP Tools? Typically the owner, COO, service manager, and vCIO lead. They’re macro views, not something you’d share in a client meeting. Client-facing views live in Meetings and Reports & Dashboards.
The typical client journey
The same pipeline runs quarter after quarter.1. Kickoff
Onboarding survey. Connect M365. Import devices from the RMM. First compliance assessment.
2. Analyze
Turn survey responses into goals. Review compliance failures and Secure Score recommendations.
3. Plan
Create planner items from goals, compliance findings, and tool recommendations. Attach devices. Set costs and hours.
4. Budget
Roll planner costs into line items. Forecast forward. Share with the client for approval.
5. Present
Build a QBR agenda with goals, planner, compliance, and budgets. Present live, then send a report.
6. Repeat
Follow-up survey. Planner items close out. New goals open. Next quarter starts.
Related guides
- Onboarding Wizard: connect integrations and get your tenant configured
- Surveys
- Goals
- Planner
- Budgets
- Compliance
- Microsoft 365
- Standards
- Devices
- Meetings
- Presenting Meetings
- Reporting