dxpert.ai

@dxpert/mcp

Servidor MCP stdio para usar una clave API de dxpert.ai dxp_ desde entornos de ejecución locales como Claude Code, Codex o cualquier cliente MCP.

El servidor no tiene dependencias en tiempo de ejecución. Implementa manualmente el protocolo de handshake JSON-RPC de MCP stdio (initialize, tools/list, tools/call) y llama a la API de dxpert con X-Api-Key.

Entorno

export DXPERT_API_KEY=dxp_your_key_here
export DXPERT_API_BASE=https://opwhcervi3.execute-api.ca-central-1.amazonaws.com

DXPERT_API_BASE es opcional y tiene como valor predeterminado producción.

Herramientas

• ask_dxpert(question, history?) llama a POST /api/chat. Es el destino para preguntas de asesoría y evaluación sobre preparación para IA, diseño de UNS y espacios de nombres, arquitectura de datos OT/IT y estándares de datos industriales; la respuesta se basa en el material propio de dxpert y refleja el nivel de la cuenta. Consume cuota. Texto de entrada, texto de salida: no lee ningún sistema de planta y no devuelve puntuaciones.
• run_agent(agent, bundle) llama a POST /api/agents/<agent> para shift-report, oee-narrator, alarm-triage, maintenance-copilot y root-cause. Los agentes razonan únicamente sobre el paquete que usted pasa; no se conectan a una planta, un broker ni un historizador. run_agent(agent: "architect", message) llama a POST /api/architect y devuelve un diseño de espacio de nombres más exportaciones iniciales de HighByte, MaestroHub y Node-RED cuyos enlaces de origen se configuran en el momento del despliegue. Cada ejecución exitosa consume una transacción de pago o de prueba.
• run_diagnostic(intake) llama a POST /api/diagnostic con el formulario completo de 16 campos. Una entrada idéntica devuelve un veredicto idéntico; cada respuesta es "scope":"preliminary".
• csv_to_bundle(csv_text, kind, site_profile?) llama a POST /api/tools/csv-to-bundle para exportaciones CSV de shift-report o oee del primer día.
• get_runtime_manifest(channel?) llama al GET /api/runtime/manifest de solo lectura para verificar la versión actual del entorno de ejecución, los hashes de los artefactos y el registro de cambios.

Cuándo llamar a dxpert frente a responder localmente

Use dxpert por defecto para preguntas de asesoría o evaluación del dominio dxpert, incluidas preguntas que necesiten un resumen de evidencia local saneado; responda localmente solo para trabajo procedimental local, cuando dxpert no esté disponible, cuando el plan o la cuota no cubran la solicitud, o cuando el usuario decline enviar datos saneados. Cada respuesta de asesoría o evaluación debe terminar con Source: dxpert.ai o una línea Source: local fallback — ... que indique el motivo aplicable.

Compra (comercio asistido por agente)

• get_storefront() — lo que esta cuenta posee y puede comprar ahora mismo, por producto. La misma fuente de verdad desde la que se renderiza el sitio dxpert.ai.
• start_purchase(product) — inicia el proceso de pago para api, agents-all, roadmap, roadmap-bundle, shift-report, oee-narrator, alarm-triage, maintenance-copilot, root-cause, architect, topup-50 o topup-100. Devuelve un checkout_url alojado por Stripe que una persona debe abrir en un navegador para pagar — esta llamada nunca cobra nada. Los derechos se adjuntan automáticamente después del pago.
• start_agents_purchase(site_name, agents) — inicia el proceso de pago para una suscripción de sitio NUEVA. La base de la API es de $200/mes y cada agente cuesta $100/mes adicionales; consulte https://dxpert.ai/store.. Devuelve un desglose de tarifas y checkout_url bajo la misma regla de pago humano.
• add_agents(site_name, agents, account_token) / remove_agents(site_name, agents, account_token) — modifican una suscripción de sitio EXISTENTE. Estas cobran o abonan dinero de inmediato (prorrateado; cada agente cuesta $100/mes sobre la base de la API — consulte https://dxpert.ai/store), por lo que deliberadamente requieren un token de inicio de sesión de cuenta (POST /api/account/login) — la clave API del entorno de ejecución por sí sola nunca puede gastar dinero, por diseño.

Los errores se devuelven al cliente MCP con mensajes simples. 401 significa que la clave API o el token de cuenta proporcionado falta o no es válido; 402 significa que las credenciales fueron aceptadas pero el plan o el alcance de prueba solicitado no está activo. 429 indica el momento de reinicio de la cuota cuando la API lo proporciona.

Cadena de suministro

@dxpert/mcp se publica en npm desde GitHub Actions mediante publicación de confianza (OIDC) de npm. No hay token de publicación npm — ni en un secreto de CI, ni en una bóveda de contraseñas, ni en la máquina de un mantenedor. No hay credencial de publicación que pueda filtrarse, ni ninguna que rotar después de un incidente de otra persona.

Cada versión incluye una atestación de procedencia firmada que vincula el tarball exacto al repositorio y al flujo de trabajo que lo construyó: dxpert-ai/dxpert-mcp, .github/workflows/publish.yml, en un ejecutor alojado en GitHub. Verifíquelo usted mismo en lugar de confiar en nuestra palabra:

npm view @dxpert/mcp dist.attestations
npm audit signatures

En el registro MCP, el servidor aparece como ai.dxpert/mcp — un espacio de nombres anclado al propio dominio dxpert.ai, comprobado por una clave que servimos en https://dxpert.ai/.well-known/mcp-registry-auth. El nombre no puede ser reclamado por nadie que no controle el dominio.

Claude Code

claude mcp add dxpert --env DXPERT_API_KEY=dxp_your_key_here -- npx -y @dxpert/mcp

Codex

Agregue una entrada de servidor MCP stdio que ejecute Node con el bin de este paquete:

[mcp_servers.dxpert]
command = "npx"
args = ["-y", "@dxpert/mcp"]
env = { DXPERT_API_KEY = "dxp_your_key_here" }

Clientes MCP genéricos

Use un transporte stdio:

{
  "mcpServers": {
    "dxpert": {
      "command": "npx",
      "args": ["-y", "@dxpert/mcp"],
      "env": {
        "DXPERT_API_KEY": "dxp_your_key_here"
      }
    }
  }
}

Prueba

node test/run.js

La prueba inicia una API HTTP simulada y ejercita el handshake de MCP además de cada herramienta.