# Connecter votre site public | RenewCMS Docs

> Lisez les articles publiés, utilisez les métadonnées SEO et connectez des outils à votre instance.

Page canonique: https://renewcms.dev/fr/resources/integrate

## Récupérer un article publié

Remplacez `cms.example.com` par l’adresse du CMS et `42` par l’identifiant d’un article publié. Utilisez la réponse pour afficher l’article sur votre site. En cas de réponse `404`, vérifiez l’identifiant et l’état de publication.

```bash
curl -fsS "https://cms.example.com/v1/article/42?format=json"
```

## Choisir un format de réponse

Les articles peuvent être lus en Markdown, en HTML stocké ou sous forme de blocs JSON. Choisissez `format=markdown`, `format=html` ou `format=json` selon votre moteur de rendu. Si vous écrivez via l’API, envoyez le corps de l’article en HTML. Utilisez la pagination des routes de liste pour récupérer tous les éléments.

## Afficher les métadonnées SEO et le sitemap

Utilisez les données SEO résolues et le sitemap indiqués dans la référence Intégration de votre instance. Affichez l’URL canonique, le titre et la description sur la page publique.

Utilisez l’identifiant renvoyé avec le contenu dans la requête SEO. La route du sitemap renvoie du JSON paginé. Récupérez toutes les pages et produisez le sitemap XML depuis votre site en excluant les entrées marquées `noindex`.

```bash
curl -fsS "https://cms.example.com/v1/article/42/seo"
curl -fsS "https://cms.example.com/v1/site/journal/sitemap?page=1&size=100"
```

## Authentifier les requêtes côté serveur

Les lectures publiques sont accessibles sans clé. Pour les routes protégées compatibles, créez une clé API nommée dans une session vérifiée, stockez-la dans les secrets du serveur et envoyez-la avec `Authorization: Bearer rcms_…`. Une clé hérite des permissions de son créateur. Révoquez-la lorsqu’elle ne sert plus et ne l’incluez pas dans le code du navigateur.

## Trouver la référence API de votre version

Ouvrez Intégration dans le backoffice pour consulter les routes, l’authentification, les paramètres et les exemples de votre version. Votre CMS sert aussi `/openapi.json`, `/llms.txt` et `/llms-full.txt`. Utilisez ces fichiers pour générer un client ou documenter une intégration propre à une version.

## Connecter un client MCP

Lancez l’exécutable facultatif `renewcms-mcp` comme serveur stdio depuis votre client MCP. Fournissez-lui l’URL du CMS et une clé API dédiée dans les variables d’environnement du client. Si nécessaire, compilez l’exécutable depuis les sources de votre version avec `task build:mcp`. Créez la clé dans Intégration → Clés API et renseignez `RENEWCMS_URL` et `RENEWCMS_API_KEY` comme ci-dessous.

```json
{
  "mcpServers": {
    "renewcms": {
      "command": "/path/to/renewcms-mcp",
      "env": {
        "RENEWCMS_URL": "https://cms.example.com",
        "RENEWCMS_API_KEY": "rcms_..."
      }
    }
  }
}
```