Skema MCP Server

Serveur MCP (Model Context Protocol) officiel pour Skema CMS.
Connectez Claude Desktop, Cursor, Windsurf ou tout client MCP compatible à vos données Skema.

Installation

npm install -g @skemacms/mcp-server

Configuration

Claude Desktop

Ajoutez dans votre fichier claude_desktop_config.json :

{
  "mcpServers": {
    "skema-cms": {
      "command": "skema-mcp",
      "env": {
        "SKEMA_API_KEY": "pk_live_votre_cle_api",
      }
    }
  }
}

Windsurf / Cursor

Ajoutez dans vos paramètres MCP :

{
  "skema-cms": {
    "command": "npx",
    "args": ["-y", "@skemacms/mcp-server"],
    "env": {
      "SKEMA_API_KEY": "pk_live_votre_cle_api",
    }
  }
}

Variables d'environnement

Variable	Description	Requis
SKEMA_API_KEY	Clé API Skema (format pk_live_xxx)	Oui

Outils disponibles (11 outils)

Lecture

Outil	Description
get_collections	Liste toutes les collections accessibles
get_collection	Récupère le schéma d'une collection (champs, types, relations)
get_collection_items	Liste les items avec pagination, tri, filtres et populate
get_collection_item	Récupère un item par son ID avec ses relations
search_collection_items	Recherche textuelle dans une collection
count_collection_items	Compte les items avec filtres optionnels

Écriture

Outil	Description
create_collection_item	Crée un nouvel item
update_collection_item	Met à jour un item existant (merge partiel)
delete_collection_item	Supprime un item
batch_create_items	Crée plusieurs items en une seule requête
batch_update_items	Met à jour plusieurs items en une seule requête

Exemples d'utilisation

Lister les collections

Quelles collections sont disponibles dans mon CMS ?

Récupérer des items avec relations

Liste les 10 derniers articles avec leurs auteurs et catégories

Créer un item

Crée un nouvel article avec le titre "Mon article" et le statut "draft"

Recherche

Recherche les produits contenant "smartphone" dans le titre

Opérations en masse

Mets à jour le statut de tous les articles de la catégorie "news" en "published"

API HTTP (alternative)

Vous pouvez aussi utiliser l'API MCP directement via HTTP :

Endpoint : POST https://api.skemacms.com/mcp

Headers :

• Authorization: Bearer <API_KEY>
• Content-Type: application/json

Exemple cURL

curl -X POST https://api.skemacms.com/mcp \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_collection_items",
      "arguments": {
        "collection": "articles",
        "page": 1,
        "perPage": 10,
        "populate": "author,category"
      }
    }
  }'

Exemple Python

import requests

API_KEY = "pk_live_xxx"
MCP_URL = "https://api.skemacms.com/mcp"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.post(MCP_URL, headers=headers, json={
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "get_collection_items",
        "arguments": {"collection": "articles", "populate": "author"}
    }
})
print(response.json())

Méthodes JSON-RPC

Méthode	Description
initialize	Initialise la connexion MCP
tools/list	Liste tous les outils disponibles
tools/call	Exécute un outil avec ses arguments

Permissions

Les outils disponibles dépendent des permissions de votre clé API :

Permission	Outils autorisés
read	get_*, search_*, count_*
create	create_*, batch_create_*
update	update_*, batch_update_*
delete	delete_*

Développement local

git clone https://github.com/skemacms/mcp-server.git
cd mcp-server
npm install
npm run dev

Liens utiles

• Documentation Skema CMS
• Guide MCP
• Créer une clé API

Licence

MIT - Skema CMS