Trello

Se integra con Trello para gestionar proyectos, tableros y tarjetas, utilizando Nango para la autenticación.

GitHub
1
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Trello

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona una integración perfecta entre Claude y Trello mediante la autenticación de Nango. Este servidor permite a Claude interactuar con tus tableros, listas, tarjetas y más de Trello a través de comandos en lenguaje natural.

🚀 Características

  • Cobertura completa de la API de Trello: Gestiona tableros, listas, tarjetas, comentarios y archivos adjuntos
  • Autenticación segura: Utiliza Nango para la autenticación OAuth con Trello
  • Operaciones en tiempo real: Crea, lee, actualiza y elimina elementos de Trello al instante
  • Funcionalidad de búsqueda: Busca en tableros, tarjetas y miembros
  • Manejo de errores: Manejo robusto de errores con renovación automática de credenciales

📋 Herramientas disponibles

Operaciones con tableros

  • trello_get_my_boards - Obtén todos tus tableros
  • trello_get_board - Obtén detalles específicos de un tablero
  • trello_create_board - Crea nuevos tableros
  • trello_update_board - Actualiza información del tablero
  • trello_delete_board - Elimina tableros
  • trello_get_board_lists - Obtén todas las listas de un tablero
  • trello_get_board_cards - Obtén todas las tarjetas de un tablero
  • trello_get_board_members - Obtén los miembros del tablero

Operaciones con listas

  • trello_create_list - Crea nuevas listas
  • trello_update_list - Actualiza detalles de la lista
  • trello_archive_list - Archiva listas
  • trello_get_list_cards - Obtén tarjetas en una lista específica

Operaciones con tarjetas

  • trello_create_card - Crea nuevas tarjetas
  • trello_get_card - Obtén detalles de la tarjeta
  • trello_update_card - Actualiza tarjetas (incluyendo mover entre listas)
  • trello_delete_card - Elimina tarjetas
  • trello_add_comment_to_card - Añade comentarios a las tarjetas
  • trello_add_attachment_to_card - Añade archivos adjuntos a las tarjetas

Búsqueda y descubrimiento

  • trello_search - Busca en Trello tableros, tarjetas, miembros, etc.

🛠️ Instalación

Requisitos previos

  1. Python 3.13+ instalado en tu sistema
  2. Cuenta de Nango con la integración de Trello configurada
  3. Credenciales de la API de Trello (ID de cliente)

Paso 1: Clonar y configurar

git clone <your-repo-url>
cd trello-mcp

Paso 2: Instalar dependencias

Usando UV (recomendado):

uv sync

O usando pip:

pip install -e .

Paso 3: Configuración del entorno

Crea un archivo .env en la raíz del proyecto:

# Nango Configuration
NANGO_BASE_URL=https://api.nango.dev
NANGO_SECRET_KEY=your_nango_secret_key_here
NANGO_CONNECTION_ID=your_user_connection_id
NANGO_INTEGRATION_ID=trello

# Trello Configuration
TRELLO_CLIENT_ID=your_trello_api_key_here

# Optional: Enable debug mode
DEBUG=false

Paso 4: Configurar Claude Desktop

Añade la siguiente configuración al archivo de configuración de Claude Desktop:

Ubicación del archivo de configuración:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "trello": {
      "command": "uvx",
      "args": ["git+https://github.com/Shameerpc5029/trello-mcp.git"],
      "env": {
        "NANGO_BASE_URL": "https://api.nango.dev",
        "NANGO_SECRET_KEY": "your_nango_secret_key_here",
        "NANGO_CONNECTION_ID": "your_user_connection_id",
        "NANGO_INTEGRATION_ID": "trello",
        "TRELLO_CLIENT_ID": "your_trello_api_key_here"
      }
    }
  }
}

🔧 Guía de configuración

Obtención de tus credenciales

1. Configuración de Nango

  1. Regístrate en Nango.dev
  2. Crea una nueva integración para Trello
  3. Configura los ajustes de OAuth
  4. Obtén tu NANGO_SECRET_KEY desde el panel de control
  5. Configura una conexión y anota el NANGO_CONNECTION_ID

2. Clave de API de Trello

  1. Ve al Portal de desarrolladores de Trello
  2. Obtén tu clave de API (esta se convierte en tu TRELLO_CLIENT_ID)

Prueba de la instalación

  1. Prueba el servidor directamente:

    uv run trello-mcp

  2. Comprueba Claude Desktop:

    • Reinicia Claude Desktop
    • Busca las herramientas de Trello en la paleta de herramientas
    • Intenta preguntar: "Muéstrame mis tableros de Trello"

💡 Ejemplos de uso

Una vez configurado, puedes interactuar con Trello a través de Claude usando lenguaje natural:

Operaciones básicas

  • "Muéstrame todos mis tableros de Trello"
  • "Crea un nuevo tablero llamado 'Planificación de proyectos'"
  • "¿Qué listas hay en mi tablero 'Tareas de trabajo'?"
  • "Añade una tarjeta llamada 'Revisar PR' a la lista 'Por hacer'"

Operaciones avanzadas

  • "Mueve la tarjeta 'Corrección de errores' de 'En progreso' a 'Hecho'"
  • "Añade un comentario a la tarjeta sobre la actualización de la documentación"
  • "Busca todas las tarjetas que contengan 'urgente'"
  • "Crea una nueva lista llamada 'Bloqueado' en mi tablero de proyecto actual"

Gestión de proyectos

  • "Configura un nuevo tablero de proyecto con listas: Pendiente, Por hacer, En progreso, Revisión, Hecho"
  • "Muéstrame todas las tarjetas asignadas a mí en todos los tableros"
  • "Archiva la lista del sprint completado"

🔍 Solución de problemas

Problemas comunes

  1. Error de "Faltan variables de entorno requeridas"

    • Asegúrate de que todas las variables requeridas estén configuradas en tu archivo .env
    • Comprueba que la configuración en Claude Desktop coincida con tu entorno

  2. Fallos de autenticación

    • Verifica que tu integración de Nango esté configurada correctamente
    • Comprueba que tu clave de API de Trello sea correcta
    • Asegúrate de que la conexión de Nango esté activa

  3. El servidor no aparece en Claude

    • Reinicia Claude Desktop después de los cambios de configuración
    • Comprueba que la ruta del archivo en la configuración de Claude sea correcta
    • Verifica que el comando uv esté disponible en tu PATH

  4. La ejecución de la herramienta falla

    • Revisa los registros del servidor para ver mensajes de error detallados
    • Verifica que tus permisos de Trello permitan las operaciones solicitadas

Modo de depuración

Habilita el registro de depuración configurando DEBUG=true en tu archivo .env para obtener registros detallados de las operaciones.

🤝 Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de extracción.

Configuración de desarrollo

  1. Haz un fork del repositorio
  2. Crea una rama de funcionalidad
  3. Realiza tus cambios
  4. Prueba a fondo
  5. Envía una solicitud de extracción

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT: consulta el archivo LICENSE para más detalles.

🆘 Soporte

Si encuentras algún problema:

  1. Consulta la sección de solución de problemas anterior
  2. Revisa la documentación de MCP
  3. Consulta la documentación de Nango
  4. Abre un problema en este repositorio

🔗 Enlaces relacionados