Servidor MCP de Trello

Un servidor del Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para obtener e interactuar con tableros, listas y tarjetas de Trello.

Características

• Obtener todos los tableros del usuario autenticado

• Obtener detalles de un tablero

• Obtener listas de un tablero

• Obtener tarjetas de tableros o listas

• Obtener detalles específicos de una tarjeta

• Buscar tarjetas en todos los tableros

• Obtener acciones/historial de una tarjeta

Related MCP server: Trello MCP Server

Configuración

1. Obtener credenciales de la API de Trello

Importante: Necesitas crear un Power-Up para obtener las credenciales de la API.

1. Visita https://trello.com/power-ups/admin

2. Haz clic en "Create New Power-Up" (o en el botón "Crear")

3. Rellena la información básica:

   • Nombre: "Trello MCP" (o cualquier nombre que prefieras)

   • Espacio de trabajo: Selecciona tu espacio de trabajo

4. Una vez creado, ve a la sección "API Key" en la configuración de tu Power-Up

5. Verás tu API Key (una cadena de 32 caracteres)

6. Haz clic en el enlace "Token" (o "token" en la descripción) para generar tu token de API

7. Autoriza el token cuando se te solicite

8. Copia tanto la API key como el API token

Alternativamente, puedes ir directamente a https://trello.com/app-key si ya tienes un Power-Up creado.

2. Instalar dependencias

npm install

3. Configurar variables de entorno

Copia el archivo de entorno de ejemplo y añade tus credenciales:

cp .env.example .env

Edita .env y añade tus credenciales:

TRELLO_API_KEY=your_actual_api_key
TRELLO_API_TOKEN=your_actual_api_token

4. Probar el servidor

Ejecuta el servidor directamente:

npm start

Configuración

Puedes configurar este servidor MCP globalmente en Claude Desktop o por proyecto en la CLI de Claude Code.

Opción 1: Configuración global (Claude Desktop)

Edita tu archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Añade la siguiente configuración:

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/absolute/path/to/trello-mcp/index.js"],
      "env": {
        "TRELLO_API_KEY": "your_api_key_here",
        "TRELLO_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Reemplaza /absolute/path/to/trello-mcp/ con la ruta real a este directorio.

Después de añadir la configuración, reinicia Claude Desktop.

Opción 2: Configuración por proyecto (CLI de Claude Code)

Para la CLI de Claude Code, los servidores MCP se configuran por proyecto en ~/.claude.json.

Importante: Debes incluir el campo type: "stdio" y las variables env directamente en la configuración. El archivo .env no se cargará automáticamente.

Usa este comando para configurar un proyecto específico:

# Using jq to add the configuration
jq '.projects."/path/to/your/project".mcpServers.trello = {
  "type": "stdio",
  "command": "node",
  "args": ["/Users/ehigu/Documents/Esteban/Projects/habitus/webapp/trello-mcp/index.js"],
  "env": {
    "TRELLO_API_KEY": "your_api_key_here",
    "TRELLO_API_TOKEN": "your_api_token_here"
  }
}' ~/.claude.json > /tmp/claude_config.json && mv /tmp/claude_config.json ~/.claude.json

O edita manualmente ~/.claude.json:

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "trello": {
          "type": "stdio",
          "command": "node",
          "args": ["/Users/ehigu/Documents/Esteban/Projects/habitus/webapp/trello-mcp/index.js"],
          "env": {
            "TRELLO_API_KEY": "your_api_key_here",
            "TRELLO_API_TOKEN": "your_api_token_here"
          }
        }
      }
    }
  }
}

Después de añadir la configuración, reinicia Claude Code.

Herramientas disponibles

get_my_boards

Obtiene todos los tableros del usuario autenticado.

Parámetros:

• filter (opcional): Filtra los tableros por tipo (all, open, closed, starred, organization, public, members). Predeterminado: "open"

get_board

Obtiene los detalles de un tablero específico.

Parámetros:

• board_id (obligatorio): El ID del tablero

get_board_lists

Obtiene todas las listas de un tablero.

Parámetros:

• board_id (obligatorio): El ID del tablero

• filter (opcional): Filtra las listas (all, open, closed, none). Predeterminado: "open"

get_board_cards

Obtiene todas las tarjetas de un tablero.

Parámetros:

• board_id (obligatorio): El ID del tablero

get_list_cards

Obtiene todas las tarjetas de una lista específica.

Parámetros:

• list_id (obligatorio): El ID de la lista

get_card

Obtiene los detalles de una tarjeta específica.

Parámetros:

• card_id (obligatorio): El ID de la tarjeta

search_cards

Busca tarjetas en todos los tableros.

Parámetros:

• query (obligatorio): Consulta de búsqueda

• board_ids (opcional): IDs de tableros separados por comas para buscar dentro de ellos

get_card_actions

Obtiene las acciones (actividad/historial) de una tarjeta específica.

Parámetros:

• card_id (obligatorio): El ID de la tarjeta

Ejemplos de uso

Una vez configurado en Claude Desktop, puedes usar lenguaje natural para interactuar con tus tableros de Trello:

• "Muéstrame todos mis tableros de Trello abiertos"

• "Obtén las tarjetas del tablero [board_id]"

• "Busca tarjetas que contengan 'bug fix'"

• "Muéstrame los detalles de la tarjeta [card_id]"

• "¿Cuáles son las listas en mi tablero?"

Solución de problemas

Errores de autenticación

Si ves errores de autenticación:

1. Verifica que tu API key y token sean correctos

2. Asegúrate de que el token no haya caducado

3. Regenera el token si es necesario desde https://trello.com/app-key

El servidor no inicia

1. Comprueba que Node.js esté instalado: node --version

2. Asegúrate de que las dependencias estén instaladas: npm install

3. Verifica que las variables de entorno estén configuradas correctamente

El servidor MCP muestra el estado "Failed"

Si el servidor MCP aparece como "failed" en Claude Code:

1. Campo type faltante: Asegúrate de que tu configuración incluya "type": "stdio". Esto es obligatorio para la CLI de Claude Code.

2. Variables de entorno no cargadas: El archivo .env NO se carga automáticamente cuando Claude Code ejecuta el servidor MCP. Debes incluir el objeto env con tus credenciales de API directamente en la configuración:

   {
     "type": "stdio",
     "command": "node",
     "args": ["/path/to/trello-mcp/index.js"],
     "env": {
       "TRELLO_API_KEY": "your_api_key",
       "TRELLO_API_TOKEN": "your_api_token"
     }
   }

3. Revisa los registros: Ejecuta claude --debug para ver registros de error detallados

4. Prueba manualmente: Ejecuta el servidor directamente para verificar que funciona:

   cd /path/to/trello-mcp
   TRELLO_API_KEY=your_key TRELLO_API_TOKEN=your_token node index.js

5. Reinicia Claude Code: Después de realizar cambios en la configuración, cierra y reinicia Claude Code por completo

El servidor MCP no aparece en Claude

1. Comprueba que la ruta en tu configuración sea absoluta y correcta

2. Reinicia Claude Desktop/Code por completo

3. Revisa los registros de Claude Desktop en busca de errores

4. Para la CLI de Claude Code, verifica que la configuración esté en la ruta del proyecto correcta en ~/.claude.json

Licencia

MIT