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.

Related MCP server: Trello MCP Server

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

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

Uso da cellulare (Telegram su Scaleway)

Il bot @manager_888_bot (Super Manager) gira su Scaleway. In gruppo rispondi solo se taggato @manager_888_bot (il nome visualizzato non basta) oppure in reply a un suo messaggio. In privato risponde sempre.

Programmi in locale; sync immediato senza GitHub.

npm run ship:watch

Poi testi su Telegram. Commit/push su GitHub solo quando la versione è ok.

Server attuale: 151.115.166.171 (Milano) → https://151-115-166-171.sslip.io
Dettagli: deploy/README.md

OAuth Octorate (una tantum)

1. In Octorate → Settings → Advanced → API aggiungi il redirect: https://151-115-166-171.sslip.io/oauth/callback

2. Apri https://151-115-166-171.sslip.io/oauth/login e autorizza

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

• Octorate No identity: apri /oauth/login sul server dopo aver autorizzato il redirect in Octorate