convez.ai
MCP ServerDesenvolvimento WebIntermediário
korfixdev

Korfix DevKit

korfixdev/devkit

Agentes IA para desenvolvimento completo de miniapps no Korfix

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP 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/devkit

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
62%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
2

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

ComponentRole
Agent korfix-analystClarifies requirements, designs the solution, writes SPEC.md, hands off to the dev agent
Agent korfix-architectTechnical feasibility: which catalogs, entry points, custom catalogs (consulted by the analyst)
Agent korfix-miniapp-devWrites miniapps: architecture, code, styling, packaging, deploy
Agent korfix-gamedevSpecialized variant for game/gamification miniapps (korgames module)
Agent korfix-miniapp-validatorImpartial 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 skillskorfix-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 gatescripts/validate-bundle.js + schemas/config.schema.json + a PreToolUse hook — structural pre-flight before zipping (no API)
Bundled docsdocs/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):

  1. korfix-analyst clarifies requirements, consults korfix-architect, and writes a SPEC.md, then hands off to development
  2. korfix-miniapp-dev (or korfix-gamedev for games) confirms instance + token, reads the bundled docs, writes code
  3. Local structural gate (scripts/validate-bundle.js) runs before packaging
  4. korfix-miniapp-validator does an impartial checklist review in a fresh context
  5. On READY — deploy via API (POST /api/db/marketplace/{ID}); on NOT 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_TOKEN never 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.

Contact

info@korfix.info

Ver o original no GitHub

Bom para

Relacionados