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.
Sélection du Workspace
Le serveur MCP se trouve à l’adresse https://picasi.app/mcp, sans Workspace dans l’adresse.
| Identification | Workspace |
|---|---|
| Jeton API | fixe, le Workspace du jeton ; aucun paramètre nécessaire |
| OAuth | tous les Workspaces du compte ; chaque appel a besoin de workspace_id |
Avec OAuth, list_workspaces fournit les valeurs possibles. Sans workspace_id, l’appel est refusé.
Outils de lecture
Tous les outils de lecture nécessitent au minimum la portée read.
search_updates
Recherche dans les Updates par mots-clés, sources, tags 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 | Updates d’une source spécifique (facultatif) |
tags | Tableau | Tags de thème à 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 Update individuelle.
Portée requise : read
| Paramètre | Type | Description |
|---|---|---|
update_id | Chaîne | ID de l’Update |
list_sources
Répertorie toutes les sources du Workspace.
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.
À chaque canal s’ajoutent trois champs qu’il faut distinguer :
| Champ | Signification |
|---|---|
monitoring_active | L’interrupteur du canal : activé ou non. Ce n’est pas un état de santé. |
state | L’état de la récupération : healthy, degraded, broken, quarantined ou paused. Les canaux e-mail ne sont pas récupérés mais reçoivent ; ils indiquent receiving, stale ou waiting. null signifie qu’aucune récupération n’est encore attachée. |
last_checked | La dernière tentative de récupération, pour les canaux e-mail le dernier message reçu. |
Pour le diagnostic complet d’un canal précis, c’est get_channel_status qui s’en charge.
list_reports
Répertorie les rapports 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 du Workspace : 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 tous les tags du Workspace.
Portée requise : read
| Paramètre | Type | Description |
|---|---|---|
type | Chaîne | sources, channels, updates (facultatif) |
get_update_statistics
Compte les Updates au lieu de les lister. Prend les mêmes filtres que search_updates et ne connaît pas la limite de 100 résultats.
Portée requise : read
| Paramètre | Type | Description |
|---|---|---|
group_by | Chaîne | source (par défaut), source_tag, update_tag, day, week, month, quarter |
compare_previous_period | Booléen | Compte en plus la période précédente de même durée et indique l’écart |
query | Chaîne | Terme de recherche en texte intégral (facultatif) |
source_id | Chaîne | Limiter à une source (facultatif) |
source_tags | Tableau | Tags de source (facultatif) |
update_tags | Tableau | Tags de thème (facultatif) |
source_ownership | Chaîne | all (par défaut), own ou competitor |
platform | Chaîne | Limiter à une plateforme, p. ex. linkedin (facultatif) |
folder | Tableau | inbox, saved ; par défaut les deux |
days | Entier | Période en jours, de 1 à 365 (par défaut : 30) |
date_from, date_to | Chaîne | Période sous forme de date, à la place de days |
Le regroupement par plateforme n’est pas possible. Les Updates écartés et ceux en Overflow ne sont pas comptés.
get_channel_status
Renvoie l’état d’un canal : dernière récupération, dernier succès, dernière erreur, nombre d’échecs consécutifs, prochaine tentative prévue et nombre d’Updates issus de ce canal.
Portée requise : read
| Paramètre | Type | Description |
|---|---|---|
channel_id | Chaîne | ID du canal, issu de list_sources avec include_channels=true |
discover_channels
Examine un site web et signale les canaux qui pourraient être suivis. Ne crée rien.
Portée requise : read
| Paramètre | Type | Description |
|---|---|---|
url | Chaîne | Site web à examiner (facultatif si source_id est défini) |
source_id | Chaîne | Utilise le site web de cette source et marque les canaux qu’elle possède déjà |
list_workspaces
Liste les Workspaces du compte connecté avec workspace_id, nom et rôle.
Portée requise : aucune ; l’outil est ouvert à toute connexion
Sans paramètre.
Outils de rapport
create_report
Crée un rapport à partir des Updates qui correspondent à un filtre. Les filtres sont les mêmes que pour search_updates.
La génération s’exécute en arrière-plan : l’appel renvoie immédiatement un request_id. get_report_status indique où elle en est, get_report lit le rapport terminé.
Portée requise : read
| Paramètre | Type | Description |
|---|---|---|
type | Chaîne | Obligatoire. summary, feedback, list ou conversation_starters |
title | Chaîne | Nom du rapport (facultatif) |
instructions | Chaîne | Axe pour l’IA (facultatif) |
language | Chaîne | Code de langue, p. ex. de ; par défaut la langue du Workspace |
query | Chaîne | Terme de recherche en texte intégral (facultatif) |
source_ids | Tableau | Limiter à ces sources (facultatif) |
source_tags | Tableau | Tags de source (facultatif) |
source_tags_mode | Chaîne | AND ou OR |
update_tags | Tableau | Tags de thème (facultatif) |
update_tags_mode | Chaîne | AND ou OR |
source_ownership | Chaîne | all, own ou competitor |
platform | Chaîne | Limiter à une plateforme (facultatif) |
folder | Tableau | Dossiers de la base de données ; par défaut inbox et saved |
days | Entier | Période en jours, de 1 à 365 (par défaut : 30) |
date_from, date_to | Chaîne | Période sous forme de date, à la place de days |
get_report_status
Renvoie l’état d’avancement d’un rapport commandé avec create_report.
Portée requise : read
| Paramètre | Type | Description |
|---|---|---|
request_id | Chaîne | Le request_id issu de create_report |
| Statut | Signification |
|---|---|
queued | en attente dans la file |
running | en cours de génération |
ready | terminé ; à lire avec get_report et le report_id |
empty | terminé, mais aucun Update ne correspondait aux filtres |
failed | interrompu ; la raison figure dans la réponse |
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 tags (facultatif) |
update_source
Modifie le nom, l’URL ou les tags 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 Updates.
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 un nouveau tag.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
name | Chaîne | Nom du tag |
type | Chaîne | sources, channels ou updates |
description | Chaîne | Description du balisage IA (facultatif) |
update_tag
Modifie le nom ou la description d’un tag.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
tag_id | Chaîne | ID du tag |
name | Chaîne | Nouveau nom (facultatif) |
description | Chaîne | Nouvelle description IA (facultative) |
update_update_state
Déplace des Updates entre les dossiers du Workspace.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
update_ids | Tableau | ID d’Updates, 100 au maximum par appel |
folder | Chaîne | inbox, saved ou dropped |
L’état vaut par Workspace et ne modifie pas l’Update lui-même. La réponse rend compte de chaque ID séparément.
tag_update
Attribue aux Updates des tags de thème existantes.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
update_ids | Tableau | ID d’Updates, 100 au maximum par appel |
tags | Tableau | Tags sous forme de slug, d’ID ou de nom |
mode | Chaîne | add (par défaut) conserve les tags existants, replace fixe exactement celles-ci |
Seules les tags avec applies_to = updates sont admises ; Un tag de source est refusée. Créez d’abord les tags manquants avec create_tag.
untag_update
Retire des tags de thème des Updates.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
update_ids | Tableau | ID d’Updates, 100 au maximum par appel |
tags | Tableau | Tags à retirer, sous forme de slug, d’ID ou de nom |
Seule l’attribution de ce Workspace est retirée. Le tag lui-même subsiste.
refresh_source_channels
Relance la détection des canaux pour une source existante.
Portée requise : write
| Paramètre | Type | Description |
|---|---|---|
source_id | Chaîne | ID de la source |
create_detected | Booléen | false (par défaut) se contente de signaler, true crée les canaux manquants |
Les canaux existants ne sont pas créés en double ; un canal désactivé compte comme existant. Les nouveaux canaux commencent la récupération d’eux-mêmes.