MCP-Tools - Panoramica
Diritti di accesso
Gli strumenti MCP si dividono in due gruppi:
- Strumenti di lettura — richiedono solo l’ambito di lettura; funzionano con qualsiasi token o connessione OAuth con autorizzazione di lettura
- Strumenti di scrittura — richiedono l’ambito di scrittura; necessitano di un token di amministratore o di una connessione OAuth con autorizzazione di scrittura
Strumenti di lettura
search_updates
Cerca gli aggiornamenti in base a parole chiave, fonti, tag e periodo di tempo.
| Parametro | Tipo | Descrizione |
|---|---|---|
query | Stringa | Termine di ricerca full-text (opzionale) |
source_id | Stringa | Aggiornamenti di una fonte specifica (opzionale) |
tags | Array | Tag degli aggiornamenti in base ai quali filtrare (opzionale) |
folder | Stringa | inbox, saved o dropped (facoltativo) |
limit | Intero | Numero di risultati (predefinito: 20, max: 100) |
get_update_details
Restituisce il contenuto completo di un singolo aggiornamento.
| Parametro | Tipo | Descrizione |
|---|---|---|
update_id | Stringa | ID dell’aggiornamento |
list_sources
Elenca tutte le fonti dell’area di lavoro.
| Parametro | Tipo | Descrizione |
|---|---|---|
active_only | Booleano | Restituisce solo le origini attive (impostazione predefinita: true) |
list_reports
Elenca i report IA disponibili.
| 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.
| 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).
Nessun parametro.
list_tags
Elenca tutti i tag dell’area di lavoro.
| Parametro | Tipo | Descrizione |
|---|---|---|
type | Stringa | sources, channels, updates (opzionale) |
Strumenti di scrittura
create_source
Crea una nuova fonte.
| 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.
| Parametro | Tipo | Descrizione |
|---|---|---|
source_id | Stringa | ID della fonte |
name | Stringa | Nuovo nome (facoltativo) |
url | Stringa | Nuovo URL (opzionale) |
delete_source
Elimina una fonte, inclusi tutti i canali e gli aggiornamenti.
| Parametro | Tipo | Descrizione |
|---|---|---|
source_id | Stringa | ID della fonte |
create_channel
Crea manualmente un canale.
| Parametro | Tipo | Descrizione |
|---|---|---|
source_id | Stringa | ID della sorgente principale |
url | Stringa | URL del canale |
name | Stringa | Nome del canale (opzionale) |
update_channel
Modifica il nome o la descrizione di un canale.
| Parametro | Tipo | Descrizione |
|---|---|---|
channel_id | Stringa | ID del canale |
name | Stringa | Nuovo nome (opzionale) |
delete_channel
Elimina un canale.
| Parametro | Tipo | Descrizione |
|---|---|---|
channel_id | Stringa | ID del canale |
toggle_channel
Attiva o disattiva un canale.
| Parametro | Tipo | Descrizione |
|---|---|---|
channel_id | Stringa | ID del canale |
active | Booleano | true = attivo, false = inattivo |
create_tag
Crea un nuovo tag.
| Parametro | Tipo | Descrizione |
|---|---|---|
name | Stringa | Nome tag |
type | Stringa | sources, channels o updates |
description | Stringa | Descrizione del tagging AI (opzionale) |
update_tag
Modifica il nome o la descrizione di un tag.
| Parametro | Tipo | Descrizione |
|---|---|---|
tag_id | Stringa | ID del tag |
name | Stringa | Nuovo nome (facoltativo) |
description | Stringa | Nuova descrizione AI (facoltativa) |