# Portals
URL: https://metorial.com/docs/platform/workforce/portals

Portals are branded places where users discover and connect approved integrations, skills, and MCP access.

---

Portals turn a Workforce setup into a user-facing experience. Create a portal for a customer, partner, department, or internal team, then publish the integrations and skills that group should use.

<PageIntro>
  <Learn>
    * How admins build a portal
    * How users experience a portal
    * How access groups, integrations, skills, highlights, and authentication fit together
  </Learn>
</PageIntro>

## Portal journey [#portal-journey]

Admins create the portal and decide what appears inside it. Users open the portal, authenticate, and connect to the approved resources.

<Mermaid
  chart="flowchart LR
  Admin[&#x22;Admin&#x22;]
  Portal[&#x22;Portal&#x22;]
  Groups[&#x22;Access groups&#x22;]
  Integrations[&#x22;Integrations&#x22;]
  Skills[&#x22;Skills&#x22;]
  User[&#x22;User&#x22;]

  Admin --> Portal
  Admin --> Groups
  Groups --> Integrations
  Groups --> Skills
  Integrations --> Portal
  Skills --> Portal
  Portal --> User"
/>

## Create a portal [#create-a-portal]

Open **Portals** from Workforce and create a portal with a clear name and description. Use the description to explain who the portal is for and what kind of work it supports.

<img alt="Portal admin overview" src="__img0" />

## Add access groups [#add-access-groups]

Access groups decide which users can see each portal resource. Groups can apply to every account by default or match SSO group IDs.

<img alt="Portal access groups" src="__img1" />

After adding a resource, open the resource and explicitly allow the groups that should see it.

## Add integrations [#add-integrations]

Publish integrations so users can connect approved tools. A portal integration can be:

| Listing type    | Meaning                                                            |
| --------------- | ------------------------------------------------------------------ |
| User-configured | Each user connects the integration with their own credentials      |
| Pre-configured  | Administrators manage the shared credentials and provider settings |

<img alt="Portal integration listings" src="__img2" />

## Add skills [#add-skills]

Publish skills so users can run approved workflows. Skills can show linked integrations, which helps users understand what access powers the workflow.

<img alt="Portal skill listings" src="__img3" />

## Highlight starter resources [#highlight-starter-resources]

Highlights organize selected resources on the portal home page. Use them for recommended workflows, starter kits, or department-specific bundles.

<img alt="Portal highlights" src="__img4" />

## Configure authentication [#configure-authentication]

Portal authentication controls who can enter the portal. Configure SSO tenants, email or domain allowlists, and session expiry settings.

<img alt="Portal authentication settings" src="__img5" />

Users authenticate before they see portal resources.

<img alt="Portal employee login" src="__img6" />

## Test the employee experience [#test-the-employee-experience]

Open the portal as a user and check the home page, integrations view, and skills view.

<img alt="Employee portal home" src="__img7" />

<img alt="Employee portal integrations" src="__img8" />

<img alt="Employee portal skills" src="__img9" />

## Magic MCP in portals [#magic-mcp-in-portals]

Portals can expose portal-aware Magic MCP access. Use this when users should connect MCP clients through a branded, authenticated surface rather than a project-internal endpoint.

Use portal-connected Magic MCP when:

* access should be user-specific
* the connection should honor portal authentication
* users need a branded entry point
* resource listings and requests should wrap MCP access

## Related pages [#related-pages]

<Cards columns="2">
  <Card title="Create a portal" icon="door-open" href="/docs/platform/get-started/create-a-portal">
    Follow the first portal setup path.
  </Card>

  <Card title="Magic Skills" icon="wand-sparkles" href="/docs/platform/workforce/magic-skills">
    Publish reusable workflows through portals.
  </Card>

  <Card title="Workforce" icon="users" href="/docs/platform/workforce">
    Understand the broader Workforce access model.
  </Card>

  <Card title="Integrations" icon="plug" href="/docs/platform/integrations">
    Configure the tools users can access.
  </Card>
</Cards>