Collega le app IA (MCP)

Il MonoChat MCP Server permette a un'app IA che supporta il Model Context Protocol (MCP), come Claude Code o Cursor, di lavorare con il tuo account MonoChat. L'app IA chiede dati a MonoChat tramite un insieme fisso di strumenti; può vedere solo ciò che vedi tu.

Il MonoChat MCP Server è disponibile in ogni piano, senza limiti in base al piano.

Una connessione agisce come te

Un'app IA collegata con la tua chiave di accesso agisce come il tuo utente. Raggiunge i tenant a cui hai accesso e nient'altro. Revoca le connessioni che non usi più.

Cosa può fare l'app IA

Questi strumenti sono disponibili per ogni connessione:

Strumento	Cosa fa
list_tenants	Elenca i tenant a cui la connessione può accedere.
list_sessions	Elenca le sessioni di conversazione di un tenant, dalla più recente, facoltativamente solo quelle opened, assigned o closed.
get_session	Restituisce una sessione di conversazione.
list_messages	Elenca i messaggi di una sessione, dal più recente.
search_customers	Cerca i clienti di un tenant per parola chiave.
list_message_templates	Elenca i modelli di messaggio di un canale di un tenant.

Il testo dei messaggi proviene da clienti e agenti. È un dato che l'app IA legge, non un'istruzione.

Una connessione ha un ambito, Sola lettura o Lettura e scrittura. Una connessione in sola lettura non vede mai gli strumenti che modificano i dati. Tutti gli strumenti elencati sopra si limitano a leggere.

Crea una connessione

Una connessione appartiene al tuo account, non a un tenant. Devi prima configurare la verifica in due passaggi (via e-mail o con un'app di autenticazione).

1. Apri le impostazioni del profilo, seleziona la scheda Connessioni MCP e fai clic su Crea.
2. Inserisci un nome, scegli l'ambito (Sola lettura per impostazione predefinita) e la scadenza in giorni (90 per impostazione predefinita, massimo 365).
3. Inserisci il codice di conferma a 6 cifre del tuo metodo di verifica in due passaggi. Se usi la verifica via e-mail, fai prima clic su Invia codice di conferma.
4. Copia la chiave di accesso. Viene mostrata una sola volta; inizia con mcp_sk_.

Puoi avere fino a 10 connessioni attive.

Collega un'app IA

Il server si trova all'indirizzo https://app.monochat.ai/api/mcp-server (usa il tuo indirizzo MonoChat se esegui MonoChat sui tuoi server) e si aspetta la chiave di accesso come bearer token nell'header Authorization.

Claude Code

claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
  --header "Authorization: Bearer <access key>"

Cursor

Aggiungi il server a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "monochat": {
      "url": "https://app.monochat.ai/api/mcp-server",
      "headers": { "Authorization": "Bearer <access key>" }
    }
  }
}

Qualsiasi altro client MCP che supporti il trasporto HTTP streamable e gli header personalizzati si collega allo stesso modo.

Limiti

Le chiamate vengono contate al minuto: 60 per connessione, 300 per account e 600 per tenant, e al massimo 4 chiamate contemporanee per connessione. Alcuni strumenti contano come più di una chiamata. Quando si raggiunge un limite, il server risponde con lo stato 429 e un header Retry-After; l'app IA deve attendere quel numero di secondi.

Revoca una connessione

Ogni connessione nella scheda Connessioni MCP mostra stato, ambito, scadenza e ultimo utilizzo. Fai clic su Revoca per interrompere subito l'accesso dell'app IA. Una connessione revocata o scaduta non può essere riutilizzata; creane una nuova.

Gestire l'accesso MCP di un'organizzazione

Gli utenti che possono modificare le impostazioni di un'organizzazione ne gestiscono l'accesso MCP in Impostazioni › Organizzazione › Server MCP.

• Disattiva l'accesso MCP per questa organizzazione: attivalo e fai clic su Salva per rifiutare ogni chiamata MCP verso questa organizzazione, da ogni connessione di ogni utente. L'organizzazione non compare più in list_tenants. Disattivalo e salva per consentire di nuovo l'accesso MCP.
• Chiamate MCP: ogni chiamata a uno strumento che indica questa organizzazione, dalla più recente, comprese quelle rifiutate. Ogni riga mostra l'utente, la connessione, lo strumento, lo stato (Operazione riuscita o Non riuscito), l'indirizzo IP e l'ora. Le chiamate degli utenti che non sono membri di questa organizzazione non vengono mostrate.