Aller au contenu
Agents

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.

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 : 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

RessourceAdresseContenu
Index llms.txt/llms.txtRésumé, pages, univers, intégrations, App store, centre d’aide, blog récent.
Contenu complet/llms-full.txtToutes les pages, intégrations, apps et articles d’aide en un seul fichier (≈ 2,7 Mo).
Chaque page en Markdown<url de la page>index.mdExemples : /tpe/index.md, /app-store/colisage-224099/index.md, /blog/<slug>/index.md. Annoncé dans chaque page par <link rel="alternate" type="text/markdown">.
Blog/blog/llms.txt, /feed.xmlIndex complet des articles, flux RSS.
Données structuréesJSON-LD sur chaque pageOrganization, WebSite, WebPage, BreadcrumbList, SoftwareApplication (apps), TechArticle (centre d’aide), Article (blog), FAQPage.
Plan du site/sitemap_index.xmlSitemap 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.

Endpointhttps://www.incwo.com/mcp
TransportJSON-RPC 2.0 sur HTTP POST
AuthentificationToken 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

Documentationincwo.com/site/developer, référence par objet : /site/api/<objet>
AuthentificationHTTP 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.
FormatXML (JSON via incwo-cli)
Quotas8 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 (licence MIT).

Passer la main à un humain

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/, get-bruno.com.