MCP-Tools - 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, casella di posta in arrivo; nessun accesso alle impostazioni del team |
admin | Accesso completo a MCP, comprese le impostazioni del team |
Per le connessioni OAuth, l’ambito selezionato durante l’autorizzazione limita gli strumenti accessibili. Per i 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.
Ambito richiesto: read
| Parametro | Tipo | Descrizione |
|---|---|---|
query | Stringa | Termine di ricerca full-text (opzionale) |
source_id | Stringa | Aggiornamenti di una determinata fonte (opzionale) |
tags | Array | Tag degli aggiornamenti in base ai quali filtrare (opzionale) |
folder | Stringa | inbox, saved o dropped (opzionale) |
limit | Intero | Numero di risultati (predefinito: 20, max: 100) |
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 |
|---|---|---|
active_only | Booleano | Restituisce solo le origini attive (impostazione predefinita: true) |
list_reports
Elenca i report 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 AI dell’area di lavoro (URL del sito web e documenti di contesto).
Ambito richiesto: read
Nessun parametro.
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.
Ambito richiesto: write
| Parametro | Tipo | Descrizione |
|---|---|---|
url | Stringa | URL del sito web della fonte |
name | Stringa | Nome interno |
tags | Array | ID 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 (opzionale) |
url | Stringa | Nuovo URL (opzionale) |
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 sorgente di livello superiore |
url | Stringa | URL del canale |
name | Stringa | Nome del canale (opzionale) |
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 tag |
type | Stringa | sources, channels o updates |
description | Stringa | Descrizione tagging IA (opzionale) |
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) |