Is Wp Criu Registry safe to install?

SaferSkills independently audited Wp Criu Registry (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.

CategoryWeightCategory scoreContribution

Securityprompt, exec, net, exfil, eval

35%

100

35.0 pts

Supply chainhash, typosquat, maintainer, lockfile

20%

100

20.0 pts

Maintenancestaleness, pinning, CI

15%

100

15.0 pts

TransparencySKILL.md, perms, README

15%

100

15.0 pts

Communityinstalls, verify, response

15%

100

15.0 pts

Findings & checks · 0 flagged

Securityscore 100 · 0 findings

✓—All security checks passedNo findings in this category for the latest scan.pass

Supply chainscore 100 · 0 findings

✓—All supply chain checks passedNo findings in this category for the latest scan.pass

Maintenancescore 100 · 0 findings

✓—All maintenance checks passedNo findings in this category for the latest scan.pass

Transparencyscore 100 · 0 findings

✓—All transparency checks passedNo findings in this category for the latest scan.pass

Communityscore 100 · 0 findings

✓—All community checks passedNo findings in this category for the latest scan.pass

The primary manifest — the file an agent reads to learn what this artifact does.

README.md · 1 file

README.md7.5 KB · Markdown

MCP Hub propio para Codex y ChatGPT

Este servicio consolida dos cosas en una sola capa:

MCP remoto por Streamable HTTP para Codex y ChatGPT.
Panel técnico y registry compatible para onboarding de conectores y sitios WordPress.

Qué incluye ahora

Hub MCP con herramientas de Notion, WordPress y cPanel/WHM.
State store persistido en JSON para onboarding editable.
Panel técnico en /admin, con pestañas separadas para WordPress Bridge y Webmaster IA. El plugin comercial registra cada sitio automáticamente y las invitaciones se crean desde la pestaña Webmaster IA.
Admin API en /api/admin/*.
Registry WordPress compatible:
GET /sites
GET /sites/:site_id
POST /register-site
PATCH /sites/:site_id
DELETE /sites/:site_id
Registro administrativo de cuentas cPanel/WHM y validación de tokens.

Arquitectura

src/index.ts: entrypoint HTTP, /mcp, /health, /admin y rutas de registry.
src/mcp-server.ts: herramientas MCP de Notion y WordPress.
src/lib/state.ts: estado persistido del hub.
src/notion.ts: adaptador Notion por alias.
src/wordpress.ts: adaptador WordPress compatible con el bridge actual.
src/cpanel.ts: adaptador HTTPS para UAPI de cPanel y API 1 de WHM.
src/admin/*: UI y API técnica de onboarding.

Variables de entorno

Obligatorias en producción:

ADMIN_API_KEY
ADMIN_SESSION_SECRET
WORDPRESS_REGISTRY_TOKEN
CRIU_COMMERCIAL_TELEGRAM_TOKEN, CRIU_COMMERCIAL_WEBHOOK_SECRET y CRIU_COMMERCIAL_OPENAI_KEY para el conector comercial; nunca se incluyen en el plugin ni en el repositorio.

Recomendadas:

MCP_AUTH_MODE=bearer
MCP_API_KEY
MCP_ALLOWED_HOSTS=mcp.tudominio.com,localhost,127.0.0.1
HUB_STATE_FILE=/app/data/hub-state.json

Bootstrap opcional:

NOTION_CONNECTIONS_JSON
WORDPRESS_BOOTSTRAP_SITES_FILE
Las credenciales cPanel/WHM se registran desde el panel y se persisten en el volumen privado de HUB_STATE_FILE.
NOTION_OAUTH_CLIENT_ID
NOTION_OAUTH_CLIENT_SECRET
NOTION_OAUTH_REDIRECT_URI

Rutas principales

GET /
GET /health
GET /admin
POST /mcp
GET /sites
POST /register-site

cPanel y WHM

El conector admite dos modalidades:

cpanel_token, con un token creado dentro de cada cuenta cPanel, normalmente en el puerto 2083.
whm_token, con un token reseller/root creado en WHM, normalmente en el puerto 2087.

La administración se hace desde estas rutas protegidas por sesión de administrador:

GET /api/admin/connectors/cpanel/accounts
POST /api/admin/connectors/cpanel/accounts
PATCH /api/admin/connectors/cpanel/accounts/:accountId
DELETE /api/admin/connectors/cpanel/accounts/:accountId
POST /api/admin/connectors/cpanel/accounts/:accountId/validate

Las herramientas MCP expuestas son cpanel_list_accounts, cpanel_check_account, cpanel_list_mailboxes, cpanel_create_mailbox, cpanel_delete_mailbox y whm_list_accounts.

Por seguridad, los listados nunca devuelven el token. Se recomienda crear tokens con permisos mínimos, expiración y sin acceso global cuando el proveedor lo permita. No se deben registrar contraseñas de cPanel ni tokens WHM en el chat.

La integración usa UAPI para operaciones cPanel y API 1 para WHM. Referencias: UAPI de cPanel, tokens de WHM, Email/list_pops.

Panel técnico

El panel permite:

iniciar autorizaciones de Notion por OAuth;
almacenar y editar conexiones Notion ya autorizadas;
validarlas con whoami;
registrar sitios WordPress a mano;
ver estado de bridge;
ocultar o desactivar sitios sin borrarlos lógicamente del modelo;
eliminar sitios del registry;
ver el catálogo técnico para futuros conectores.

Compatibilidad WordPress

La idea es no romper el stack actual:

el plugin WordPress puede seguir enviando auto-registro a POST /register-site;
el modelo por site_id, site_label y base_url se mantiene;
las herramientas MCP WordPress conservan los mismos nombres usados antes.

Uso local

npm install
copy .env.example .env
npm run dev

Pruebas rápidas:

curl http://localhost:3000/health
npm run smoke:http

Abre:

http://localhost:3000/admin

Despliegue en EasyPanel

Crea el servicio desde este directorio.
Persiste ./data o define un volumen para HUB_STATE_FILE.
Configura MCP_AUTH_MODE=bearer y un MCP_API_KEY privado.
Configura MCP_ALLOWED_HOSTS con tu dominio publico y localhost.
Configura ADMIN_API_KEY, ADMIN_SESSION_SECRET y WORDPRESS_REGISTRY_TOKEN.
Si vas a conectar Notion desde el panel, configura NOTION_OAUTH_CLIENT_ID, NOTION_OAUTH_CLIENT_SECRET y NOTION_OAUTH_REDIRECT_URI=https://tu-dominio/api/admin/connectors/notion/oauth/callback.
Si vienes del wp_criu_registry actual, monta el mismo volumen y deja WORDPRESS_BOOTSTRAP_SITES_FILE=/app/data/sites.json.
Publica el servicio por HTTPS.
Usa /mcp para MCP y /admin para onboarding humano.

Onboarding de Notion

Crea una integración pública de Notion y define como redirect URI:

https://tu-dominio/api/admin/connectors/notion/oauth/callback

Carga NOTION_OAUTH_CLIENT_ID, NOTION_OAUTH_CLIENT_SECRET y NOTION_OAUTH_REDIRECT_URI en EasyPanel.
Entra a /admin.
Escribe alias, label opcional y defaultParentPageId opcional.
Pulsa Conectar con Notion.
Autoriza la integración en Notion.
Vuelve al panel y valida con whoami.

Migración directa desde el registry actual

Si mcp.criu.com.co hoy responde como wp_criu_registry, la migración segura para reemplazarlo con este hub es:

Respaldar el volumen actual de /app/data.
Mantener el archivo legado sites.json en ese mismo volumen.
Desplegar este servicio con:

HUB_STATE_FILE=/app/data/hub-state.json
WORDPRESS_BOOTSTRAP_SITES_FILE=/app/data/sites.json

Arrancar el hub nuevo.
Confirmar en /admin que los sitios heredados aparecieron.

El hub también intenta detectar automáticamente un sites.json vecino al hub-state.json, de modo que un reemplazo directo no dependa de pasos manuales extra.

Codex

Ejemplo con bearer:

[mcp_servers.criu_hub]
url = "https://mcp.tudominio.com/mcp"
bearer_token_env_var = "CRIU_MCP_HUB_TOKEN"

El valor de CRIU_MCP_HUB_TOKEN debe ser el mismo MCP_API_KEY del hub.

ChatGPT

Diseño recomendado:

camino principal: Secure MCP Tunnel
fallback: endpoint HTTPS directo a /mcp

Guía operativa

Hay una guía más aterrizada de uso personal, despliegue y onboarding en docs/OPERACION_PERSONAL.md.

Si este repo ya está desplegado en producción, el estado operativo real y los endpoints live actuales quedaron documentados en docs/ESTADO_LIVE_MCP_CRIU.md.

Scripts útiles

Importar sitios desde el registry vivo actual a data/sites.json:

LEGACY_REGISTRY_TOKEN=tu_token npm run import:legacy-registry

O explícitamente:

node scripts/import-legacy-registry.mjs --url https://mcp.criu.com.co --token tu_token --output ./data/sites.json

Hacer smoke test HTTP/MCP del hub ya levantado:

MCP_HUB_URL=https://mcp.criu.com.co MCP_HUB_TOKEN=tu_token npm run smoke:http

Futuros conectores

Cada integración nueva debería entrar como:

manifest del conector
config schema
health check
admin form
entidades administrables
adaptador MCP

Wp Criu Registry— agent skill

Is Wp Criu Registry safe to install?

MCP Hub propio para Codex y ChatGPT

Qué incluye ahora

Arquitectura

Variables de entorno

Rutas principales

cPanel y WHM

Panel técnico

Compatibilidad WordPress

Uso local

Despliegue en EasyPanel

Onboarding de Notion

Migración directa desde el registry actual

Codex

ChatGPT

Guía operativa

Scripts útiles

Futuros conectores

Audit the pieces. Scan the whole. Decide.