TrelloAI

Integrazione Trello + Cursor AI tramite Model Context Protocol (MCP). L'AI può leggere la board, capire lo stato dei task e gestirli secondo regole che definisci tu in RULES.md.

Setup rapido

1. Credenziali Trello

Trello ora richiede un Power-Up per generare le chiavi API (la vecchia pagina trello.com/app-key reindirizza al nuovo portale).

1. Vai su https://trello.com/power-ups/admin
2. Clicca Nuova app e crea un Power-Up (es. "TrelloAI")
   • Per l'URL connettore Iframe puoi usare un placeholder HTTPS qualsiasi (es. https://example.com) — non serve per l'integrazione MCP, serve solo a Trello per creare l'app
3. Apri il Power-Up → tab Chiave API → Genera una nuova chiave API
4. Copia la API Key
5. Clicca il link Token accanto alla chiave → Consenti → copia il Token

2. Configura l'ambiente

cp .env.example .env

Modifica .env:

TRELLO_API_KEY=la_tua_api_key
TRELLO_TOKEN=il_tuo_token
TRELLO_DEFAULT_BOARD_ID=id_della_board   # opzionale

Per trovare l'ID board: apri la board su Trello, l'URL contiene /b/SHORTLINK/BOARD_ID — usa BOARD_ID.

3. Installa dipendenze

npm install

4. Attiva MCP in Cursor

Il file .cursor/mcp.json è già configurato. Riavvia Cursor o ricarica la finestra (Developer: Reload Window).

Verifica in Cursor Settings → MCP che il server trello risulti connesso.

Uso

Prompt MCP integrati

Nella chat Cursor, puoi invocare i prompt del server:

• gestisci-trello — l'AI legge RULES.md, analizza la board e gestisce i task
• stato-trello — solo riepilogo, senza modifiche

Esempi di richieste

Fammi un riepilogo dei task in corso

Sposta in "Fatto" i task completati in review

Crea un task "Preparare demo" nel Backlog con scadenza venerdì

Quali task scadono questa settimana?

Personalizza le regole

Modifica RULES.md con le tue convenzioni: nomi liste, limiti WIP, priorità, etichette, quando chiedere conferma. L'AI le applica automaticamente.

Tool disponibili

Tool	Descrizione
trello_list_boards	Elenca le board
trello_get_board_overview	Panoramica completa
trello_list_cards	Card per board/lista
trello_get_card	Dettaglio card
trello_create_card	Crea task
trello_update_card	Aggiorna card
trello_move_card	Sposta tra liste
trello_add_comment	Aggiunge commento
trello_archive_card	Archivia card
trello_search	Cerca per testo
trello_get_board_activity	Attività recente
trello_get_labels	Etichette board

Struttura progetto

trelloAI/
├── .cursor/
│   ├── mcp.json              # Config MCP per Cursor
│   └── skills/trello/        # Skill agente
├── src/
│   ├── server.js             # Server MCP
│   └── trello-client.js      # Client API Trello
├── RULES.md                  # Le tue regole (modificabile)
├── .env.example
└── README.md

Troubleshooting

• Server MCP non connesso: verifica che npm install sia stato eseguito e che .env esista
• 401 Unauthorized: controlla API key e token
• Board non trovata: verifica TRELLO_DEFAULT_BOARD_ID o passa l'ID esplicitamente