MCP Trello

Un servidor para interactuar con tableros de Trello, manejando integración de API, limitación de velocidad y seguridad de tipos.

GitHub
10
Prueba este MCPPatrocinado

Documentación

smithery badge npm version

MCP Trello

Un servidor de Model Context Protocol (MCP) que proporciona herramientas para interactuar con tableros de Trello. Este servidor permite una integración fluida con la API de Trello mientras maneja automáticamente la limitación de velocidad, la seguridad de tipos y el manejo de errores.

Características

  • Integración completa con tableros de Trello: Interactúa con tarjetas, listas y actividades del tablero
  • Limitación de velocidad integrada: Respeta los límites de la API de Trello (300 solicitudes/10s por clave de API, 100 solicitudes/10s por token)
  • Implementación con seguridad de tipos: Escrito en TypeScript con definiciones de tipos exhaustivas
  • Validación de entrada: Validación robusta para todas las entradas de la API usando esquemas Zod
  • Manejo de errores: Manejo elegante de errores con mensajes informativos

Componentes principales

  • Servidores MCP: Estos servidores actúan como puentes, exponiendo APIs, bases de datos y bibliotecas de código a hosts de IA externos. Al implementar un servidor MCP en TypeScript, los desarrolladores pueden compartir fuentes de datos o lógica computacional de manera estandarizada usando JSON-RPC 2.0.
  • Clientes MCP: Estos son el lado orientado al consumidor de MCP, comunicándose con servidores para consultar datos o realizar acciones. Los clientes MCP usan SDKs de TypeScript, garantizando interacciones con seguridad de tipos y un enfoque uniforme para el uso de herramientas.
  • Hosts MCP: Sistemas como Claude, Cursor, Windsurf, Cline y otras plataformas basadas en TypeScript coordinan solicitudes entre servidores y clientes, asegurando un flujo de datos fluido. Un solo servidor MCP puede así ser accedido por múltiples hosts de IA sin integraciones personalizadas.

Herramientas disponibles

MCP Trello proporciona las siguientes herramientas para interactuar con Trello:

Gestión de tableros

  • getMyBoards: Recupera todos los tableros del usuario autenticado (útil para encontrar IDs de tableros)

Gestión de tarjetas

  • getCardsByList: Obtiene todas las tarjetas de una lista específica
  • getMyCards: Obtiene todas las tarjetas asignadas al usuario actual (funciona sin ID de tablero)
  • addCard: Agrega una nueva tarjeta a una lista especificada
  • updateCard: Actualiza los detalles de una tarjeta existente (nombre, descripción, fechas de vencimiento, etiquetas, posición)
  • moveCard: Mueve una tarjeta a una lista o tablero diferente
  • archiveCard: Envía una tarjeta al archivo
  • changeCardMembers: Agrega o elimina miembros de una tarjeta

Gestión de listas

  • getLists: Recupera todas las listas del tablero configurado (requiere ID de tablero)
  • addList: Agrega una nueva lista al tablero (requiere ID de tablero)
  • archiveList: Envía una lista al archivo

Información del tablero

  • getRecentActivity: Obtiene la actividad reciente en el tablero (requiere ID de tablero)

Estructura del proyecto

mcp-trello/
├── src/
│   ├── index.ts          # Main entry point
│   └── trello/           # Trello API integration
│       ├── client.ts     # Trello client implementation
│       ├── rate-limiter.ts # Rate limiting functionality
│       └── types.ts      # TypeScript type definitions
├── docs/                 # Documentation
├── package.json          # Project configuration
└── tsconfig.json         # TypeScript configuration

Instalación

Usando Smithery

La forma más fácil de instalar MCP Trello es usando Smithery:

# For Claude
npx -y @smithery/cli install @Hint-Services/mcp-trello --client claude

# For Cursor
npx -y @smithery/cli install @Hint-Services/mcp-trello --client cursor

# For Windsurf
npx -y @smithery/cli install @Hint-Services/mcp-trello --client windsurf

# For Cline
npx -y @smithery/cli install @Hint-Services/mcp-trello --client cline

# For TypeScript
npx -y @smithery/cli install @Hint-Services/mcp-trello --client typescript

Instalación manual

pnpm add mcp-trello

Configuración

Agrega el servidor a tu archivo de configuración de MCP con la siguiente configuración:

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@Hint-Services/mcp-trello"],
      "env": {
        "trelloApiKey": "your-api-key",
        "trelloToken": "your-token",
        "trelloBoardId": "your-board-id"
      }
    }
  }
}

Variables de entorno

Requeridas

  • trelloApiKey: Tu clave de API de Trello (obtenerla de https://trello.com/app-key)
  • trelloToken: Tu token de Trello (generarlo usando tu clave de API)

Opcionales

  • trelloBoardId: ID completo de 24 caracteres del tablero de Trello con el que interactuar (requerido para operaciones específicas del tablero)

Cómo encontrar tu ID de tablero

Importante: El ID del tablero NO es el código corto que ves en la URL de Trello.

Por ejemplo, si la URL de tu tablero es https://trello.com/b/a1b2c3d4/my-board, el código corto a1b2c3d4 no es el ID del tablero.

Para encontrar el ID completo de 24 caracteres de tu tablero:

  1. Configura el servidor solo con tu clave de API y token (omite trelloBoardId inicialmente)
  2. Usa la herramienta getMyBoards para listar todos tus tableros
  3. Encuentra tu tablero en los resultados y copia el campo id (no shortLink)
  4. El ID del tablero se verá así: 507f1f77bcf86cd799439011 (24 caracteres)
  5. Agrega este ID completo a tu configuración como trelloBoardId

Nota: Algunas herramientas como getMyCards y getMyBoards funcionan sin un ID de tablero configurado. Las herramientas específicas del tablero como getLists, addList y getRecentActivity requieren un ID de tablero válido.

Para desarrolladores

Si estás interesado en contribuir a este proyecto o en desarrollar tus propias herramientas con este servidor, consulta la Guía de desarrollo.

Aprende más

Para más información sobre el ecosistema MCP, consulta:

Acerca de Hint Services

"El futuro ya está aquí, solo que está distribuido de manera desigual"

  • William Gibson, Autor

Hint Services es una consultoría boutique con la misión de desarrollar y expandir cómo las interfaces de usuario aprovechan la tecnología de inteligencia artificial. Arquitectamos ambición en la intersección de la IA y la Experiencia de Usuario, fundada y liderada por Ben Hofferber.

Ofrecemos talleres especializados de IA para equipos de diseño que buscan adoptar herramientas de IA sin convertirse en desarrolladores. Aprende más sobre nuestros entrenamientos y talleres.