Docs/Premier projet

Créer votre ptext-2xlrojet

En 5 minutes, vous aurez une base de données connectée, une collection créée, et une API MCP fonctionnelle. Plus rapide que de commander un café. Et plus utile aussi.

1

Créez votre compte

Rendez-vous sur l'application Skema et créez votre compte. Email, mot de passe, c'est tout. Pas de numéro de carte bleue, pas de questionnaire sur vos habitudes alimentaires, pas de spam.

Créer un compte
2

Connectez votre base de données

Dans le dashboard, cliquez sur "Nouvelle connexion" et entrez les informations de votre base PostgreSQL ou MySQL. On ne stocke rien, on se connecte juste. Vos données restent chez vous.

Informations requises :

  • - Hôte (ex: db.exemple.com ou localhost)
  • - Port (5432 pour PostgreSQL, 3306 pour MySQL)
  • - Nom de la base de données
  • - Utilisateur et mot de passe
3

Créez votre première collection

Une collection = une table dans votre base. Cliquez sur "Nouvelle collection", donnez-lui un nom (ex: "articles"), et ajoutez les champs. Skema crée la table pour vous.

Types de champs disponibles :

  • - text : Texte court (titre, nom...)
  • - textarea : Texte long (contenu, description...)
  • - number : Nombres (prix, quantité...)
  • - boolean : Vrai/Faux (publié, actif...)
  • - date : Dates (créé le, modifié le...)
  • - relation : Lien vers une autre collection
4

Générez une clé API

Allez dans "Clés API" et créez une nouvelle clé. Choisissez les permissions (lecture, écriture, suppression) et les collections accessibles. La clé ne s'affiche qu'une fois. Copiez-la.

Important : Gardez votre clé API secrète. Ne la commitez jamais dans votre code. Utilisez des variables d'environnement. Votre stagiaire n'a pas besoin de la voir.

5

Testez l'API MCP

Votre API est prête. Testez-la avec 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_collections",
      "arguments": {}
    }
  }'

Si tout est bien configuré, vous verrez la liste de vos collections. Sinon, vérifiez votre clé API. C'est toujours la clé API.

+

Bonus : Connectez Claude Desktop

Installez le package npm et configurez Claude Desktop pour interagir avec vos données en langage naturel :

npm install -g @skemacms/mcp-server

Puis dans claude_desktop_config.json :

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

Redémarrez Claude Desktop et demandez-lui "liste mes collections". Magie.