> ## Documentation Index
> Fetch the complete documentation index at: https://metorial.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Workforce

> Workforce is the control plane for connecting AI agents and applications to user-authorized integrations, skills, portals, and MCP URLs.

Workforce is where admins turn user-authorized tool access into something AI agents and applications can use. It brings together portals, integrations, skills, Magic MCP, accounts, agents, and activity so access control and tracing live in one place instead of scattered across credentials and one-off setup.

<Note>
  **What you'll learn:**

  * What Workforce manages for admins, users, AI clients, MCP clients, CLIs, and agents
  * How portals, integrations, skills, accounts, agents, and Magic MCP fit together
  * Which dashboard areas support the main Workforce workflow
</Note>

## What Workforce Is For

Use Workforce when you need to answer practical access questions:

* Which users or agents can use approved integrations?
* Which integrations and skills should users see?
* Which portal should a customer, partner, or internal team open?
* Which MCP clients and CLIs can connect through approved access?
* Which traces, sessions, tool calls, and auth events happened?

<img src="https://mintcdn.com/metorial/Avvcg5xA3rtWIxf9/images/dashboard-audit/workforce-dashboard.png?fit=max&auto=format&n=Avvcg5xA3rtWIxf9&q=85&s=5dda43960360b8692109469091a28988" alt="Workforce dashboard" width="1800" height="986" data-path="images/dashboard-audit/workforce-dashboard.png" />

## What You Can Manage

| Area         | What it does                                                  |
| ------------ | ------------------------------------------------------------- |
| Portals      | Publish branded catalogs of approved integrations and skills  |
| Skills       | Create and govern reusable workflows                          |
| Integrations | Configure approved access to tools such as GitHub and Linear  |
| Magic MCP    | Expose approved provider access through managed MCP endpoints |
| Accounts     | Manage employees or users that receive portal access          |
| Agents       | Manage non-human actors and linked clients                    |
| Activity     | Review traces, sessions, connections, tool calls, and errors  |

## Core Workflow

Most teams start with this path:

<Steps>
  <Step title="Open Workforce">
    Start from the Workforce dashboard for the project you want to configure.
  </Step>

  <Step title="Launch a portal">
    Create the branded place where users will discover approved integrations and skills.
  </Step>

  <Step title="Add integrations and skills">
    Publish the tools and workflows users need. Start with a small set, then expand as usage becomes clear.
  </Step>

  <Step title="Test as a user">
    Open the user portal and confirm the right integrations, skills, and MCP URL are visible.
  </Step>

  <Step title="Review activity">
    Inspect traces, sessions, connections, tool calls, auth events, and alerts.
  </Step>
</Steps>

## Dashboard Surfaces

The Workforce product spans these dashboard areas:

| Area         | Route                                                                             | What it manages                                                 |
| ------------ | --------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| Workforce    | `/workforce`                                                                      | Activity, portals, accounts, and access overview                |
| Portals      | `/portals`                                                                        | Branded resource catalogs for employees, partners, or customers |
| Magic Skills | `/skills`                                                                         | Skills, marketplaces, templates, groups, and skill policy       |
| Magic MCP    | `/magic-mcp`                                                                      | MCP servers, connections, groups, and tokens                    |
| Accounts     | `/consumers`                                                                      | Employees or users that can receive access                      |
| Agents       | `/agents`                                                                         | First-class agent actors and linked clients                     |
| Identity     | `/identities`, `/actors`, `/identity/delegations`, `/identity/delegation-configs` | Identities, actors, delegations, and delegation configs         |

<img src="https://mintcdn.com/metorial/Avvcg5xA3rtWIxf9/images/dashboard-audit/dashboard-accounts.png?fit=max&auto=format&n=Avvcg5xA3rtWIxf9&q=85&s=61e8e84e83cb1d251e0729acd9026dae" alt="Accounts page" width="1800" height="986" data-path="images/dashboard-audit/dashboard-accounts.png" />

<img src="https://mintcdn.com/metorial/Avvcg5xA3rtWIxf9/images/dashboard-audit/dashboard-agents.png?fit=max&auto=format&n=Avvcg5xA3rtWIxf9&q=85&s=87dce42ed580df6322b9637145e5d5b0" alt="Agents page" width="1800" height="986" data-path="images/dashboard-audit/dashboard-agents.png" />

## How The Pieces Fit

Portals are the user connection layer. Integrations provide approved tool connections. Skills package repeatable workflows. Magic MCP gives AI clients, agents, MCP clients, and CLIs a standard MCP endpoint for approved access. Accounts and agents represent who or what can use access. Activity and logs trace usage, tool calls, and access events.

```mermaid theme={null}
flowchart TD
  Portal["Portal"]
  Account["Account"]
  Agent["Agent"]
  Integration["Integration"]
  MagicMCP["Magic MCP Server"]
  Skill["Magic Skill"]
  Activity["Activity And Logs"]

  Portal --> Account
  Portal --> Integration
  Portal --> Skill
  Account --> MagicMCP
  Agent --> MagicMCP
  Integration --> MagicMCP
  Skill --> Integration
  MagicMCP --> Activity
  Skill --> Activity
```

## Identity And Delegation

Workforce also includes lower-level identity and delegation pages. Use them when you need durable ownership for employees, agents, customer-facing users, or delegated access relationships.

| Page               | What it manages                                    |
| ------------------ | -------------------------------------------------- |
| Accounts           | Employees or users that can receive access         |
| Agents             | Non-human actors and linked clients                |
| Identities         | Identity records used for ownership and delegation |
| Delegations        | Access relationships between identities            |
| Delegation Configs | Reusable policies for identity delegation          |

<img src="https://mintcdn.com/metorial/Avvcg5xA3rtWIxf9/images/dashboard-audit/dashboard-identities.png?fit=max&auto=format&n=Avvcg5xA3rtWIxf9&q=85&s=f3539ef496217a1bcf545be020c5e8aa" alt="Identities page" width="1800" height="986" data-path="images/dashboard-audit/dashboard-identities.png" />

## Related Pages

<CardGroup cols={2}>
  <Card title="Portals" icon="door-open" href="/product-portals">
    Publish approved integrations and skills through a branded user surface.
  </Card>

  <Card title="Magic Skills" icon="wand-sparkles" href="/product-magic-skills">
    Create reusable workflows and publish them to teams or customers.
  </Card>

  <Card title="Integrations" icon="plug" href="/integrations-overview">
    Connect the tools your users authorize.
  </Card>

  <Card title="Review Activity" icon="chart-line" href="/review-activity">
    Monitor access usage and operational events.
  </Card>
</CardGroup>