Strumenti MCP — Panoramica

Diritti di accesso

Gli strumenti MCP sono assegnati a tre livelli di ambito:

Ambito	Significato
`read`	Solo accesso in lettura; nessuna possibilità di creare, modificare o eliminare
`write`	Lettura e scrittura di sorgenti, canali, Inbox; nessun accesso alle impostazioni del team
`admin`	Accesso completo a MCP, comprese le impostazioni del team

Nelle connessioni OAuth, l’ambito selezionato durante l’autorizzazione limita gli strumenti accessibili. Nei token API, il ruolo del token determina il livello massimo di accesso.

Strumenti di lettura

Tutti gli strumenti di lettura richiedono almeno l’ambito read.

`search_updates`

Cerca negli aggiornamenti in base a parole chiave, fonti, tag e periodo di tempo.

Ambito richiesto: read

Parametro	Tipo	Descrizione
`query`	Stringa	Termine di ricerca full-text (facoltativo)
`source_id`	Stringa	Aggiornamenti di una determinata fonte (facoltativo)
`tags`	Array	Tag degli aggiornamenti in base ai quali filtrare (facoltativo)
`folder`	Stringa	`inbox`, `saved` o `dropped` (facoltativo)
`source_ownership`	Stringa	`all` (impostazione predefinita), `own` (solo fonti proprie) o `competitor` (solo fonti esterne)
`limit`	Intero	Numero di risultati (predefinito: 20, max: 100)

Il filtro source_ownership utilizza il campo is_own presente nella fonte. È l’equivalente del filtro di proprietà nell’interfaccia utente dell’Inbox e consente all’assistente IA di considerare in modo mirato solo la propria presenza o solo quella dei concorrenti.

`get_update_details`

Restituisce il contenuto completo di un singolo aggiornamento.

Ambito richiesto: read

Parametro	Tipo	Descrizione
`update_id`	Stringa	ID dell’aggiornamento

`list_sources`

Elenca tutte le fonti dell’area di lavoro.

Ambito richiesto: read

Parametro	Tipo	Descrizione
`is_own`	Booleano	`true` = solo fonti proprie, `false` = solo concorrenti, omesso = tutte

Ogni fonte restituita contiene il campo is_own, in modo che gli assistenti IA possano distinguere la propria presenza da quella dei concorrenti senza dover effettuare una seconda richiesta.

`list_reports`

Elenca i report di IA disponibili.

Ambito richiesto: read

Parametro	Tipo	Descrizione
`type`	Stringa	`summary`, `feedback`, `list`, `linkedin_post`, `conversation_starters` (opzionale)
`limit`	Intero	Numero (predefinito: 10)

`get_report`

Restituisce il contenuto completo di un report.

Ambito richiesto: read

Parametro	Tipo	Descrizione
`report_id`	Stringa	ID del report

`get_team_context`

Restituisce il contesto IA dell’area di lavoro: metadati del team (nome, lingua, fuso orario), URL del sito web, documenti di contesto e configurazione della proprietà.

Ambito richiesto: read

Nessun parametro obbligatorio.

La risposta contiene nel blocco context:

website_url – URL dell’organizzazione memorizzato
is_own_sources_configured – true, non appena almeno una fonte è contrassegnata come propria
own_sources_count – numero di fonti proprie

Gli assistenti IA devono proporre confronti Voice Share o Momentum solo se is_own_sources_configured è uguale a true — altrimenti manca la base di confronto.

`list_tags`

Elenca tutti i tag dell’area di lavoro.

Ambito richiesto: read

Parametro	Tipo	Descrizione
`type`	Stringa	`sources`, `channels`, `updates` (opzionale)

Strumenti di scrittura

Tutti gli strumenti di scrittura richiedono almeno l’ambito write.

`create_source`

Crea una nuova fonte.

Scope richiesto: write

Parametro	Tipo	Descrizione
`url`	Stringa	URL del sito web della fonte
`name`	Stringa	Nome interno
`tags`	Array	ID dei tag (opzionale)

`update_source`

Modifica il nome, l’URL o i tag di una fonte esistente.

Ambito richiesto: write

Parametro	Tipo	Descrizione
`source_id`	Stringa	ID della fonte
`name`	Stringa	Nuovo nome (facoltativo)
`url`	Stringa	Nuovo URL (facoltativo)

`delete_source`

Elimina una fonte, inclusi tutti i canali e gli aggiornamenti.

Ambito richiesto: write

Parametro	Tipo	Descrizione
`source_id`	Stringa	ID della fonte

`create_channel`

Crea manualmente un canale.

Ambito richiesto: write

Parametro	Tipo	Descrizione
`source_id`	Stringa	ID della fonte di livello superiore
`url`	Stringa	URL del canale
`name`	Stringa	Nome del canale (facoltativo)

`update_channel`

Modifica il nome o la descrizione di un canale.

Ambito richiesto: write

Parametro	Tipo	Descrizione
`channel_id`	Stringa	ID del canale
`name`	Stringa	Nuovo nome (facoltativo)

`delete_channel`

Elimina un canale.

Ambito richiesto: write

Parametro	Tipo	Descrizione
`channel_id`	Stringa	ID del canale

`toggle_channel`

Attiva o disattiva un canale.

Ambito richiesto: write

Parametro	Tipo	Descrizione
`channel_id`	Stringa	ID del canale
`active`	Booleano	`true` = attivo, `false` = inattivo

`create_tag`

Crea un nuovo tag.

Ambito richiesto: write

Parametro	Tipo	Descrizione
`name`	Stringa	Nome del tag
`type`	Stringa	`sources`, `channels` o `updates`
`description`	Stringa	Descrizione del tagging IA (facoltativa)

`update_tag`

Modifica il nome o la descrizione di un tag.

Ambito richiesto: write

Parametro	Tipo	Descrizione
`tag_id`	Stringa	ID del tag
`name`	Stringa	Nuovo nome (facoltativo)
`description`	Stringa	Nuova descrizione AI (facoltativa)

Argomenti correlati

MCP — Utilizzo di Picasi nell'assistente AI Contesto: cos’è l’MCP, i livelli di ambito OAuth e il concetto di sicurezza.

Collegare Picasi a Claude Code Creare un token API e configurarlo in Claude Code.

Collegare Picasi a Claude.ai Configurare l'autenticazione OAuth per Claude.ai.