Management Portal — Claude Code plugin marketplace
One-click install of the management-portal MCP operator for Claude Code.
It connects the management-portal MCP and ships the agent discipline that makes an agent use it
correctly — in a single install.
Install (Claude Code Desktop — no terminal)
- Create your API key in the web app → Settings → API Keys → Generate, and copy it.
- Add this marketplace — Claude Code Plugins panel → Add marketplace, or run:
/plugin marketplace add WaelFouda/management-portal-plugin
- Install — find management-portal in the marketplace and click Install, or run:
/plugin install management-portal@portal
- Paste your API key when Claude Code prompts you (
pfk_live_…). It's stored in your OS keychain — never written to disk or committed.
- Reload (
/reload-plugins) or restart Claude Code → /mcp confirms it's connected, /portal is ready.
Headless / CLI (no /plugin UI): the key prompt only fires in the Desktop/UI flow. For terminal-only
or CI installs, use the standalone server —
claude mcp add --transport http management-portal https://client-management-api-1uk1.onrender.com/mcp --header "X-API-Key: <YOUR_KEY>" — or the file-copy bundles under agent-onboarding/bundles/.
⚠️ Restart after installing. The skill, the portal-operator subagent, the /portal command, and
the hooks register only at session start. Start a fresh Claude Code session (or /reload-plugins and
reconnect MCP), then run /mcp to confirm the management-portal server is connected.
What you get
| Component | What it does |
|---|
management-portal MCP server | The remote MCP (clients, projects, briefs, proposals, tasks, flow board, boards, notes, calendar, gigs, time, team chat). |
management-portal skill | Auto-triggers on any portal work and loads the operating discipline. |
portal-operator subagent | Runs the portal under the discipline (portal tools only). |
/portal command | Dispatches the portal-operator subagent for a disciplined run. |
| read-after-write hooks | Reinforce "verify every write by reading it back" on each portal write. |
Use
Just start working on the portal — the skill loads automatically. For a dedicated, disciplined run use
/management-portal:portal <what to do>, which engages the portal-operator subagent bound to the
core loop, the three gates, bottom-up completion, never-fabricate-ids, and board-first alignment.
Other platforms (file-copy bundles)
VS Code Copilot, Cursor, and Roo Code don't have a one-click marketplace like Claude Code — they install
by copying a small bundle. Grab the bundle for your platform from this repo:
Each bundle's README has one-screen install steps. The shared core they condense from is in
agent-onboarding/shared/; the canonical spec is
agent-onboarding/DISCIPLINE.md.
For agents: when there's no one-click path (e.g. Roo), fetch the platform's bundle folder above,
copy its files into the user's project root, replace <YOUR_MCP_API_KEY> in the MCP config, and follow
the bundle README. Everything here is public and contains only placeholders — no secrets.
This repo is the public distribution channel for the plugin. The canonical source is maintained
privately and mirrored here; the plugin contains no secrets (your API key is supplied at install).
