Pipefy MCP Server

# Changelog - Pipefy MCP Server

## [Versión 2.0.0] - 2026-02-03

### 🎉 Mejoras Principales

#### Nuevas Herramientas Implementadas

**Database Tables (Tablas de Base de Datos)**
- ✅ `pipefy_list_tables` - Listar todas las tablas de una organización
- ✅ `pipefy_get_table` - Obtener detalles completos de una tabla
- ✅ `pipefy_create_table` - Crear nueva tabla en una organización

**Table Records (Registros de Tabla)**
- ✅ `pipefy_list_table_records` - Listar registros de una tabla
- ✅ `pipefy_get_table_record` - Obtener detalles completos de un registro
- ✅ `pipefy_create_table_record` - Crear nuevo registro en una tabla

### 📊 Estadísticas

- **Herramientas Anteriores:** 7
- **Herramientas Nuevas:** 6
- **Total de Herramientas:** 13
- **Incremento:** +85% de funcionalidad

### 🔍 Fuente de Información

Todas las mejoras se basaron en la **documentación oficial de Pipefy** extraída usando **firecrawl-mcp**:

- Database Tables: https://developers.pipefy.com/reference/tables
- Table Records: https://developers.pipefy.com/reference/table-records
- Fields: https://developers.pipefy.com/reference/fields
- Organizations: https://developers.pipefy.com/reference/organizations
- Webhooks: https://developers.pipefy.com/reference/pipe-table-webhooks
- Reports: https://developers.pipefy.com/reference/pipe-reports

### 🎯 Casos de Uso Habilitados

Con las nuevas herramientas, ahora es posible:

1. **Gestión de Bases de Datos**
   - Crear y gestionar tablas de datos estructurados
   - Almacenar información de clientes, productos, proveedores, etc.
   - Consultar registros con búsqueda avanzada

2. **Integración de Datos**
   - Sincronizar datos entre pipes y tablas
   - Crear sistemas de referencia cruzada
   - Mantener catálogos centralizados

3. **Reporting y Análisis**
   - Extraer datos de tablas para análisis
   - Generar reportes personalizados
   - Integrar con sistemas externos

### 🏗️ Arquitectura

#### Modelos Pydantic Agregados
```python
- ListTablesInput
- GetTableInput
- CreateTableInput
- ListTableRecordsInput
- GetTableRecordInput
- CreateTableRecordInput
```

#### Estructura de Herramientas

Todas las herramientas nuevas siguen las mejores prácticas de MCP:
- ✅ Annotations completas (readOnlyHint, destructiveHint, idempotentHint)
- ✅ Validación de entrada con Pydantic
- ✅ Soporte para formatos JSON y Markdown
- ✅ Manejo robusto de errores
- ✅ Documentación completa con docstrings
- ✅ Truncamiento de respuestas largas (25,000 caracteres)

### 📚 Documentación Actualizada

- ✅ README actualizado con nuevas herramientas
- ✅ MEJORAS.md con análisis completo de funcionalidades faltantes
- ✅ Ejemplos de uso agregados
- ✅ Documentación de API completa

### 🔜 Próximos Pasos Recomendados

#### Media Prioridad 🟡
1. **Organizations** (2 herramientas)
   - pipefy_list_organizations
   - pipefy_get_organization

2. **Webhooks** (4 herramientas)
   - pipefy_list_webhooks
   - pipefy_create_webhook
   - pipefy_update_webhook
   - pipefy_delete_webhook

3. **Reports** (2 herramientas)
   - pipefy_list_pipe_reports
   - pipefy_export_pipe_report

4. **Card Operations** (3 herramientas)
   - pipefy_update_card
   - pipefy_move_card
   - pipefy_delete_card

#### Baja Prioridad 🟢
5. **Fields Management** (7 herramientas)
   - Gestión completa de campos en phases y tablas

6. **Importers** (2 herramientas)
   - Importación masiva desde Excel

### 🧪 Testing

Para testear las nuevas herramientas:

```bash
# Exportar token de API
export PIPEFY_API_TOKEN=your_token_here

# Probar con MCP Inspector
npx @modelcontextprotocol/inspector python main.py
```

**Queries de Prueba:**
```
# Listar tablas
"List all tables in organization 12345"

# Ver detalles de tabla
"Show me details of table ZtEdWh"

# Crear tabla
"Create a new table called 'Customers' in organization 12345"

# Listar registros
"List records from table ZtEdWh"

# Ver registro
"Get details for record 987654"

# Crear registro
"Create a new record in table ZtEdWh with title 'John Doe'"
```

### 📖 Referencias

- **MCP Builder Skill:** `.agents/skills/mcp-builder/SKILL.md`
- **Pipefy API Docs:** https://developers.pipefy.com
- **MCP Best Practices:** https://modelcontextprotocol.io
- **FastMCP Documentation:** https://github.com/jlowin/fastmcp

### 🙏 Agradecimientos

Este MCP fue mejorado siguiendo:
- ✅ **mcp-builder skill** - Guía de desarrollo de MCP servers
- ✅ **firecrawl-mcp** - Para extraer documentación oficial
- ✅ **MCP Best Practices** - Convenciones y patrones recomendados

---

## [Versión 1.0.0] - Original

### Herramientas Originales
- pipefy_list_pipes
- pipefy_get_pipe
- pipefy_list_cards
- pipefy_get_card
- pipefy_search_cards
- pipefy_create_card
- pipefy_get_phase