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

Licence

MIT - Skema CMS