Praxicraft Assess MCP

Servidor oficial del Model Context Protocol para la API pública de Praxicraft Assess.

Conecta Cursor, Claude Code, Claude Desktop, Codex o cualquier cliente MCP para que un agente pueda invitar candidatos, gestionar evaluaciones y pipelines, registrar webhooks y obtener resultados, con tu permiso.

npx -y @praxicraft/assess-mcp

Requiere Node.js 18+. Documentación del producto: docs.praxicraft.com/assess-mcp · Crea con agentes

¿Prefieres una sola instalación para API MCP + búsqueda en documentación + habilidades? Usa el Assess Agent Plugin.

Tabla de contenidos

• Dos formas de conectarse

• Autenticación

• Inicio rápido

  • HTTP alojado (Cursor / Claude Code)

  • Stdio (clave de API)

• Qué pueden hacer los agentes

• Modo Live vs Test

• Errores

• Requisitos y soporte

• Licencia

Related MCP server: Oktopost MCP Server

Two ways to connect

El OAuth alojado es la vía más sencilla en Cursor y Claude. Usa stdio cuando necesites una clave ct_test_ o un entorno no interactivo.

Authentication

Hosted (OAuth)

Sin clave de API en tu configuración. La primera llamada a una herramienta abre una pantalla de consentimiento en el navegador. Propietarios, administradores y desarrolladores pueden aprobarla.

Las sesiones alojadas siempre están en modo live.

Stdio (API key)

Crea una clave de API de organización:

Assess → Developer → API Keys → crea una clave → copia ct_live_… o ct_test_… (se muestra una sola vez).

export PRAXICRAFT_API_KEY="ct_test_xxxxxxxxxxxxxxxx"
# optional
export PRAXICRAFT_API_BASE_URL="https://assess.praxicraft.com"

Nunca comprometas las claves de API. Prefiere variables de entorno o un gestor de secretos.

Las listas de permitidos de IP en las claves de API se aplican a las solicitudes de la API pública / stdio MCP. No se aplican al OAuth alojado. Usa una clave dedicada con una lista de permitidos vacía para stdio si otras claves están restringidas por CIDR.

Ámbitos y rotación: Autenticación

Recommended scopes

Quickstart

Hosted HTTP (Cursor / Claude Code)

Añade a tu configuración de MCP:

{
  "mcpServers": {
    "praxicraft-assess": {
      "url": "https://assess.praxicraft.com/mcp"
    }
  }
}

Ejemplo con Claude Code:

{
  "mcpServers": {
    "praxicraft-assess": {
      "type": "http",
      "url": "https://assess.praxicraft.com/mcp"
    }
  }
}

Reinicia el cliente y prueba: “Lista mis evaluaciones de Assess e invítame a la primera activa.”

Stdio (API key)

{
  "mcpServers": {
    "praxicraft-assess": {
      "command": "npx",
      "args": ["-y", "@praxicraft/assess-mcp"],
      "env": {
        "PRAXICRAFT_API_KEY": "ct_test_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Desde el código fuente (contribuidores):

git clone https://github.com/praxicraft-platform/praxicraft-assess-mcp.git
cd praxicraft-assess-mcp
npm ci
npm test
npm run smoke

What agents can do

Las herramientas se asignan a la API pública de Assess (/api/v1/public/…). La cobertura incluye:

Las respuestas son JSON plano (misma forma que la API pública, sin envoltorio { "data": … }).

Recuerda a los agentes que respeten los límites del plan y que se ramifiquen según error.code.

Live vs Test mode

Un candidate.passed de prueba nunca llega a un destino Slack o HTTPS en vivo. Consulta Modo Live y Test.

Errors

Los errores de la API pública tienen este aspecto:

{ "error": { "code": "SOME_CODE", "message": "…", "details": {} } }

Siempre ramifícate según error.code. Referencia: Errores

Requirements & support

• Node.js 18+ (paquete stdio)

• Plan de Assess que incluya claves de API (consulta límites del plan)

• Documentación del producto: docs.praxicraft.com

• Plugin de agente (API + Knowledge MCP de documentación + habilidades): praxicraft-assess-agent-plugin

• Problemas: GitHub Issues

• Correo electrónico: support@praxicraft.com

Mantenedores que despliegan el servicio /mcp alojado: consulta DEPLOYMENT.md.

License

MIT