foundry-boards-mcp

# Foundry Boards — MCP para agentes de IA Servidor **MCP** (Model Context Protocol) que le da a **Claude Code, Codex, OpenCode, Gemini** y otros clientes compatibles herramientas para **administrar los tableros de Foundry** con un **modelo de gestión de trabajo ágil** (ADR-0014): listar/crear tableros, crear/mover/editar tarjetas (work items), **transicionar por estados**, gestionar **jerarquía** (épicas/historias/subtareas), **etiquetas**, **vínculos**, **sprints** (Scrum), leer el **historial estructurado** y **gestionar adjuntos** (leer imágenes, subir y borrar) — además de mover un tablero personal a un Área. No forma parte del backend ni lo modifica: habla el **mismo contrato REST público** que el frontend, autenticándose como una **cuenta de usuario** (JWT). Corre en **tu máquina**, igual que `integrations/discord-porrin` y `integrations/porrin-meet`. ``` Agente IA ──stdio──► foundry-boards (este MCP) ──HTTP + JWT──► Foundry API (/api/v1) tools de tablero (permisos por rol) ``` ## Por qué un MCP (y no llamar al backend a mano) Con el MCP conectado, le pides al agente cosas en lenguaje natural y opera el tablero: - *"Lista mis tableros y muéstrame las tarjetas del de Marketing."* - *"Crea la tarea 'Migrar auth a OAuth' en En progreso, prioridad alta, asígnala a Ana."* - *"Mueve todas las tarjetas de En revisión que ya estén aprobadas a Hecho."* Los **permisos los valida el backend por rol**: dueño/colaborador pueden mutar; **observador solo lee** (una mutación devuelve 403 y Claude te lo dice). ## Requisitos - **Python 3.10+** (lo gestiona `uv`; no necesitas python/pip en el PATH). - **Un backend con el que hablar.** Por omisión, el Foundry público (`https://foundry.collie.digital`): no hace falta levantar nada. Para apuntar a otro —el tuyo en local, o uno propio— se dice con `FOUNDRY_API_BASE` (ver *Configuración*). - Una **cuenta de Foundry**; para administrar tableros de un Área, esa cuenta…