Server MCP

Il server MCP di DragApp mette a disposizione 47 strumenti in 12 categorie, che danno a qualsiasi client IA compatibile con MCP accesso completo a bacheche, email, schede, contatti, knowledge base, analisi e automazioni.

Collegati in due modi: incolla l'URL dell'endpoint ospitato nelle impostazioni dei connettori del tuo client IA (la via più rapida, senza installazione), oppure esegui il server open source in locale da un file di configurazione. Stessi strumenti, stessi permessi, in entrambi i casi.

Basato sullo standard Model Context Protocol (MCP). Open source, con licenza MIT.


Collega (endpoint ospitato)

Il modo più rapido per collegarti è l'endpoint ospitato. Tre passaggi, circa due minuti. Nessun file di configurazione, nessuna installazione locale, nessun riavvio.

  1. Aggiungi il connettore. Nelle impostazioni dei connettori del tuo client IA (in Claude: Impostazioni › Connettori › Aggiungi connettore personalizzato), incolla questo URL e salva:
    URL del connettore
    https://app.dragapp.com/mcp
  2. Fai clic su Connect. Nel browser si apre una pagina di collegamento di Drag che ti chiede la chiave API di DragApp.
  3. Inserisci la tua chiave API. Copiala da DragApp in Impostazioni › Integrazioni, incollala nella pagina di collegamento e invia. Drag verifica la chiave e la passa al tuo client come token di accesso. Il collegamento è attivo.

Per verificare, chiedi al tuo client: "elenca le bacheche nel mio DragApp". La prima volta che usa ciascuno strumento ti chiede il permesso, così controlli esattamente cosa può fare.

La chiave si inserisce una sola volta, solo nella pagina di connessione. Non compare mai in un indirizzo web, e il servizio MCP non memorizza nulla sui propri server.

Dietro le quinte si tratta di un flusso di autorizzazione OAuth 2.1 standard con codice di autorizzazione, PKCE e registrazione dinamica del client, servito tramite il trasporto Streamable HTTP di MCP, quindi qualsiasi client che supporti i connettori MCP remoti può collegarsi.


Installazione (percorso locale)

Preferisci eseguire il server in autonomia o usi un client con file di configurazione come Cursor, Windsurf o Claude Code? Il pacchetto npm resta pienamente supportato. Eseguilo direttamente con npx, senza installare nulla:

Terminale
npx -y @dragapp/mcp-server

Oppure installalo globalmente:

Terminale
npm install -g @dragapp/mcp-server

Autenticazione

Entrambe le modalità si autenticano con la tua chiave API di DragApp, e in ogni caso la connessione eredita i tuoi permessi Drag esistenti. Sull'endpoint ospitato, inserisci la chiave una sola volta nella pagina di connessione sicura e diventa il token di accesso del tuo client; il servizio MCP non memorizza nulla. Con la modalità locale, il server legge la chiave dalla variabile d'ambiente DRAG_API_KEY.

Ottieni la tua chiave API in Impostazioni › Integrazioni, dentro Drag. Puoi revocarla lì in qualsiasi momento.

La tua chiave API dà pieno accesso al tuo workspace DragApp. Tienila segreta e non inserirla mai in un commit del controllo di versione.


Configurazione del client

Aggiungi il seguente JSON al file di configurazione MCP del tuo client IA:

Configurazione MCP
{
  "mcpServers": {
    "dragapp": {
      "command": "npx",
      "args": ["-y", "@dragapp/mcp-server"],
      "env": {
        "DRAG_API_KEY": "your-api-key"
      }
    }
  }
}

Percorsi del file di configurazione

ClientPercorso di configurazione
Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json
Cursor.cursor/mcp.json
Windsurf~/.codeium/windsurf/mcp_config.json
Claude Code~/.claude.json o .mcp.json

Riferimento degli strumenti

47 strumenti in 12 categorie. Ogni strumento è disponibile automaticamente per qualsiasi client MCP collegato.

Email

8
StrumentoDescrizione
list_threadsElenca i thread email in una colonna specifica di una bacheca
get_threadRecupera un singolo messaggio email con il corpo HTML completo
reply_to_threadRispondi a un thread email esistente
send_new_emailInvia una nuova email da una bacheca
search_threadsCerca thread in tutte le bacheche
filter_threadsFiltra le conversazioni per etichetta, assegnatario o stato
move_threadSposta un thread in un'altra colonna
move_threads_bulkSposta più thread contemporaneamente

Bacheche

5
StrumentoDescrizione
list_boardsElenca tutte le bacheche a cui ha accesso l'utente autenticato
get_boardRecupera i dettagli di una bacheca specifica
list_columnsElenca tutte le colonne di una bacheca
list_board_membersElenca tutti i membri di una bacheca
list_teamsElenca tutti i team dello spazio di lavoro

Schede

6
StrumentoDescrizione
list_cards_in_columnElenca tutte le schede di una colonna specifica
get_cardRecupera i dettagli di una scheda specifica
create_cardCrea una nuova scheda in una colonna
update_cardAggiorna le proprietà della scheda (titolo, descrizione, assegnatario, scadenza)
move_cardSposta una scheda in un'altra colonna o posizione
archive_cardArchivia una scheda

Etichette

4
StrumentoDescrizione
list_labelsElenca tutte le etichette disponibili su una bacheca
add_label_to_threadAggiungi un’etichetta a un thread email
remove_label_from_threadRimuovi un'etichetta da un thread email
toggle_labelsMostra o nascondi le etichette su una bacheca

Commenti

2
StrumentoDescrizione
add_commentAggiungi un commento interno a una scheda o a un thread
get_commentRecupera i dettagli di un commento specifico

Etichette

2
StrumentoDescrizione
list_tagsElenca tutte le etichette dello spazio di lavoro
add_tag_to_cardAggiungi un’etichetta a una scheda

Attività

1
StrumentoDescrizione
create_taskCrea un'attività (voce di checklist) in una scheda

Contatti

3
StrumentoDescrizione
search_contactsCerca contatti per nome o indirizzo email
get_contact_conversationsRecupera tutte le conversazioni con un contatto specifico
create_contactCrea un nuovo contatto nello spazio di lavoro

Knowledge base

5
StrumentoDescrizione
list_articlesElenca tutti gli articoli della knowledge base
get_articleRecupera il contenuto completo di un articolo della knowledge base
create_articleCrea un nuovo articolo della knowledge base
update_articleAggiorna un articolo esistente della knowledge base
search_knowledgeCerca nella knowledge base tramite query

Analisi

4
StrumentoDescrizione
get_response_timesRecupera le metriche sui tempi di risposta di una bacheca
get_avg_response_timeRecupera il tempo medio di risposta tra le bacheche
get_daily_activityRecupera le metriche di attività giornaliera (conversazioni create, con risposta, risolte)
get_closed_activityRecupera le metriche sulle conversazioni chiuse/risolte

Automazioni

3
StrumentoDescrizione
list_automationsElenca tutte le automazioni configurate su una bacheca
toggle_automationAttiva o disattiva un'automazione specifica
toggle_ai_draftsAttiva o disattiva la generazione di bozze con IA su una bacheca

WhatsApp

4
StrumentoDescrizione
get_whatsapp_conversationRecupera la cronologia completa dei messaggi di una conversazione WhatsApp (scheda) su una bacheca WhatsApp. Restituisce i messaggi della chat in ordine. Usa il cardId restituito da list_threads / search_threads su una bacheca WhatsApp (il campo `cardId`).
list_whatsapp_templatesElenca i modelli di messaggio WhatsApp pre-approvati disponibili su una bacheca WhatsApp. Restituisce per ogni modello nome, lingua, stato, categoria, testo del corpo e quante variabili {{n}} richiede. Si possono inviare solo i modelli APPROVED.
send_whatsapp_messageInvia un messaggio WhatsApp a testo libero in una conversazione esistente. Nota: WhatsApp consente i messaggi a testo libero solo entro la finestra di assistenza clienti di 24 ore; al di fuori, usa send_whatsapp_template.
send_whatsapp_templateInvia un messaggio con un modello WhatsApp pre-approvato in una conversazione. Usalo per contattare qualcuno fuori dalla finestra di 24 ore. Chiama prima list_whatsapp_templates per ottenere il nome e la lingua esatti del modello e per vedere quante variabili {{n}} richiede.

Esempi

Prompt in linguaggio naturale e gli strumenti che il client IA chiamerà dietro le quinte.

“Mostrami le email non lette nella bacheca Assistenza”

list_boards → list_columns → list_threads

Il client IA trova la bacheca Assistenza, individua la colonna giusta ed elenca i thread con oggetto, mittente e data e ora.

“Rispondi all'ultima email di Giulia”

search_threads → get_thread → reply_to_thread

Cerca in tutte le bacheche i thread di Giulia, recupera il messaggio completo, poi scrive e invia una risposta.

“Qual è il nostro tempo medio di risposta questa settimana?”

get_avg_response_time

Richiama direttamente lo strumento di analisi per restituire il tempo medio di risposta con il confronto tra periodi.

“Crea una scheda nella bacheca Sprint con questa segnalazione di bug”

list_boards → list_columns → create_card

Trova la bacheca Sprint, individua la colonna giusta (ad es. Backlog) e crea una scheda con i dettagli del bug.

“Assegna a Giulia tutte le conversazioni relative alla fatturazione”

filter_threads → move_threads_bulk

Filtra le conversazioni con l'etichetta FATTURAZIONE, poi le sposta in blocco nella colonna assegnata a Giulia.

“Cerca nella nostra knowledge base la politica di rimborso”

search_knowledge

Cerca nella knowledge base e restituisce gli articoli corrispondenti con degli estratti.


Sviluppo

Clona il repository ed eseguilo in locale:

Terminale
git clone https://github.com/nick-timms/drag-mcp-server.git
cd drag-mcp-server
npm install
npm run build
DRAG_API_KEY=your-key node dist/index.js

Per lo sviluppo con ricompilazione automatica:

Terminale
npm run dev

Serve aiuto?

Centro assistenza: guide e tutorial

support@dragapp.com: assistenza via email

Issue su GitHub: segnalazioni di bug e richieste di funzionalità