Portal first. MCP second.

Pax8. tenant. consent. install. run.

Open portal Back to docs

Flow

Pax8
Connect Pax8 in /portal so the product can load company choices.

Tenant
Select one default Pax8 company for the portal, then place the tenant order.

Consent
Grant Microsoft admin consent for the approved root domain.

Install
Add the endpoint in Claude Code or Codex.

Run
Use provision_preview, then provision_execute, then follow status and logs.

Install

Install only after the portal shows tenant and consent readiness for at least one root domain. Keep the original bearer token from Mailionaire for this step.

Claude Code

read -rsp "Mailionaire MCP token: " MAILIONAIRE_MCP_TOKEN; echo
claude mcp add --transport http mailionaire https://api.mailionaire.ch/mcp --header "Authorization: Bearer ${MAILIONAIRE_MCP_TOKEN}"
unset MAILIONAIRE_MCP_TOKEN

Codex

read -rsp "Mailionaire MCP token: " MAILIONAIRE_MCP_TOKEN; echo
export MAILIONAIRE_MCP_TOKEN
codex mcp add mailionaire --url https://api.mailionaire.ch/mcp --bearer-token-env-var MAILIONAIRE_MCP_TOKEN

Run

Execution still happens in the MCP client. Preview is the first MCP call after portal readiness.

Preview

{
  "approved_root_domain": "mailionaire-demo.ch",
  "domains": ["mailionaire-demo.ch"],
  "project_alias": "mailionaire",
  "requested_by": "pilot-check"
}

Execute

{
  "preview_id": "preview_1234567890abcdef",
  "idempotency_key": "pilot-order-001"
}

State

job_status

Events

job_logs

Scope

workspace_audit

Recovery

job_release_recovery