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
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 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 | Each workflow is also available as an agent via the Task tool, 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.
Next Steps
- MCP Overview -- tool workflows and server architecture.
- Quickstart -- create your first project.