SprintFlint

Rastreador de sprints con opinión. Lee/actualiza tickets, sprints, velocidad desde Claude/Cursor/Zed.

Documentación

Endpoint

Una URL, un encabezado de autenticación. El mismo token bearer que la API REST.

POST https://mcp.sprintflint.com
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
Accept: application/json, text/event-stream

Genera un token desde tu configuración de cuenta. El plan gratuito cubre 50 tickets gratuitos al mes; sin tarjeta.

Herramientas

Herramientas del primer día, mapeadas 1:1 con las acciones que un desarrollador realiza durante un sprint.

list-projects

Busca proyectos en tu organización (paginado). Devuelve id, nombre, slug y conteos.

list-sprints

Busca sprints dentro de un proyecto (paginado). Devuelve id del sprint, objetivo, fechas de inicio/fin y conteos de issues por estado.

list-issues

Busca issues dentro de un sprint (paginado). Filtra por estado. Devuelve id, título, estado, puntos de historia, asignado, etiquetas.

my-issues

Issues asignados al usuario que llama. La pregunta de apertura predeterminada para cualquier agente: "¿en qué estoy trabajando?"

get-issue

Lee un solo issue por referencia (p. ej. PROJ-123) incluyendo la descripción completa en markdown y el hilo de comentarios.

create-issue

Registra un nuevo issue en un sprint. Título, descripción, id del sprint, prioridad/etiquetas/asignado opcionales.

update-issue

Actualiza título, descripción, estado, puntos de historia o asignado en un issue existente. Todas las mutaciones son reversibles desde la interfaz.

create-comment

Publica un comentario en markdown en un issue. Usado por agentes para registrar enlaces de PR, actualizaciones de estado y bloqueos detectados.

Lo que deliberadamente no está expuesto

Dos operaciones que no incluimos el primer día; ambas irreversibles (o difíciles de deshacer) e inseguras de exponer a ciegas a un modelo que ocasionalmente alucina un argumento. Las operaciones de actualización sí están disponibles (toda mutación es reversible desde la interfaz), pero la destrucción sigue siendo una decisión humana.

  • delete-issue: destrucción silenciosa del historial de trabajo. Asimetría de costo demasiado alta. Haz clic en eliminar en la interfaz.
  • delete-sprint: ruptura silenciosa del historial de velocidad y la planificación del sprint. Usa el tablero.

Lee la justificación de diseño: Estado del sprint en tu agente: la guía del practicante.

Conéctate en 30 segundos

Elige tu editor. El Generador de Configuración MCP emite el fragmento correcto para cada uno.

Claude Desktop

Pega el bloque mcpServers en claude_desktop_config.json. Reinicia.

Configuración

Cursor

Configuración → MCP → Añadir servidor. Misma forma JSON.

Configuración

Claude Code

Un comando CLI: claude mcp add sprintflint --transport http ...

Configuración

Zed

Bloque context_servers en ~/.config/zed/settings.json.

Configuración

Autenticación, alcance, seguridad

  • Autenticación: Authorization: Bearer YOUR_TOKEN. Mismo token que la API REST.
  • Alcance: los tokens están limitados a tu organización. Sin acceso entre organizaciones.
  • Revocación: los tokens se listan por nombre + hora de último uso en la configuración de cuenta. Revoca al instante.
  • Recomendación: un token por dispositivo (p. ej. claude-desktop-macbook, cursor-work-laptop). Más fácil detectar huérfanos.
  • TLS: Heroku ACM con Let's Encrypt. HSTS precargado.
  • Límite de tasa: 600 solicitudes/min/token. 429 con encabezado Retry-After al exceder.

Preguntas frecuentes

Todo lo que necesitas saber sobre el servidor MCP.

¿Qué versión de protocolo habla el servidor?

2025-06-18 (estable actual). También acepta 2024-11-05 para clientes más antiguos.

¿El servidor MCP es gratuito?

Sí; las mismas reglas de plan que la API REST. El plan gratuito (50 tickets gratuitos al mes) obtiene acceso completo a MCP. Los planes de pago (£5/usuario/mes) obtienen acceso ilimitado.

¿El servidor admite recursos o prompts (los otros dos primitivos de MCP)?

Herramientas por ahora. Recursos y prompts están en la hoja de ruta; consulta /roadmap. El handshake de capacidades actualmente anuncia tools, prompts, resources, logging; las llamadas a herramientas son el único primitivo completamente implementado el primer día.

¿Puedo usar este servidor con mis propios agentes (LangChain, autogen, etc.)?

Cualquier cosa que hable MCP funciona. Trae tu propio cliente. Algunos clientes no-MCP funcionan mejor con la API REST: mismos datos, misma autenticación.

¿Qué pasa si el agente alucina un sprint o id de ticket?

El servidor devuelve un error estructurado. El agente ve el error y (normalmente) se corrige. Omitimos deliberadamente herramientas destructivas para que el peor caso sea una lectura fallida, no una eliminación silenciosa.

¿El servidor está alojado, o puedo autoalojarlo?

Solo alojado por ahora (mcp.sprintflint.com). Autoalojar servidores MCP tiene sentido para herramientas offline-first, menos para SaaS; tus datos de sprint ya viven en nuestros servidores.

¿Cómo reporto errores o solicito herramientas?

Envía un correo a [email protected]. Leemos todo.

¿Aún tienes una pregunta?; normalmente respondemos dentro de una hora.