Docs
Integración MCP
Conectá asistentes de IA a Habito usando el Model Context Protocol
Integración MCP
Habito proporciona un servidor Model Context Protocol (MCP) que permite a asistentes de IA como Claude, ChatGPT y otros interactuar con tus proyectos, issues y equipos programáticamente.
MCP permite que los asistentes de IA lean tus proyectos, creen y actualicen issues, busquen tareas y gestionen tu flujo de trabajo - todo mediante lenguaje natural.
¿Qué es MCP?
El Model Context Protocol es un protocolo abierto que estandariza cómo las aplicaciones de IA se integran con fuentes de datos externas y herramientas. En lugar de copiar y pegar datos entre Habito y tu asistente de IA, MCP proporciona acceso directo en tiempo real.
URL del Servidor: https://habito.ar/mcp
Autenticación
Para usar el servidor MCP de Habito, necesitás una clave API.
Obtener Tu Clave API
- Navegá a tu página de perfil
- Generá una nueva clave API en la sección de Claves API
- Copiá la clave (empieza con
hab_) - Guardala de forma segura - no se mostrará nuevamente
Mantené tu clave API secreta. Proporciona acceso completo a tu cuenta de Habito. Nunca la commitees al control de versiones ni la compartas públicamente.
Herramientas Disponibles
Proyectos
| Herramienta | Descripción |
|---|---|
list_projects | Listá todos los proyectos a los que tenés acceso con conteos de issues |
get_project | Obtené información detallada sobre un proyecto específico por ID o slug |
Issues
| Herramienta | Descripción |
|---|---|
list_issues | Listá issues con filtros opcionales (proyecto, estado, asignado, prioridad, etiquetas) |
get_issue | Obtené información detallada sobre un issue específico incluyendo comentarios y actividad |
create_issue | Creá un nuevo issue con título, descripción, asignado, etiquetas, prioridad y más |
update_issue | Actualizá campos de issue como estado, asignado, prioridad, descripción o etiquetas |
search_issues | Buscá issues por consulta de texto en títulos y descripciones |
Comentarios
| Herramienta | Descripción |
|---|---|
create_comment | Agregá un comentario a un issue existente |
Usuarios
| Herramienta | Descripción |
|---|---|
get_me | Obtené información sobre el usuario autenticado (XP, nivel, HP, oro) |
Configuración
Configurá tu asistente de IA para conectarse al servidor MCP de Habito. Reemplazá TU_CLAVE_API_AQUI con tu clave API real.
# Agregá el servidor MCP de Habito a Claude Code con autenticación de clave API
claude mcp add --transport http habito https://habito.ar/mcp --header "Authorization:Bearer TU_CLAVE_API_AQUI"
{
"mcpServers": {
"habito": {
"type": "http",
"url": "https://habito.ar/mcp",
"headers": {
"Authorization": "Bearer TU_CLAVE_API_AQUI"
}
}
}
}
{
"mcp_servers": {
"habito": {
"url": "https://habito.ar/mcp",
"headers": {
"Authorization": "Bearer TU_CLAVE_API_AQUI"
}
}
}
}
{
"mcpServers": {
"habito": {
"type": "http",
"url": "https://habito.ar/mcp",
"headers": {
"Authorization": "Bearer TU_CLAVE_API_AQUI"
}
}
}
}
{
"mcp.servers": {
"habito": {
"type": "http",
"url": "https://habito.ar/mcp",
"headers": {
"Authorization": "Bearer TU_CLAVE_API_AQUI"
}
}
}
}
{
"mcp": {
"habito": {
"url": "https://habito.ar/mcp",
"headers": {
"Authorization": "Bearer TU_CLAVE_API_AQUI"
}
}
}
}
{
"context_servers": {
"habito": {
"settings": {
"url": "https://habito.ar/mcp",
"headers": {
"Authorization": "Bearer TU_CLAVE_API_AQUI"
}
}
}
}
}
{
"experimental": {
"modelContextProtocolServers": {
"habito": {
"url": "https://habito.ar/mcp",
"headers": {
"Authorization": "Bearer TU_CLAVE_API_AQUI"
}
}
}
}
}
Consultas de Ejemplo
Una vez configurado, podés interactuar con Habito usando lenguaje natural:
Listar Proyectos
Mostrame todos mis proyectos de Habito
¿En qué proyectos estoy trabajando?
Ver Issues
Listá todos los issues en progreso en el proyecto Rediseño de Sitio Web
Mostrame mis issues asignados que son de alta prioridad
¿Qué bugs están abiertos en el proyecto HAB-123?
Crear Issues
Creá un issue titulado "Agregar modo oscuro al dashboard" en el proyecto UI
Agregá una nueva tarea: "Arreglar bug de timeout de autenticación" asignada a [email protected] con prioridad alta
Actualizar Issues
Actualizá el estado del issue HAB-123 a hecho
Cambiá la prioridad de HAB-456 a alta y agregá etiqueta "urgente"
Asigná HAB-789 a [email protected]
Buscar Issues
Buscá en Habito issues sobre autenticación
Encontrá todos los issues que mencionen "migración de base de datos"
Agregar Comentarios
Agregá un comentario a HAB-123: "Esto está listo para revisión"
Comentá en HAB-456 con los resultados de test
Obtener Info de Usuario
¿Quién soy en Habito?
Mostrame mi información de perfil de Habito
Flujos de Trabajo Comunes
Daily Standup
Mostrame todos mis issues en progreso a través de todos los proyectos
La IA listará tus items de trabajo actuales, facilitando la preparación para standups.
Planificación de Proyecto
Listá todos los issues en el proyecto App Móvil agrupados por estado
Obtené una vista rápida del progreso del proyecto sin abrir el navegador.
Creación de Issues desde Revisión de Código
Encontré un bug en el flujo de autenticación. Creá un issue de Habito titulado
"Arreglar condición de carrera en refresh de token" en el proyecto Backend con prioridad alta.
Incluí esta descripción: [pegar detalles]
Capturá rápidamente issues durante revisiones de código.
Revisión de Sprint
Mostrame todos los issues marcados como hechos en el proyecto Backend en la última semana
Revisá trabajo completado sin filtrado manual.
Manejo de Errores
Si encontrás errores de autenticación:
Autenticación fallida: Chequeá que tu clave API sea correcta y no haya sido revocada. Generá una nueva clave desde tu página de perfil si es necesario.
Si ves errores de permisos:
Permiso denegado: Asegurate de tener acceso al proyecto o issue que estás intentando acceder. Contactá a tu admin de equipo si necesitás permisos adicionales.
Mejores Prácticas
Seguridad de Clave API
- Nunca commitees claves API al control de versiones
- Usá variables de entorno para desarrollo local
- Rotá claves periódicamente
- Revocá claves no usadas inmediatamente
Consultas Eficientes
- Usá IDs de proyecto específicos cuando sea posible para respuestas más rápidas
- Filtrá issues por estado, asignado o etiquetas para reducir tamaño de resultado
- La búsqueda está optimizada para consultas cortas y enfocadas
Limitación de Velocidad
El servidor MCP respeta límites de velocidad de API estándar:
- 100 solicitudes por minuto por clave API
- 1000 solicitudes por hora por clave API
Consejo Pro: Agrupá consultas relacionadas juntas. En lugar de preguntar "Mostrá proyecto X" luego "Listá issues en X", preguntá "Mostrá proyecto X con todos sus issues actuales" para reducir llamadas a API.
Solución de Problemas
Problemas de Conexión
Si tu asistente de IA no puede conectarse a Habito:
- Verificá que la URL del servidor sea exactamente
https://habito.ar/mcp - Chequeá que tu clave API esté correctamente formateada con prefijo
Beareren headers - Asegurate que tu clave API no haya expirado o sido revocada
- Chequeá tu conexión a internet y configuración de firewall
Herramienta No Encontrada
Si la IA dice que no puede encontrar una herramienta de Habito:
- Reiniciá tu asistente de IA para recargar servidores MCP
- Verificá que la configuración MCP esté en el archivo de config correcto
- Chequeá los logs del asistente de IA para errores de conexión
Resultados Inesperados
Si las consultas devuelven datos inesperados:
- Verificá que tengas permiso para acceder a los recursos solicitados
- Chequeá que los IDs de proyecto/issue sean correctos
- Revisá parámetros de filtro (estado, asignado, etc.)
Soporte
¿Necesitás ayuda con la integración MCP?
- Chequeá la documentación de API para parámetros detallados de herramientas
- Visitá el foro de comunidad para preguntas comunes
- Contactá soporte en [email protected] para problemas técnicos