Los conectores MCP (Model Context Protocol) permiten ahora a tu asistente de IA leer y escribir directamente en tus proyectos de Kalinotes. Combinados con los skills de Claude Code, convierten la toma de notas, la revisión de aplicaciones y el seguimiento de bugs en flujos de trabajo totalmente automatizados — sin salir de tu terminal ni de tu IDE.
¿Qué es el protocolo MCP?
El Model Context Protocol (MCP) es un estándar abierto desarrollado por Anthropic que permite a los agentes de IA conectarse a fuentes de datos y herramientas externas de forma estandarizada. En la práctica, en lugar de copiar y pegar manualmente contenido entre tu asistente y tus herramientas, el conector MCP crea un puente directo: la IA puede leer tus notas, crear nuevo contenido y actualizar entradas existentes en tiempo real.
Kalinotes ofrece su propio conector MCP que da acceso a todo tu espacio de trabajo: proyectos, categorías, notas y comentarios. Tu IA dispone así del mismo contexto que tú, sin esfuerzo adicional.
💡 En resumen: el conector MCP de Kalinotes convierte tu asistente Claude en un colaborador capaz de actuar directamente en tu espacio de notas, no solo de hablar sobre él.
Configurar el conector MCP de Kalinotes
La configuración se realiza en tres pasos desde el terminal:
- Instala Claude Code:
npm install -g @anthropic-ai/claude-code - Obtén tu token de API en la configuración de tu cuenta de Kalinotes
- Añade el servidor MCP a Claude Code:
claude mcp add kalinotes --token TU_TOKEN
Una vez configurado, Claude Code accede a todos tus proyectos y categorías de Kalinotes. Puedes verificar la conexión preguntando a Claude: «Lista mis proyectos de Kalinotes».
Requisitos previos
- Una cuenta activa de Kalinotes con al menos un proyecto creado
- Node.js instalado (versión 18 o superior)
- Claude Code instalado mediante npm
- Un token de API generado desde tu espacio de Kalinotes
Los 8 skills de Claude disponibles para Kalinotes
Los skills son comandos slash (archivos Markdown colocados en
~/.claude/commands/) que amplían las capacidades de Claude Code
con flujos de trabajo especializados. Kalinotes ofrece ocho skills dedicados,
descargables desde la página
app.kalinotes.com/outils/claude-skills
.
| Skill | Comando | Función |
|---|---|---|
| Capture | /kalinotes-capture |
Analiza la conversación y crea una nota deduciendo automáticamente el proyecto y la categoría |
| ADR | /kalinotes-adr |
Estructura las decisiones de arquitectura (Contexto / Opciones / Decisión / Consecuencias) |
| Review | /kalinotes-review |
Agrega las notas de un proyecto en un resumen: tareas abiertas, decisiones, sugerencias |
| Search | /kalinotes-search |
Búsqueda por palabras clave en todos tus proyectos con extractos contextuales |
| Standup | /kalinotes-standup |
Genera notas de standup diarias a partir de entradas anteriores, con seguimiento de elementos pendientes |
| Bug | /kalinotes-bug |
Crea informes de bugs estructurados (síntomas, pasos de reproducción, solución) |
| QA | /kalinotes-qa |
Audita una aplicación web: funcional, UX, rendimiento y seguridad — y documenta los resultados en Kalinotes |
| Snippet | /kalinotes-snippet |
Detecta automáticamente el lenguaje y guarda el snippet con metadatos y etiquetas generadas |
Instalación de los skills
Cada skill es un archivo .md que se coloca en
~/.claude/commands/ para disponibilidad global, o en
.claude/commands/ a nivel de proyecto para un alcance local.
Una vez en su lugar, el comando slash correspondiente está disponible
inmediatamente en cualquier sesión de Claude Code.
Caso de uso: revisión completa de una aplicación con /kalinotes-qa
Este es un escenario concreto que ilustra la potencia de la combinación MCP + skills. Acabas de terminar el desarrollo de una aplicación web y quieres realizar una revisión de calidad antes de la entrega, generar notas de bugs y mejoras, consultar un informe de síntesis y compartir los resultados con tu cliente o equipo.
Paso 1 — Conectar tu IA e instalar los skills
Tras configurar el conector MCP como se describe anteriormente, descarga los
skills desde la página de herramientas de Kalinotes. Copia los archivos
kalinotes-qa.md y kalinotes-bug.md en tu carpeta
~/.claude/commands/. A continuación, abre Claude Code en el
directorio de tu proyecto:
Verificación rápida
Escribe / en Claude Code para ver la lista de comandos disponibles.
Deberías ver aparecer /kalinotes-qa, /kalinotes-bug
y los demás skills instalados.
Paso 2 — Lanzar la revisión QA con /kalinotes-qa
Inicia la auditoría indicando la URL de tu aplicación (o la ruta local si se ejecuta en desarrollo):
/kalinotes-qa https://mi-app.example.com
Claude Code recorre la aplicación según cuatro ejes de análisis:
- Funcional: verificación de flujos de usuario, formularios, enlaces, navegación
- UX: consistencia visual, accesibilidad, legibilidad de mensajes de error
- Rendimiento: tiempos de carga, imágenes sin optimizar, recursos bloqueantes
- Seguridad: cabeceras HTTP ausentes, datos sensibles expuestos, configuraciones de riesgo
Paso 3 — Generar notas de bugs y mejoras
Al final de la auditoría, Claude crea automáticamente notas estructuradas en
tu proyecto de Kalinotes. Cada anomalía detectada genera una nota de bug mediante
/kalinotes-bug, que incluye:
- Descripción del síntoma observado
- Pasos para reproducir el problema
- Criticidad estimada (bloqueante, grave, menor)
- Sugerencia de corrección
Los puntos de mejora (UX, rendimiento, accesibilidad) se guardan en una categoría dedicada «Mejoras», con una puntuación de prioridad y el beneficio esperado para el usuario final.
💡 Consejo: crea previamente en Kalinotes un proyecto dedicado a tu aplicación con dos categorías distintas — Bugs y Mejoras — para que Claude organice las notas automáticamente sin intervención manual.
Paso 4 — Visualizar el informe de síntesis
Una vez creadas las notas, usa el skill /kalinotes-review para
generar un informe consolidado del proyecto:
/kalinotes-review
Claude agrega todas las notas del proyecto y produce un resumen estructurado:
- Número de bugs por criticidad
- Lista de mejoras priorizadas
- Resumen de decisiones técnicas tomadas
- Estimación del esfuerzo de corrección
Este informe puede compartirse directamente con tu cliente o jefe de proyecto como acta de la fase de aceptación.
Paso 5 — Compartir el acceso al proyecto
Kalinotes permite compartir un proyecto con otros usuarios desde la interfaz web. Ve a los ajustes del proyecto correspondiente e invita a tus colaboradores por dirección de correo electrónico. Puedes definir dos niveles de acceso:
- Solo lectura: ideal para un cliente que sigue el progreso sin modificar las notas
- Colaborador: acceso completo para un miembro del equipo que participa en la revisión
Los miembros invitados acceden directamente a las notas creadas por tu IA sin necesidad de instalar Claude Code ni configurar el MCP — la colaboración se mantiene fluida incluso para quienes no son desarrolladores.
🔄 Flujo completo de un vistazo
- Configurar el MCP de Kalinotes en Claude Code (una sola vez)
- Instalar los archivos de skills en
~/.claude/commands/ - Crear un proyecto de Kalinotes con las categorías Bugs y Mejoras
- Ejecutar
/kalinotes-qa <URL>para la auditoría automatizada - Consultar las notas generadas directamente en Kalinotes
- Ejecutar
/kalinotes-reviewpara el informe de síntesis - Compartir el proyecto con el cliente o el equipo desde los ajustes de Kalinotes
Por qué este enfoque cambia las reglas del juego
La combinación MCP + skills elimina los pasos manuales más costosos en tiempo del ciclo de revisión: registro de bugs, organización de notas, redacción del informe. La IA se encarga de la documentación mientras tú te concentras en las decisiones y las correcciones. Y como todo está centralizado en Kalinotes, los comentarios siguen siendo accesibles, trazables y compartibles, independientemente del tamaño del equipo.
🚀 ¿Listo para conectar tu IA a Kalinotes?
Descarga los skills, configura el conector MCP y lanza tu primera auditoría QA automatizada en menos de diez minutos. Acceder a los skills en kalinotes.com