Laddro Career

@laddro/career-mcp

Servidor MCP para la API Laddro Career. Da a los agentes de IA acceso a la adaptación de currículos, generación de cartas de presentación, exportación a PDF y exploración de plantillas.

Configuración

Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "laddro-career": {
      "command": "npx",
      "args": ["@laddro/career-mcp"],
      "env": {
        "LADDRO_API_KEY": "laddro_live_..."
      }
    }
  }
}

Claude Code

claude mcp add laddro-career -- npx @laddro/career-mcp

Establece la variable de entorno LADDRO_API_KEY antes de ejecutar.

HTTP remoto

Usa el endpoint HTTP Streamable alojado:

https://mcp.laddro.com/mcp

Envía tu clave de API de Laddro en la solicitud de inicialización MCP:

Authorization: Bearer laddro_live_...

o:

x-api-key: laddro_live_...

Herramientas disponibles

Herramienta	Descripción
laddro.templates.list	Explorar las 22 plantillas de currículum
laddro.templates.get	Obtener colores y fuentes de la plantilla
laddro.fonts.list	Todas las familias de fuentes disponibles
laddro.languages.list	Los 14 idiomas admitidos
laddro.models.list	Proveedores de IA para BYOK
laddro.resumes.list	Currículos del usuario
laddro.resumes.get	Metadatos del currículum
laddro.resumes.render	Re-renderizar con nueva configuración de plantilla
laddro.resumes.tailor	Adaptar currículum con IA para un trabajo
laddro.resumes.export	Exportar como PDF
laddro.coverLetters.list	Cartas de presentación del usuario
laddro.coverLetters.get	Metadatos de carta de presentación
laddro.coverLetters.create	Crear manualmente
laddro.coverLetters.generate	Generar con IA a partir de currículum + trabajo
laddro.coverLetters.render	Renderizar con configuración de plantilla
laddro.settings.get	Configuración actual del proveedor de IA
laddro.settings.updateModel	Establecer proveedor BYOK
laddro.settings.deleteModel	Eliminar configuración BYOK

Modo conector (OAuth)

Detrás de la bandera MCP_CONNECTOR_ENABLED (desactivada por defecto). Cuando está habilitada y una solicitud lleva Authorization: Bearer lad_at_* (un token de acceso OAuth de Laddro), el servidor ejecuta una sesión de conector OAuth que reenvía el token a laddro-backend (service.laddro.com) en lugar de career-api. También sirve GET /.well-known/oauth-protected-resource (RFC 9728) y responde a llamadas no autenticadas /mcp con 401 + WWW-Authenticate: Bearer resource_metadata=... para que los clientes OAuth puedan descubrir el servidor de autorización. Con la bandera desactivada, el comportamiento es sin cambios (sin ruta de descubrimiento, sin aplicación de 401, las 18 herramientas a través de career-api).

Herramientas del conector (solo sesiones OAuth): "Tú escribes el contenido. Laddro lo almacena y renderiza el PDF."

Herramienta	Ámbito	Descripción
laddro.resume.schema	—	Esquema JSON para contenido de currículum
laddro.resume.create	resumes:write	Crear un currículum, devuelve { resumeId }
laddro.resume.update	resumes:write	Reemplazo completo de un currículum, devuelve { resumeId, updatedAt }
laddro.coverLetter.schema	—	Esquema JSON para contenido de carta de presentación

Variables de entorno

Variable	Requerida	Descripción
LADDRO_API_KEY	Sí para stdio; respaldo opcional para HTTP	Tu clave de API de Laddro
LADDRO_BASE_URL	No	Anular URL de API (por defecto: https://api.laddro.com)
MCP_CONNECTOR_ENABLED	No	true habilita el modo conector OAuth (desactivado por defecto)
LADDRO_BACKEND_URL	No	URL base del backend para herramientas de conector (por defecto: https://service.laddro.com)
MCP_PUBLIC_URL	No	URL pública de este servidor para metadatos OAuth (si no, se deriva de cabeceras reenviadas)

Desarrollo

npm ci
npm test

npm test compila el paquete TypeScript y ejecuta pruebas de contrato MCP para manejo de autenticación, metadatos de herramientas y enrutamiento de handlers.

Lanzamientos

Este paquete usa Changesets y SemVer.

• Parche: correcciones de errores, documentación, pruebas, endurecimiento interno.
• Menor: nuevas herramientas o capacidades MCP compatibles hacia atrás.
• Mayor: cambios importantes en nombres de herramientas, esquemas, autenticación o comportamiento de transporte.

Cada PR que modifique el paquete publicado debe incluir un changeset:

npm run changeset

Después de que el PR se fusione en main, GitHub Actions abre un PR de lanzamiento con el incremento de versión y el changelog. Al fusionar ese PR de lanzamiento se publica el paquete en npm y se crea el lanzamiento de GitHub. El flujo de trabajo de despliegue en Cloud Run también se ejecuta en main, por lo que el MCP alojado se actualiza automáticamente después de fusiones de lanzamiento.

Registro MCP

Este servidor está listado en el registro oficial de MCP como com.laddro/career. server.json es el manifiesto del registro; scripts/sync-version-metadata.mjs mantiene su versión sincronizada con el paquete npm en cada lanzamiento.

La publicación está automatizada: .github/workflows/publish-registry.yml se ejecuta cada vez que un lanzamiento cambia server.json en main y envía la nueva versión al registro. La autenticación se basa en DNS: la clave pública Ed25519 vive en el registro TXT laddro.com, y la clave privada correspondiente (hex) se guarda como secreto del repositorio MCP_PUBLISHER_ED25519_KEY.

Para publicar (o ponerse al día) manualmente:

MCP_PUBLISHER_ED25519_KEY=<hex-private-key> ./scripts/publish-registry.sh

Enlaces

• laddro.com
• Referencia de API
• Documentación
• GitHub

Licencia

MIT