> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reposter.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Accès agents & API

> Connecter un agent IA ou un outil externe à votre compte avec une clé API

Reposter peut être piloté par des agents IA (Claude, ChatGPT, scripts…) grâce aux **clés API**. Une clé permet à un outil externe d'agir sur votre compte, dans la limite des permissions que vous lui donnez.

## Créer une clé

1. Ouvrez votre **Profil** → section **Accès agents & API**
2. Cliquez sur **Nouvelle clé**
3. Donnez-lui un nom (ex : « Claude », « mon script ») et choisissez ses permissions :
   * **Lecture seule** : consulter vos annonces, comptes, tâches et statistiques
   * **Lecture + écriture** : créer, modifier et publier des annonces
4. **Copiez la clé immédiatement** : elle ne sera plus jamais affichée

<Warning>
  Votre clé donne accès à votre compte : ne la partagez jamais publiquement (dépôt Git, capture d'écran, prompt partagé…). En cas de doute, révoquez-la et créez-en une nouvelle.
</Warning>

## Utiliser la clé

La clé s'envoie en header HTTP sur `https://api.reposter.io` :

```bash theme={null}
curl https://api.reposter.io/user \
  -H "Authorization: Bearer rk_votre_cle"
```

## Limites et sécurité

* **10 clés maximum** par compte
* Une clé **lecture seule** ne peut effectuer aucune action de modification
* La facturation, le paiement et le support ne sont **jamais** accessibles par clé API
* La création et la révocation de clés ne sont possibles que depuis l'application
* Chaque clé affiche sa **dernière utilisation** dans votre profil — surveillez toute activité inattendue
* Les limites de débit s'appliquent (réponse `429` avec header `Retry-After`)

## Révoquer une clé

Dans **Profil** → **Accès agents & API**, cliquez sur l'icône corbeille de la clé concernée. La révocation est immédiate : tout outil qui utilisait cette clé perd l'accès instantanément.

## Serveur MCP

Reposter expose un serveur **MCP** (Model Context Protocol) : connectez Claude, Cursor ou tout client MCP à votre compte, et l'assistant peut lister, créer et publier vos annonces, gérer vos tâches et consulter vos statistiques.

* **Endpoint** : `https://api.reposter.io/mcp` (transport Streamable HTTP)
* **Authentification** : votre clé API en header `Authorization: Bearer rk_...`

### Connecter Claude Code

```bash theme={null}
claude mcp add --transport http reposter https://api.reposter.io/mcp --header "Authorization: Bearer rk_votre_cle"
```

### Connecter Cursor (ou tout client mcp.json)

```json theme={null}
{
  "mcpServers": {
    "reposter": {
      "url": "https://api.reposter.io/mcp",
      "headers": { "Authorization": "Bearer rk_votre_cle" }
    }
  }
}
```

### Outils disponibles

| Outil                                      | Scope | Description                                                 |
| ------------------------------------------ | ----- | ----------------------------------------------------------- |
| `list_ads`, `get_ad`                       | read  | Lister / détailler vos annonces                             |
| `search_categories`, `get_category_fields` | read  | Trouver la catégorie Leboncoin et ses attributs             |
| `list_accounts`                            | read  | Vos comptes connectés                                       |
| `list_tasks`                               | read  | Vos tâches de publication                                   |
| `get_credits`                              | read  | Solde de crédits et limites                                 |
| `get_stats`                                | read  | Publications par jour d'un compte                           |
| `report_problem`                           | read  | Signaler un blocage ou suggérer une amélioration à l'équipe |
| `create_ad`, `update_ad`                   | write | Créer / modifier une annonce                                |
| `add_image_from_url`                       | write | Ajouter une image à une annonce                             |
| `publish_ad`                               | write | Publier immédiatement (consomme des crédits)                |
| `create_task`, `toggle_task_pause`         | write | Planifier des publications / pauser                         |

<Note>
  Un assistant connecté avec une clé **lecture seule** peut consulter mais jamais agir. Les publications déclenchées par un agent consomment vos crédits comme n'importe quelle publication.
</Note>