Serveur MCP pour assistants IA

IllusionDB est aussi un serveur MCP (Model Context Protocol) : votre assistant IA – Claude Code, Claude Desktop ou un autre client MCP – interroge lui-même les données, les analyse et gère des enregistrements. Typiquement : « Quels projets sont en retard ? », « Somme des heures par client en octobre » ou « Passe toutes les tâches du projet X à terminé ».

Le point d’accès est POST /mcp de votre instance (en dehors de /api/v1, Streamable HTTP). Sous Paramètres → Mon compte, la carte Serveur MCP affiche l’adresse avec des commandes prêtes à l’emploi ; juste après la création d’un jeton, il y est déjà inséré.

Configuration

Claude Code (une fois, dans le dossier du projet ; avec --scope user dans tous les projets) :

claude mcp add --transport http illusiondb https://db.example.com/mcp --header "Authorization: Bearer <TOKEN>"

Claude Desktop (Paramètres → Développeur → Modifier la configuration ; nécessite Node.js), puis redémarrez :

{
  "mcpServers": {
    "illusiondb": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://db.example.com/mcp", "--header", "Authorization: Bearer <TOKEN>"]
    }
  }
}

Outils

• Lecture (tout jeton) : list_datasources, list_tables, get_table, query_records, get_record, list_views, distinct_values. query_records comprend les mêmes filtres, tris, regroupements et synthèses que GET /tables/{id}/records, p. ex. l’arbre de filtres {"and":[{"col":"status","op":"eq","val":"open"}]}. Les tables peuvent être indiquées par ID ou par nom (tasks, main.tasks, Demo/tasks).
• Modification (jetons sans Lecture seule) : create_record, update_record, add_link, remove_link.

Droits

• Le jeton agit avec les droits de son compte : le rôle et les droits sur les tables s’appliquent à chaque outil – les tables sans droit de lecture n’apparaissent pas, l’écriture exige le droit d’écriture. Créez de préférence un compte dédié à l’assistant, avec exactement les droits nécessaires.
• Un jeton en Lecture seule ne reçoit que les outils de lecture.
• Volontairement pas via MCP : supprimer des enregistrements, modifier des colonnes, tables ou vues, SQL, imports, sources de données, scripts, webhooks, utilisateurs, groupes, jetons et paramètres.
• Uniquement des jetons API ; les cookies de session, ?token= et le MASTER_TOKEN ne comptent pas ici. Les requêtes d’autres pages du navigateur (Origin) sont refusées, au plus 600 appels par jeton en 10 minutes. Le serveur MCP fonctionne aussi sans interface d’administration.

Protection des données

Ce que l’assistant interroge parvient à son fournisseur d’IA. Les enregistrements peuvent provenir d’utilisateurs ou de systèmes externes – le serveur indique à l’assistant de les traiter comme des données, pas comme des instructions.