← API per sviluppatori
Connettore MCP

Connettore Nonli per Claude e ChatGPT (MCP)

Nonli è una piattaforma di gestione dei social media per media e brand. Il connettore Nonli permette a un assistente IA come Claude o ChatGPT di lavorare con l’azienda a cui appartieni in Nonli, con i tuoi permessi Nonli, tramite il Model Context Protocol (MCP).

URL del server

url
1https://api.nonli.com/v2.1/mcp

Requisiti: Un account utente Nonli in un’azienda con un abbonamento Nonli.

Collegarsi da Claude (claude.ai, Claude Desktop, Claude mobile)

  1. 1In Claude, aggiungi un connettore personalizzato con l’URL https://api.nonli.com/v2.1/mcp. Lascia vuoti l’ID client e il secret client e non aggiungere alcun header. (Quando Nonli sarà nella directory dei connettori di Claude, potrai aggiungerlo anche da lì.)
  2. 2Nei piani Team ed Enterprise, un Owner dell’organizzazione aggiunge il connettore una sola volta, in Organization settings > Connectors; poi ogni membro si collega con il proprio account Nonli.
  3. 3Seleziona Connect: Claude apre la pagina di accesso di Nonli, poi una schermata di consenso che mostra l’azienda in cui agirà la connessione. Seleziona Allow.

Collegarsi da ChatGPT

  1. 1Crea un’app (connettore) per l’URL https://api.nonli.com/v2.1/mcp con autenticazione OAuth, lasciando vuote le credenziali client. Quali piani e ruoli del workspace possono farlo lo decidono OpenAI e le impostazioni del tuo workspace (modalità sviluppatore). (Quando Nonli sarà nella directory delle app di ChatGPT, potrai aggiungerlo anche da lì.)
  2. 2Accedi a Nonli e seleziona Allow nella schermata di consenso.

Altri client MCP (Claude Code, Cursor, …)

Usa lo stesso URL con OAuth quando il tuo client lo supporta. I client che inviano un header fisso possono usare un token API Nonli, inviato come Authorization: Bearer YOUR_API_TOKEN.

Creare un token APIRiferimento dell’API per sviluppatori

Cosa può fare l’assistente

L’assistente vede solo gli strumenti consentiti dai tuoi permessi Nonli.

StrumentoCosa fa
list_brandsElenca i brand della tua azienda.
list_social_accountsElenca gli account social collegati a Nonli.
search_postsCerca i tuoi post per testo, rete, account, stato o periodo.
get_postLegge un post con il suo contenuto e le sue statistiche.
get_post_statsFornisce le statistiche dei tuoi post, come copertura e coinvolgimento, su un periodo.
list_listening_accountsCerca gli account seguiti dal social listening.
create_postsCrea post sui tuoi account social.La creazione di post può inviarli in validazione, programmarli o pubblicarli sui tuoi account social quando il tuo ruolo lo consente. Claude e ChatGPT ti chiedono conferma prima di eseguirla.

Esempi di richieste

  • “Quali dei nostri post hanno avuto più coinvolgimento su Instagram la settimana scorsa?”
  • “Confronta la copertura dei nostri post su Facebook e Instagram negli ultimi 30 giorni.”
  • “Trova i nostri post sulle elezioni pubblicati questo mese.”
  • “Scrivi una bozza di post LinkedIn che annunci il nostro nuovo podcast e inviala in validazione.”

Permessi

  • La connessione agisce con i permessi dell’utente che l’ha approvata, nell’azienda mostrata nella schermata di consenso, e questi permessi vengono verificati di nuovo a ogni richiesta: un cambio di ruolo o un accesso revocato si applica alla chiamata successiva.
  • Una connessione non fa mai più di quanto l’utente possa fare in Nonli e non accede mai all’amministrazione dell’azienda.
  • Resta valida per 365 giorni, a meno che tu non la termini.

Terminare una connessione

  • In Nonli, in My Information > Connected applications. Lì ogni utente gestisce solo le proprie connessioni; non compaiono nella pagina dei token API dell’azienda.
  • Dopo la revoca, la richiesta successiva dell’assistente viene rifiutata e l’assistente propone di collegarsi di nuovo.

Dati e privacy

Il connettore riceve solo gli argomenti di ogni chiamata a uno strumento, mai la tua conversazione con l’assistente. I dati sono trattati secondo l’informativa sulla privacy di Nonli.

Informativa sulla privacy di Nonli

Assistenza

Scrivici per qualsiasi domanda sul connettore.

[email protected]Pagina di contatto