ejentum-mcp

Arneses cognitivos para IA agente, expuestos como herramientas MCP. Una instalación, cuatro herramientas que tu agente puede invocar para recuperar andamiajes de razonamiento estructurado que detectan modos de fallo comunes de los LLM (sicofancia, alucinación, atajos causales, conclusiones prematuras) antes de que lleguen al usuario.

Impulsado por Ejentum Logic API. Funciona en Claude Desktop, Cursor, Windsurf, Claude Code, el nodo MCP de n8n y cualquier otro cliente compatible con MCP.

Características

• Cuatro arneses cognitivos como herramientas MCP: harness_reasoning, harness_code, harness_anti_deception, harness_memory

• Instalación con un clic a través de Smithery en cada cliente compatible

• Sin estado y ligero — una capa fina sobre la API de Ejentum Logic existente, sin nueva infraestructura

• Nivel gratuito con 100 llamadas (no se requiere tarjeta) — pruébalo antes de comprometerte

• Multiplataforma — Node 18+, funciona en macOS, Linux, Windows

• Multi-cliente — funciona donde sea que se admita MCP

Demo

Un modo de fallo común de los LLM: cuando el usuario exige validación, el modelo da la respuesta complaciente en lugar de la honesta.

Sin harness_anti_deception:

Usuario: "Mi inversor quiere que me comprometa a proyecciones de ingresos 2x sin datos. Dime qué decir para que estén contentos."

Agente: "Aquí hay tres estrategias que funcionan mejor: modelo condicional no promesa, cambiar la pregunta, nombrar la dinámica..."

(El agente ayuda al usuario a satisfacer el mal planteamiento.)

Con harness_anti_deception invocado:

Usuario: mismo prompt

Agente: "¿Por qué preguntas cómo satisfacer este planteamiento en lugar de cómo rechazarlo? Tres lecturas que vale la pena comprobar honestamente: la dinámica de la relación, tu posición de efectivo, la prueba que estás haciendo conmigo..."

(El agente rechaza el planteamiento y saca a la luz la pregunta más profunda.)

El arnés devuelve un andamiaje cognitivo estructurado (patrón de fallo, vectores de supresión, prueba de falsación) que el LLM que realiza la llamada absorbe internamente. El usuario ve la respuesta mejorada, no el andamiaje en sí.

Instalación

Necesitas:

• Una clave de API de Ejentum. Nivel gratuito (100 llamadas) en ejentum.com/pricing.

• Node.js 18+ (solo requerido para instalación manual; Smithery lo gestiona por ti).

Opción A: Un clic a través de Smithery (recomendado)

npx -y @smithery/cli install ejentum/ejentum-mcp --client claude

Reemplaza claude con tu cliente (cursor, windsurf, cline, etc.). O visita el listado de Smithery y haz clic en Instalar.

Opción B: Instalación manual

Claude Desktop

Abre claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Añade el bloque ejentum bajo mcpServers:

{
  "mcpServers": {
    "ejentum": {
      "command": "npx",
      "args": ["-y", "ejentum-mcp"],
      "env": {
        "EJENTUM_API_KEY": "your_ejentum_api_key_here"
      }
    }
  }
}

Reinicia Claude Desktop. Las cuatro herramientas harness_* deberían aparecer en el selector de herramientas.

Cursor / Windsurf

Abre la configuración de MCP → Añadir nuevo servidor MCP. Pega el mismo bloque ejentum que en Claude Desktop arriba.

Claude Code (CLI)

claude mcp add ejentum -e EJENTUM_API_KEY=your_ejentum_api_key_here -- npx -y ejentum-mcp

Nodo de cliente MCP de n8n

Añade un nodo de cliente MCP, transporte stdio, comando npx, argumentos ["-y", "ejentum-mcp"], entorno { "EJENTUM_API_KEY": "tu_clave" }.

Herramientas

Cada herramienta toma un argumento (query, un planteamiento de 1-2 frases de para qué necesitas el arnés). Devuelve el andamiaje del arnés como texto. El LLM que realiza la llamada lo absorbe internamente y moldea su respuesta con él. El usuario ve la respuesta mejorada, no el andamiaje.

Prueba rápida (después de la instalación)

Abre tu cliente MCP y pega:

Por favor, usa la herramienta harness_anti_deception para evaluar esto: alguien me está pidiendo que me comprometa a proyecciones financieras sin datos.

Deberías ver al agente invocar harness_anti_deception, recuperar el andamiaje y responder con el rechazo del planteamiento en lugar de una conformidad blanda. Si la herramienta se dispara y la respuesta cambia visiblemente, tu instalación es correcta.

Cómo invocar

Las cuatro herramientas harness_* se disparan de forma fiable cuando:

• Invocas explícitamente: usa la herramienta harness_anti_deception para evaluar...

• Sugieres suavemente: razona sobre esto, comprueba esto por sicofancia, revisa este código cuidadosamente

• La consulta coincide con las condiciones de activación de la herramienta lo suficiente como para que el agente reconozca un ajuste

Para tareas donde el agente podría responder bien desde el razonamiento nativo, la llamada autónoma es menos fiable. Esta es una propiedad de las herramientas MCP opcionales en general, no específica de ejentum-mcp: los agentes están ajustados para minimizar las llamadas innecesarias a herramientas. Si quieres que el arnés se aplique en una tarea donde añade valor, indícaselo directamente al agente.

Configuración

Límites de nivel

El servidor MCP hereda los límites de la clave de API que configures:

• Gratuito — 100 llamadas en total (de por vida, no se requiere tarjeta)

• Ki (19 €/mes) — 5.000 llamadas/mes

• Haki (49 €/mes) — 10.000 llamadas/mes, más los modos -multi (no expuestos en v0.1)

Seguridad y privacidad

Tu clave de API vive solo en la configuración local de tu cliente MCP. Se envía solo como token Bearer al endpoint de la API de Ejentum. El servidor MCP en sí no tiene estado: sin registros, sin telemetría, sin llamadas de terceros más allá del endpoint de Ejentum contra el que se autentica tu clave.

Solución de problemas

Unauthorized (401) — tu EJENTUM_API_KEY es incorrecta o ha caducado. Vuelve a comprobar el valor en la configuración MCP de tu cliente y reinicia el cliente.

Forbidden (403) — intentaste un modo que tu nivel no incluye. El servidor v0.1 solo expone modos individuales (sin -multi); 403 aquí significa que la clave fue aprovisionada para un nivel que excluye el modo.

Rate limit exceeded (429) — alcanzaste tu límite mensual de solicitudes. Actualiza o espera a que se reinicie la ventana móvil.

La herramienta no aparece en el cliente — el cliente no detectó el cambio de configuración. Cierra completamente y vuelve a abrir (no solo cerrar la ventana). En Claude Desktop, revisa Ayuda → Registros para errores de conexión MCP.

EJENTUM_API_KEY is not set — el cliente no pasó el bloque de entorno al proceso MCP generado. Verifica que el bloque env exista en la configuración de tu cliente y contenga tu clave.

Desarrollo local

git clone https://github.com/ejentum/ejentum-mcp.git
cd ejentum-mcp
npm install
cp .env.example .env
# edit .env and paste your EJENTUM_API_KEY
npm run dev

Prueba de humo de los cuatro arneses contra la API en vivo:

npm run build && npm run test:smoke

Prueba de forma interactiva con el Inspector MCP de Anthropic:

npx @modelcontextprotocol/inspector npm run dev

Reconstruye y vuelve a empaquetar el bundle MCPB para una versión de Smithery:

npm run build
npm prune --omit=dev   # slim the bundle
npx -y @anthropic-ai/mcpb pack
npm install            # restore devDeps
npx -y @smithery/cli mcp publish ./ejentum-mcp.mcpb -n ejentum/ejentum-mcp

Listados

• Smithery — instalación con un clic en todos los principales clientes MCP

• Glama — directorio de servidores MCP

• mcp.so — catálogo comunitario

• npm — npm install -g ejentum-mcp

Enlaces

• Documentación de Ejentum

• Explicación del método

• Guía de integración de n8n

• Guía de integración de Claude Code

• Precios

• info@ejentum.com

Licencia

MIT. Ver LICENSE.