> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/avanzate/integrazioni/model-context-protocol-mcp-su-aisuru/mcp-di-aisuru-quali-sono-e-come-si-attivano/11.-monday.com-mcp-server.md).

# 11. Monday.com MCP Server

Monday.com funziona come una lavagna in cui i team organizzano il proprio lavoro, le attività, i progetti, le scadenze e le responsabilità.

Questo MCP agisce come un **assistente** che si connette direttamente allo spazio di lavoro Monday dell'utente e gli consente di interagire con esso usando un **linguaggio semplice e quotidiano.** Ciò significa che l'utente può semplicemente *parlare* o *digitare* le proprie richieste tramite la chat, invece di usare manualmente l'app.

Questo MCP è utile per:

* Creare e aggiornare attività in Monday;
* Recuperare informazioni sui progetti;
* Automatizzare la gestione del lavoro.

## Parametri di configurazione

| Parametro        | Obbligatorio | Descrizione                                                                                                          |
| ---------------- | ------------ | -------------------------------------------------------------------------------------------------------------------- |
| `workspace_name` | No           | Nome dello spazio di lavoro Monday.com, utilizzato nelle istruzioni dell'Agente.                                     |
| `api_key`        | Sì           | La tua chiave API di Monday.com, utilizzata per autenticarti con il tuo account.                                     |
| `token_param`    | No           | Nome dell'opzione utilizzata per passare la chiave API (predefinito: `--token`). Raramente è necessario modificarla. |

### Parametri personalizzati

* **apiVersion**: Versione API da utilizzare;
* **timeout**: Tempo massimo della richiesta (secondi);
* **retries**: Tentativi in caso di errore.
* **maxQueries**: Limite di complessità delle query GraphQL;
* **resetInterval**: Intervallo di reimpostazione del limite di complessità (secondi).

```json
{
  "apiVersion": "2024-01",
  "timeout": 60,
  "retries": 3,
  "complexity": {
    "maxQueries": 100,
    "resetInterval": 60
  }
}
```

## Come ottenere i parametri <a href="#f09f9491-come-ottenere-i-parametri-4" id="f09f9491-come-ottenere-i-parametri-4"></a>

1. **Dopo esserti registrato** e aver effettuato l'accesso a Monday;
2. **Nome dello spazio di lavoro**:
   * Guarda nella barra laterale sinistra;
   * Vedrai il nome dello spazio di lavoro corrente (ad esempio, "Main Workspace", "Marketing Team");
   * Usa quel nome esatto.
3. **Chiave API** (token API):
   * Fai clic sulla tua **foto del profilo** (in basso a sinistra);
   * Seleziona **Admin** (se sei un amministratore) oppure **Developers;**
   * Nel menu laterale, vai a **Developers** → **API Token;**
   * Oppure vai direttamente a:<https://monday.com/admin/integrations/api>
   * Nella sezione **"API Token"**:
     * Fai clic su **"Generate"** per creare un nuovo token;
     * Oppure su **"Show"** per visualizzarne uno esistente;
   * Copia il token (spesso inizia con `eyJ...`, salvalo in modo sicuro!).
4. **Parametro del token**: il valore predefinito è --token, raramente deve essere modificato;
5. **Trovare l'ID dello spazio di lavoro**:
   1. URL:`https://mycompany.monday.com/workspaces/12345678`
   2. L'ID è`12345678`
6. **ID della bacheca** (come riferimento):
   1. URL:`https://mycompany.monday.com/boards/123456789`
   2. L'ID è`123456789`

### Sicurezza del token API <a href="#f0-9f-94-92-sicurezza-api-token" id="f0-9f-94-92-sicurezza-api-token"></a>

* Il token API dispone di **le stesse autorizzazioni** dell'utente che lo ha generato;
* Può accedere a tutte le bacheche e agli spazi di lavoro di quell'utente;
* Non condividere mai pubblicamente il token;
* Ruota periodicamente il token per motivi di sicurezza.