Connect Claude Code
Install the Piyaz plugin in Claude Code over a hosted MCP server with OAuth.
Connect Claude Code
Piyaz is hosted at app.piyaz.ai. The plugin installs into Claude Code once, at the user level, and works in every project you open. No clone required. Run the one-time install, then sign in when prompted (OAuth, once per machine).
Claude Code gets the full Piyaz feature set: the 6 MCP tools, the /piyaz skill, the whole workflow skill set, and the dispatchable agents.
Add the marketplace and install
claude plugin marketplace add FrkAk/piyaz
claude plugin install piyaz@piyazAuthenticate
In Claude Code, run /mcp, select piyaz, and complete the browser sign-in. Claude Code connects to the hosted MCP server over HTTP and runs OAuth on first use. Authentication is once per machine.
Verify
Ask Claude Code:
/piyaz List my projects.Claude returns your project list. An empty list is expected on a fresh account.
Self-host
To run Piyaz on your own infrastructure, start the server locally and select the piyaz-local server, which points at http://localhost:3000/api/mcp. Advanced self-hosters on a custom domain can set PIYAZ_URL to repoint the default piyaz server. For running the server itself, see the self-host guide.
Contributors can install from a local checkout instead of the published marketplace: claude plugin marketplace add ./plugins/claude-code.
What gets installed
| Component | What it does |
|---|---|
| 6 MCP tools | piyaz_project, piyaz_task, piyaz_edge, piyaz_query, piyaz_context, piyaz_analyze |
/piyaz skill | Auto-invokes when the conversation matches project planning; routes to inline workflows or hands off to a deep-mode workflow |
| Workflow skills | brainstorm, decompose, decompose-feature, decompose-task, manage, onboarding, and composer for end-to-end task orchestration |
| Dispatchable agents | Most workflows also run as agents via the Task tool (brainstorm, decompose, decompose-feature, decompose-task, manage, onboarding, the composer phase agents, and review), so the main skill can hand off work in a clean per-agent context |
Claude Code is the only platform that ships composer (end-to-end task orchestration), because composer depends on a subagent dispatch primitive the other platforms do not yet have. See Agentic workflows for how the skills and agents work together.
Pro plan: composer runs inside a Claude Code Dynamic workflow, which is off by default on Pro. Before you run /piyaz:composer, turn it on from the Dynamic workflows row in /config (requires Claude Code v2.1.154 or later). On Max, Team, Enterprise, and Anthropic API or cloud-provider access it is already on.
Keep the plugin updated
Turn on auto-update so Claude Code pulls new Piyaz releases for you.
Open the plugin manager
Run /plugin in Claude Code, then move to the Marketplaces tab.
Enable auto-update on the piyaz marketplace
Select the piyaz marketplace from the list and choose Enable auto-update.
Auto-update is set per marketplace, not per plugin. The piyaz marketplace ships only the Piyaz plugin, so enabling it there keeps Piyaz current. Claude Code checks for updates at startup; when a new version lands it prompts you to run /reload-plugins to apply it.
For third-party marketplaces like piyaz, auto-update is off by default, so you stay on the installed version until you turn it on.
Next Steps
- MCP Overview -- tool workflows and server architecture.
- Quickstart -- create your first project.