Korfix DevKit
korfixdev/devkit
Agentes IA para desenvolvimento completo de miniapps no Korfix
Ver no GitHubMCP server e plugin para Claude Code que oferece agentes e skills para desenvolver miniapps end-to-end na plataforma ERP Korfix. Automatiza scaffolding, validação contra checklist de release, packaging e deploy direto do editor.
Instalação
npx convez-ai korfixdev/devkit1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Desenvolver miniapps completos no ERP Korfix com IA
- Automatizar validação e deploy de aplicações marketplace
- Gerar documentação técnica auto-mantida para miniapps
Veredito

Toolkit bem estruturado para ecossistema Korfix, com agentes especializados (analyst, architect, dev, gamedev, validator) e integração MCP nativa. Reduz fricção no ciclo de desenvolvimento de miniapps, mas requer familiaridade prévia com a plataforma e suas APIs.
README
A tradução para o português deste README ainda está na fila.
korfix-devkit
Claude Code plugin for developing marketplace miniapps on the Korfix ERP platform.
Provides AI agents, skills, and optional MCP connection. After installation, Claude Code can develop miniapps end-to-end: scaffold, write code, validate against the release checklist, package, and deploy.
Platform: korfix.info · Docs: docs.korfix.info · Related plugin: korfixdev/assistant
Install
The plugin is distributed via the Korfix Marketplace.
Step 1 — Add Korfix marketplace (once, before installing any plugin)
In Claude Code, type /plugin → Add marketplace → paste:
korfixdev/marketplace
Step 2 — Install korfix-devkit
/plugin install korfix-devkit@korfixdev
Step 3 — Activate in current session
/reload-plugins
Or just restart Claude Code — plugins load automatically on the next start.
Manual install (any version, fallback):
git clone https://github.com/korfixdev/devkit ~/.claude/plugins/korfix-devkit
Then enable in Claude Code settings → reload.
Setup
export KORFIX_API_URL="https://vibe.korfix.app" # your Korfix instance
export KORFIX_TOKEN="your-token-from-db-api" # required
Get a token in your Korfix panel → /db/api → Add.
Optional: MCP mode — agents work via curl by default. To enable MCP, get your personal MCP URL from your Korfix panel (available after login), then add it to .mcp.json:
{
"mcpServers": {
"korfix": {
"type": "sse",
"url": "YOUR_MCP_URL_FROM_KORFIX_PANEL"
}
}
}
When MCP is connected, agents automatically use catalog_schema / db_read / db_insert / db_update tools instead of curl.
What's inside
| Component | Role |
|---|---|
Agent korfix-analyst | Clarifies requirements, designs the solution, writes SPEC.md, hands off to the dev agent |
Agent korfix-architect | Technical feasibility: which catalogs, entry points, custom catalogs (consulted by the analyst) |
Agent korfix-miniapp-dev | Writes miniapps: architecture, code, styling, packaging, deploy |
Agent korfix-gamedev | Specialized variant for game/gamification miniapps (korgames module) |
Agent korfix-miniapp-validator | Impartial review before deploy (fresh context, checklist-driven) |
Agent korfix-tech-writer (haiku) | Maintains README.md in the miniapp directory — auto-called after edits and before deploy |
| 11 skills | korfix-miniapp-validate, -checklist, -config, korfix-pre-deploy, korfix-test-guide, korfix-js-api, korfix-self-provisioning, korfix-catalog-schema, korfix-crud-data, korfix-token-audit, korfix-gamedev |
| Local gate | scripts/validate-bundle.js + schemas/config.schema.json + a PreToolUse hook — structural pre-flight before zipping (no API) |
| Bundled docs | docs/miniapps/ + docs/gamedev/ — synced from korfixdev/docs (English) via sync-docs.sh |
Usage
Create a miniapp that shows record count under each catalog's table
Routing (for a brand-new app):
korfix-analystclarifies requirements, consultskorfix-architect, and writes aSPEC.md, then hands off to developmentkorfix-miniapp-dev(orkorfix-gamedevfor games) confirms instance + token, reads the bundled docs, writes code- Local structural gate (
scripts/validate-bundle.js) runs before packaging korfix-miniapp-validatordoes an impartial checklist review in a fresh context- On
READY— deploy via API (POST /api/db/marketplace/{ID}); onNOT READY— fix and re-validate
For a small change to an existing app you can address korfix-miniapp-dev directly. The agent never
deploys without your confirmed instance and token. (Full routing rules: CLAUDE.md.)
Security
- Keep the token in env, not in files.
KORFIX_TOKENnever goes into miniapp commits. - Grant the token minimum privileges — only needed catalogs and methods.
- Use separate tokens for prod and staging.
License
MIT — see LICENSE.