Skip to main content
Glama

TrelloAI

Integrazione Trello + Cursor AI tramite Model Context Protocol (MCP), più bot Telegram iManager (Octorate, pulizie, turni). Le regole operative vivono in rules/ e si editano anche dalla UI Admin.

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/, 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 i file in rules/ (o usa la UI Admin) per Manutenzioni, Customer care, Pulizie, Interazione clienti. Config strutture/pesi/board in config/.

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
├── rules/                    # Policy iManager per area
├── config/                   # Strutture, pesi turni, board
├── src/
│   ├── server.js             # Server MCP
│   ├── telegram-bot.js       # Bot + HTTP admin
│   └── …
├── .env.example
└── README.md

Uso da cellulare (Telegram su Scaleway)

Il bot @manager_888_bot (iManager) 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

UI Admin (config iManager)

  1. Imposta ADMIN_TOKEN=... nel .env del server (npm run ship:env)

  2. Apri https://151-115-166-171.sslip.io/admin/

  3. Modifica regole markdown per area, strutture Octorate, pesi turni, board Trello

  4. I secret (API key) restano solo in .env — la UI mostra solo lo stato

Aree: Manutenzioni · Customer care · Pulizie · Interazione clienti (stub AIBridge).

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

Refresh token Octorate

Se il bot dice che Octorate non risponde / token scaduto:

  1. Admin UI → Integrazioni → Rinnova token (usa il refresh senza browser)

  2. Se fallisce → Ricollega (login OAuth) oppure apri /oauth/login

  3. In locale: npm run octorate-refresh e, per aggiornare Scaleway: npm run octorate-refresh -- --ship

Il Super Manager, in caso di 401, prova già un refresh forzato e riconnette MCP.

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

Available Tools

13 tools
trello_add_commentC

Aggiunge un commento a una card

Inputs: text (required), cardId (required).

trello_archive_cardC

Archivia (chiude) una card

Inputs: cardId (required).

trello_create_cardB

Crea una nuova card in una lista

Inputs: name (required), idList (required), due, desc, +1 more.

trello_get_board_activityA
Read-only

Attività recente su una board (creazioni, spostamenti, commenti)

Inputs: boardId (required), limit.

trello_get_board_overviewA
Read-only

Panoramica completa di una board: liste, card, scadenze e link

Inputs: boardId.

trello_get_cardA
Read-only

Dettaglio completo di una card: descrizione, commenti, checklist, membri

Inputs: cardId (required).

trello_get_labelsB
Read-only

Elenca le etichette disponibili su una board

Inputs: boardId (required).

trello_list_boardsA
Read-only

Elenca tutte le board Trello aperte dell'utente

Inputs: no named parameters.

trello_list_cardsB
Read-only

Elenca le card di una board o di una lista

Inputs: filter, listId, boardId.

trello_list_listsA
Read-only

Elenca le liste di una board Trello

Inputs: boardId (required).

trello_move_cardB

Sposta una card in un'altra lista

Inputs: cardId (required), idList (required).

trello_update_cardC

Aggiorna una card esistente (nome, descrizione, scadenza, lista)

Inputs: cardId (required), due, desc, name, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 13 tools

    Disambiguation5/5

    Each tool targets a distinct Trello resource (board, list, card, label, activity) with specific actions, making them clearly distinguishable without overlap.

    Naming Consistency5/5

    All tools use the 'trello_' prefix followed by a consistent verb_noun pattern (e.g., list_boards, create_card, get_card), ensuring predictability.

    Tool Count5/5

    With 13 tools, the server provides a well-scoped set for Trello operations, covering essential CRUD and query actions without being excessive or sparse.

    Completeness5/5

    The tool set covers the full lifecycle for cards (create, read, update, move, archive, search, comment) and provides board/list overviews, labels, and activity—missing only rare operations like creating lists or deleting, which are non-critical.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers