> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Collegare altri strumenti

> Usa i tuoi strumenti preferiti tramite i loro server MCP

Se lo strumento con cui lavori non è nell'[elenco delle integrazioni](/docs/it/integrations/overview), spesso puoi collegarlo da solo. Molte app offrono un proprio server [MCP](https://modelcontextprotocol.io): Linear, Notion, Sentry, Supabase, PostHog, Zapier e centinaia di altri. Collegali in Macaly e l'agente potrà usarli mentre costruisce i tuoi progetti, per esempio leggere attività da Linear, prendere contenuti da Notion o controllare errori in Sentry.

<Callout icon="user">
  Disponibile in tutti i piani
</Callout>

I server collegati sono personali: li usano solo le tue chat. Gli altri membri del workspace collegano i propri.

## Aggiungere un server

Apri **Impostazioni → Server MCP** e fai clic su **Aggiungi server**.

Il modo più rapido è scegliere da **Server popolari**. L'elenco contiene oltre quaranta server già pronti, filtrati per categoria: **Sviluppo**, **Produttività**, **Contenuti**, **Dati e IA**, **Commercio**, **Analisi** e **Comunicazione**. Scegline uno e l'indirizzo e il metodo di accesso vengono compilati per te.

Per qualsiasi altro server, scegli **Avanzate** e compila:

* **Nome**: come compare il server nel tuo elenco, per esempio "Il mio Linear".
* **URL del server**: l'indirizzo del server.
* **Trasporto**: **Streamable HTTP** per i server attuali. Scegli **SSE (legacy)** solo se la documentazione del server lo richiede.
* **Autenticazione**: **OAuth (accedi)** se il server ti fa accedere dal browser, oppure **Header API** se si aspetta una chiave. Gli header sono facoltativi e vengono inviati con ogni richiesta, per esempio `Authorization: Bearer …`.

Fai clic su **Prova connessione**. Macaly si collega al server e mostra quanti strumenti ha trovato. Con OAuth si apre prima una finestra di accesso. Se non compare nulla, consenti i popup per macaly.com. Poi fai clic su **Salva modifiche**.

<Note>
  I valori degli header vengono salvati in modo che Macaly non li mostri mai più. Per cambiarli, aggiungi nuove righe, oppure lascia i campi vuoti per mantenere quelli salvati.
</Note>

## Scegliere quali strumenti può usare l'agente

Dopo la prima connessione riuscita, gli strumenti del server compaiono sotto di esso, raggruppati in **Strumenti di sola lettura**, **Strumenti di scrittura** e **Strumenti distruttivi**. Ogni strumento ha il proprio interruttore, mentre **Attiva tutti** e **Disattiva tutti** valgono per l'intero server.

Per iniziare consigliamo di lasciare attivi solo gli strumenti di sola lettura. Attiva quelli di scrittura o distruttivi quando vuoi che l'agente modifichi qualcosa in quel servizio. L'agente vede solo gli strumenti che hai attivato.

## Stato del server

Ogni server mostra il proprio stato:

* **Connesso**: pronto all'uso.
* **Accesso richiesto**: la sessione OAuth è scaduta o non è mai stata completata. Fai clic su **Riprova** e accedi. Gli strumenti restano nascosti finché non completi l'accesso.
* **Non raggiungibile**: il server non ha risposto all'ultimo tentativo di Macaly. **Ultimo errore** mostra che cosa è andato storto e **Riprova** fa un nuovo tentativo.

Usa l'interruttore **Attivo** per nascondere temporaneamente un server all'agente senza eliminarlo. **Disconnetti** cancella un accesso salvato ed **Elimina server** rimuove il server e le sue credenziali.

## Usare un server collegato

Il modo in cui lavori con l'agente non cambia. Nomina lo strumento e quello che ti serve: l'agente sceglie da solo lo strumento MCP giusto.

**Esempi di prompt:**

```
Trova le issue aperte nel mio progetto Linear "Rilancio del sito"
e crea una pagina di roadmap pubblica che le elenchi per stato.
```

```
Prendi la pagina "Team" dal nostro workspace Notion e trasformala in
una pagina Chi siamo con una scheda per ogni persona.
```

```
Controlla in Sentry gli errori della pagina di checkout dell'ultima
settimana e correggi quello più frequente.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.