Outils MCP — Présentation générale
Droits d’accès
Les outils MCP sont affectés à trois niveaux de portée :
| Portée | Signification |
|---|---|
read | Accès en lecture seule ; pas de création, modification ou suppression |
write | Lecture et écriture des sources, des canaux et de l’Inbox ; pas d’accès aux paramètres de l’équipe |
admin | Accès MCP complet, y compris aux paramètres de l’équipe |
Pour les connexions OAuth, le périmètre sélectionné lors de l’autorisation détermine les outils accessibles. Pour les jetons API, le rôle du jeton définit le niveau d’accès maximal.
Outils de lecture
Tous les outils de lecture nécessitent au minimum la portée read.
search_updates
Recherche dans les mises à jour par mots-clés, sources, balises et période.
Portée requise : read
| Paramètre | Type | Description |
|---|---|---|
query | Chaîne | Terme de recherche en texte intégral (facultatif) |
source_id | Chaîne | Mises à jour d’une source spécifique (facultatif) |
tags | Tableau | Balises de mise à jour à utiliser pour le filtrage (facultatif) |
folder | Chaîne | inbox, saved ou dropped (facultatif) |
source_ownership | Chaîne | all (par défaut), own (uniquement les sources propres) ou competitor (uniquement les sources externes) |
limit | Entier | Nombre de résultats (par défaut : 20, max. : 100) |
Le filtre source_ownership utilise le champ is_own au niveau de la source. Il correspond au filtre « Ownership » de l’interface utilisateur de l’Inbox et permet à l’assistant IA de se concentrer spécifiquement sur la présence de l’entreprise ou sur celle des concurrents.
get_update_details
Renvoie le contenu complet d’une mise à jour individuelle.
Portée requise : read
| Paramètre | Type | Description |
|---|---|---|
update_id | Chaîne | ID de la mise à jour |
list_sources
Répertorie toutes les sources de l’espace de travail.
Portée requise : read
| Paramètre | Type | Description |
|---|---|---|
is_own | Booléen | true = uniquement ses propres sources, false = uniquement les concurrents, omettre = toutes |
Chaque source renvoyée contient le champ is_own, afin que les assistants IA puissent distinguer leur propre présence de celle des concurrents sans avoir à effectuer une deuxième requête.
list_reports
Répertorie les rapports IA disponibles.
Portée requise : read
| Paramètre | Type | Description |
|---|---|---|
type | Chaîne | summary, feedback, list, linkedin_post, conversation_starters (facultatif) |
limit | Entier | Nombre (par défaut : 10) |
get_report
Renvoie le contenu complet d’un rapport.
Portée requise : read
| Paramètre | Type | Description |
|---|---|---|
report_id | Chaîne | ID du rapport |
get_team_context
Renvoie le contexte IA de l’espace de travail : métadonnées de l’équipe (nom, langue, fuseau horaire), URL du site web, documents de contexte et configuration de la propriété.
Portée requise : read
Aucun paramètre obligatoire.
La réponse contient dans le bloc context :
website_url– URL de l’organisation enregistréeis_own_sources_configured–true, dès qu’au moins une source est marquée comme propreown_sources_count– nombre de sources propres
Les assistants IA ne doivent proposer des comparaisons Voice Share ou Momentum que si is_own_sources_configured est égal à true — sinon, la base de comparaison fait défaut.
list_tags
Répertorie toutes les balises de l’espace de travail.
Portée requise : read
| Paramètre | Type | Description |
|---|---|---|
type | Chaîne | sources, channels, updates (facultatif) |
Outils d’écriture
Tous les outils d’écriture nécessitent au minimum la portée write.
create_source
Crée une nouvelle source.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
url | Chaîne | URL du site web de la source |
name | Chaîne | Nom interne |
tags | Tableau | ID des balises (facultatif) |
update_source
Modifie le nom, l’URL ou les balises d’une source existante.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
source_id | Chaîne | ID de la source |
name | Chaîne | Nouveau nom (facultatif) |
url | Chaîne | Nouvelle URL (facultatif) |
delete_source
Supprime une source, y compris tous ses canaux et toutes ses mises à jour.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
source_id | Chaîne | ID de la source |
create_channel
Crée manuellement un canal.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
source_id | Chaîne | ID de la source parente |
url | Chaîne | URL du canal |
name | Chaîne | Nom du canal (facultatif) |
update_channel
Modifie le nom ou la description d’une chaîne.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
channel_id | Chaîne | ID de la chaîne |
name | Chaîne | Nouveau nom (facultatif) |
delete_channel
Supprime un canal.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
channel_id | Chaîne | ID du canal |
toggle_channel
Active ou désactive un canal.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
channel_id | Chaîne | ID du canal |
active | Booléen | true = actif, false = inactif |
create_tag
Crée une nouvelle balise.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
name | Chaîne | Nom de la balise |
type | Chaîne | sources, channels ou updates |
description | Chaîne | Description du balisage IA (facultatif) |
update_tag
Modifie le nom ou la description d’une balise.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
tag_id | Chaîne | ID de la balise |
name | Chaîne | Nouveau nom (facultatif) |
description | Chaîne | Nouvelle description IA (facultative) |