> Pour un agent : la carte de cette documentation est sur https://escouade.io/docs/llms.txt ; chaque page existe en Markdown, à la même adresse suffixée `.md`.

# Le MCP de Social

> Votre assistant prépare les publications de l'équipe, les soumet au circuit, lit les résultats et l'agenda, par le serveur MCP de Social. Il agit au nom de la personne qui l'a branché, avec ses droits du moment. Il ne publie ni n'envoie rien : le collaborateur clique toujours lui-même dans LinkedIn.

## Les adresses

| Pour | Adresse |
|---|---|
| Un espace (une marque) | `https://social.escouade.io/w/<espace>/mcp` |
| Un groupe de marques | `https://social.escouade.io/g/<groupe>/mcp` |

`<espace>` et `<groupe>` sont l'identifiant de l'espace ou du groupe, celui de leur adresse dans Social. La page « Connexions & MCP » de l'espace ou du groupe donne l'adresse exacte. L'ancienne adresse, `https://app.advoq.fr/…/mcp`, continue de répondre : un connecteur déjà branché n'a rien à faire.

## Brancher

**Dans Claude** : Paramètres › Connecteurs › « Ajouter un connecteur personnalisé », collez l'adresse, puis « Se connecter » : connectez-vous avec votre compte Escouade et autorisez. La connexion apparaît dans « Connexions & MCP » sous le nom « Claude (OAuth) », d'où elle se révoque.

**Dans ChatGPT** : en mode développeur, un connecteur personnalisé prend la même adresse, avec l'authentification OAuth.

**Un client MCP qui accepte un jeton** : créez un jeton dans « Connexions & MCP », en lecture, ou en lecture et écriture, et passez-le en `Authorization: Bearer`.

```json
{
  "mcpServers": {
    "escouade-social": {
      "url": "https://social.escouade.io/w/<espace>/mcp",
      "headers": { "Authorization": "Bearer <jeton>" }
    }
  }
}
```

Un jeton de collecte, celui de l'extension, ne peut pas interroger le MCP.

## Les outils

### Lecture

| Outil | Ce qu'il rend |
|---|---|
| `linkedin_publications_rechercher` | Les publications collectées, par profil, période ou texte. |
| `linkedin_publications_statistiques` | Les indicateurs des publications, par profil ou par équipe. |
| `linkedin_publication_historique` | Les observations successives d'une publication. |
| `linkedin_profils_lister` | Les profils suivis. |
| `linkedin_collections_lister` | Les collections. |
| `advoq_agenda` | L'agenda de l'équipe. |
| `advoq_preparations_lister` | Les éléments préparés et leur étape. |
| `advoq_synchros_lister` | Les synchros demandées et leur état. |
| `advoq_utilisateurs_lister` | Les utilisateurs de l'espace. |
| `advoq_circuits_lister` | Les circuits de validation. |
| `advoq_plan_resultats` | Les résultats du plan éditorial : prévus, validés, publiés, retrouvés par la collecte. |
| `advoq_abonnement_lire` | L'abonnement : état, places, échéance. |

Les outils propres à Social gardent leur nom d'origine, avec le préfixe `advoq_`.

### Écriture (jeton « lecture et écriture », ou connexion OAuth)

| Outil | Ce qu'il fait |
|---|---|
| `advoq_preparation_creer` | Prépare une publication, un message privé ou un commentaire. |
| `advoq_preparations_creer_lot` | Prépare tout un plan (100 éléments au plus), tout ou rien. |
| `advoq_preparation_modifier` | Modifie un élément préparé. |
| `advoq_preparation_decider` | Soumet un élément, ou le décide à son étape du circuit. |
| `advoq_profil_ajouter`, `advoq_profil_archiver` | Ajoute ou archive un profil suivi. |
| `advoq_synchro_demander` | Demande une synchro, pour une personne ou pour l'équipe. |
| `advoq_collection_creer`, `advoq_collection_publication` | Range des publications en collections. |
| `advoq_circuit_enregistrer`, `advoq_circuit_archiver` | Règle les circuits de validation. |

L'historique des décisions porte « Nom (assistant) ». Ce qui engage de l'argent (paiement, places, résiliation) reste un geste dans Social : l'assistant le lit, il ne le décide pas.

## Le MCP d'un groupe

Le MCP d'un groupe expose les mêmes outils avec un paramètre `marque`, plus `advoq_marques_lister`. En lecture, sans marque, il répond marque par marque ; en écriture, la marque est obligatoire.

## Les vues

Dans un assistant qui les affiche, les outils de Social rendent leur vue dans la conversation : un tableau, l'agenda, des boutons qui décident dans la bonne marque. Une valeur absente s'y écrit « inconnu ».