Aller au contenu principal

Assistants IA (MCP et llms.txt)

Laisser un assistant imprimer : le serveur MCP​

@jodaprint/mcp est un serveur Model Context Protocol. Claude, Cursor, VS Code et les autres applications MCP peuvent alors lister vos imprimantes, imprimer tickets, étiquettes et documents, et suivre les travaux :

« Imprime le rapport des ventes du jour sur l’imprimante du bureau. » « Pourquoi le ticket du magasin de Delmas a-t-il échoué ? Réimprime-le. »

  1. Tableau de bord → Développeurs → Clés API → Créer une clé. Commencez par une clé de test (jp_test_…) : elle imprime dans le bac à sable. Les portées de la clé limitent ce que l’assistant peut faire (jobs:write pour imprimer).
  2. Ajoutez le serveur à l’application. Pour Claude Desktop, dans claude_desktop_config.json :
{
  "mcpServers": {
    "jodaprint": {
      "command": "npx",
      "args": ["-y", "@jodaprint/mcp"],
      "env": { "JODAPRINT_API_KEY": "jp_test_…" }
    }
  }
}

Avec Claude Code : claude mcp add jodaprint --env JODAPRINT_API_KEY=jp_test_… -- npx -y @jodaprint/mcp.

Le serveur fournit :

  • des outils : list_devices, list_printers, print, print_template, preview_receipt, get_job, list_jobs, cancel_job, reprint_job, list_templates et get_template ;
  • un guide du format des tickets, en ressource.

Pour le limiter :

  • JODAPRINT_READ_ONLY=true retire les outils d’impression.
  • JODAPRINT_ALLOWED_DEVICES et JODAPRINT_ALLOWED_PRINTERS limitent où il peut imprimer.

Aider les assistants de code : llms.txt​

Le site de documentation publie des versions en texte brut pour les outils d’IA (llmstxt.org) :

  • /llms.txt : un index de toutes les pages avec un résumé d’une ligne ;
  • /llms-full.txt : toute la documentation anglaise en un fichier, qu’un assistant peut lire d’un coup ;
  • /llms/<page>.md : chaque page en Markdown ;
  • /openapi.json : la description de l’API REST.

Les paquets npm @jodaprint/sdk et @jodaprint/node contiennent aussi un AGENTS.md avec les règles et les exemples qu’un assistant doit suivre pour écrire une intégration correcte : jamais de clé dans le navigateur, imprimantes choisies par alias, clés d’idempotence.