--- title: "Pour les agents : comment lire et utiliser incwo" url: "https://go.incwo.com/agents/pour-les-agents/" description: "Mode d’emploi d’incwo pour les agents et les LLM : fichiers llms.txt, pages en Markdown, serveur MCP, authentification OAuth, API REST, CLI, et fichier de compétence à télécharger." lang: "fr" modified: "2026-09-08T10:00:00" --- # Pour les agents : comment lire et utiliser incwo Cette page s’adresse aux agents IA et aux LLM, et aux développeurs qui les outillent. Elle décrit, sans détour, comment lire incwo et comment agir dessus. Version Markdown : [/agents/pour-les-agents/index.md](/agents/pour-les-agents/index.md). ## En une phrase incwo est un logiciel de gestion d’entreprise en ligne, Made in France, pour les TPE, PME, franchises et cabinets comptables : devis et factures, achats et notes de frais, CRM, produits et stocks, compte pro et trésorerie, caisse connectée, pré-comptabilité, facturation électronique, RH, projets, flotte. Il expose ses données et ses actions aux agents par MCP, par API REST et en ligne de commande. ## Fichier de compétence à télécharger [/agents/incwo.md](/agents/incwo.md) : un fichier au format SKILL.md (frontmatter name et description, puis instructions) qui explique quand et comment utiliser incwo : connexion MCP, outils disponibles, règles de sécurité, CLI, API. Copiez-le dans le dossier de compétences de votre agent. ## Lire le site Ressource Adresse Contenu Index llms.txt [/llms.txt](/llms.txt) Résumé, pages, univers, intégrations, App store, centre d’aide, blog récent. Contenu complet [/llms-full.txt](/llms-full.txt) Toutes les pages, intégrations, apps et articles d’aide en un seul fichier (≈ 2,7 Mo). Chaque page en Markdown `index.md` Exemples : /tpe/index.md, /app-store/colisage-224099/index.md, /blog//index.md. Annoncé dans chaque page par ``. Blog [/blog/llms.txt](/blog/llms.txt), [/feed.xml](/feed.xml) Index complet des articles, flux RSS. Données structurées JSON-LD sur chaque page Organization, WebSite, WebPage, BreadcrumbList, SoftwareApplication (apps), TechArticle (centre d’aide), Article (blog), FAQPage. Plan du site [/sitemap\_index.xml](/sitemap_index.xml) Sitemap XML bilingue FR/EN. Le fichier robots.txt autorise explicitement les robots des assistants IA (GPTBot, ClaudeBot, PerplexityBot, Google-Extended…). ## Agir sur un dossier incwo : le serveur MCP Le serveur MCP (Model Context Protocol) donne accès aux données et aux actions du dossier de l’utilisateur qui vous a autorisé, dans les limites de ses droits. Endpoint `https://www.incwo.com/mcp` Transport JSON-RPC 2.0 sur HTTP POST Authentification Token personnel (Compte › Intelligence Artificielle › Configuration MCP) ou OAuth 2.0 Authorization Code + PKCE Métadonnées OAuth `/.well-known/oauth-authorization-server/mcp`, `/.well-known/oauth-protected-resource/mcp` Endpoints OAuth `/oauth2/mcp/authorize`, `/oauth2/mcp/token` Les outils suivent un modèle générique : découvrir les types d’objets, lister avec filtres, tri, pagination et agrégations, obtenir un objet, rechercher, lire la structure d’un type, obtenir une représentation (PDF, Factur-X, EDI, XML, JSON), envoyer un e-mail. S’y ajoutent les outils d’écriture (création, mise à jour, transformation devis → commande → facture, confirmation de facture, règlement, stock, e-mail), à découvrir par tools/list. ``` list_available_objects types d’objets disponibles list_objects liste filtrée, triée, paginée ; agrégats sum, avg, count get_object détail complet d’un objet (lignes, échéancier…) search_objects recherche par mots-clés, tous champs get_object_metadata structure d’un type d’objet get_object_representation PDF, Factur-X, EDI, XML, JSON send_email e-mail avec pièces jointes incwo ``` ### Règles à respecter - Vous agissez avec les droits de l’utilisateur, dans son dossier uniquement. Ne tentez pas d’accéder à un autre dossier. - Une facture confirmée est figée (NF 525) : ne cherchez pas à la modifier ni à la supprimer. Travaillez sur les brouillons. - Sur les objets sensibles, seuls des champs sûrs sont acceptés en écriture ; le serveur renvoie fields\_ignored pour les autres. Signalez-les à l’utilisateur au lieu de réessayer. - Les liens de téléchargement expirent vite : utilisez-les immédiatement, ne les stockez pas. - Avant une action à impact (confirmer une facture, envoyer un e-mail, enregistrer un règlement), reformulez et faites valider par l’utilisateur. ## Agir pour un client ou un fournisseur : le MCP de l’entreprise Une entreprise cliente d’incwo peut ouvrir un MCP public de son dossier. Si votre utilisateur est client ou fournisseur de cette entreprise, il vous transmet l’adresse du connecteur ; la connexion se fait par code à usage unique envoyé sur son e-mail. Vous pouvez alors parcourir le catalogue, créer un devis, suivre les documents de votre utilisateur, télécharger leurs PDF, régler un acompte si l’entreprise l’a activé, et envoyer un message. Vous ne voyez que les documents de votre utilisateur. ## API REST Documentation [incwo.com/site/developer](https://www.incwo.com/site/developer), référence par objet : `/site/api/` Authentification HTTP Basic avec les identifiants de l’utilisateur, après activation des API dans le panneau APIs du dossier, qui indique aussi l’adresse du serveur. Format XML (JSON via incwo-cli) Quotas 8 appels par seconde, 240 par minute, 4 800 par heure ## Ligne de commande : incwo-cli ``` npm install -g incwo-cli incwo config incwo bill_sheets list --from 2026-04-01 incwo contacts list --filter '{"last_name":{"eq":"Martin"}}' incwo contacts create --data '{"first_name":"Marie","last_name":"Dupont","firm_id":42}' ``` Toutes les ressources (CRM, ventes, achats, stock, projets, RH) en lecture et en écriture, sortie tableau ou JSON. Code source : [github.com/incwo/incwo-cli](https://github.com/incwo/incwo-cli) (licence MIT). ## Passer la main à un humain - Essai gratuit 15 jours, sans carte bancaire : [ouvrir un compte](https://www.incwo.com/account/new_account?plan=freetrial) - Démonstration personnalisée : [demander une démo](/demande-demonstration-personnalisee/) - Contact : [/contact/](/contact/) - Centre d’aide : [/knowledge-base/](/knowledge-base/) - État du service : [stats.uptimerobot.com/qiiTd4s3UD](https://stats.uptimerobot.com/qiiTd4s3UD) ## Vous cherchez des agents ? incwo édite Bruno, une plateforme d’agents pour TPE et PME : jumeaux numériques, agents spécialisés, orchestrateur, mémoire d’entreprise, connectée à 3 000 outils. Son catalogue de cas d’usage est aussi exposé en Markdown. [/agents/bruno/](/agents/bruno/), [get-bruno.com](https://get-bruno.com).