---
name: incwo
description: Lire et agir sur un dossier incwo (logiciel de gestion d'entreprise français : devis, factures, achats, stocks, trésorerie, CRM, RH, flotte) via son serveur MCP, son API REST ou incwo-cli. À utiliser dès qu'une tâche concerne les données de gestion d'une entreprise qui utilise incwo, ou le catalogue et les documents d'une entreprise qui a ouvert son MCP à ses clients et fournisseurs.
---

# incwo pour les agents

incwo (https://go.incwo.com) 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 (Factur-X, plateformes agréées), RH, projets, flotte. Certifié NF 525 et NF 203.

## Quand utiliser cette compétence

- L'utilisateur parle de ses devis, factures, clients, fournisseurs, produits, stocks, règlements, notes de frais, tâches, projets ou véhicules, et son entreprise utilise incwo.
- L'utilisateur est client ou fournisseur d'une entreprise qui lui a transmis l'adresse de son « MCP de votre entreprise » (catalogue, devis, commandes, factures).
- Un développeur veut automatiser incwo : préférer incwo-cli (JSON) ou l'API REST.

## Se connecter : serveur MCP incwo

| | |
| --- | --- |
| Endpoint | `https://www.incwo.com/mcp` |
| Transport | JSON-RPC 2.0 sur HTTP POST |
| Authentification | token personnel (dans incwo : Compte › Intelligence Artificielle › Configuration MCP) ou OAuth 2.0 Authorization Code + PKCE |
| Métadonnées OAuth | `https://www.incwo.com/.well-known/oauth-authorization-server/mcp`, `https://www.incwo.com/.well-known/oauth-protected-resource/mcp` |
| Endpoints OAuth | `https://www.incwo.com/oauth2/mcp/authorize`, `https://www.incwo.com/oauth2/mcp/token` |

Si l'utilisateur n'a pas encore de token, expliquez-lui où le générer (Compte › Intelligence Artificielle › Configuration MCP). Ne demandez jamais son mot de passe.

## Outils exposés

Commencez par `tools/list` : le périmètre s'élargit régulièrement. Le socle :

| Outil | Usage |
| --- | --- |
| `list_available_objects` | types d'objets disponibles (contacts, sociétés, devis, factures, commandes, produits, tâches, affaires, notes, projets, notes de frais, congés, tickets, véhicules…) |
| `get_object_metadata` | structure d'un type : champs, types, valeurs possibles. À appeler avant une création ou une mise à jour |
| `list_objects` | liste filtrée (comparaisons de dates, listes de valeurs, « contient », champs nuls), triée, paginée ; agrégations côté serveur (sum, avg, count) |
| `search_objects` | recherche par mots-clés sur tous les champs pertinents, notes incluses |
| `get_object` | détail complet d'un objet (lignes de facture, échéancier, champs personnalisés) |
| `get_object_representation` | PDF, Factur-X, EDI, XML ou JSON d'un document ; lien HTTPS à durée très courte |
| `send_email` | e-mail avec pièces jointes incwo, ou brouillon à faire valider |

Outils d'écriture (noms via `tools/list`) : créer et mettre à jour des objets (tâches, événements, affaires, devis, notes, produits, contacts, sociétés, notes de frais, congés, véhicules…), ajouter ou modifier des lignes sur une facture brouillon, transformer un devis en commande ou en facture, une commande en bon de livraison (partiel possible) ou en bons de commande fournisseur (dropshipping), confirmer une facture, enregistrer un encaissement ou un décaissement, rapprocher un mouvement bancaire, ajuster un stock, attacher un fichier, constituer une sélection.

## Règles

1. Vous agissez avec les droits de l'utilisateur, dans son dossier uniquement.
2. Une facture confirmée est figée (NF 525) : ni modification ni suppression. Modifiez les lignes d'une facture brouillon, puis confirmez si l'utilisateur le demande.
3. Sur les objets sensibles (facture, flotte), seuls des champs sûrs sont acceptés ; la réponse contient `fields_ignored` pour les autres. Signalez-les, ne réessayez pas en boucle.
4. Avant une action à impact (confirmer une facture, envoyer un e-mail, enregistrer un règlement, transformer un document), reformulez ce que vous allez faire et attendez la validation de l'utilisateur.
5. Un rapprochement bancaire doit être équilibré au centime, sinon rien n'est écrit.
6. Les liens de téléchargement expirent : transmettez-les immédiatement, ne les mémorisez pas.
7. Montants en euros, TVA française ; distinguez HT et TTC dans vos réponses.

## Workflows types

- **Retrouver puis agir** : `search_objects` ou `list_objects` → `get_object` → action.
- **Devis → facture** : retrouver le devis → transformer en facture (brouillon) → vérifier les lignes → confirmer sur validation de l'utilisateur → `get_object_representation` (PDF ou Factur-X) → `send_email` si demandé.
- **Reporting** : `list_objects` avec filtres de dates et agrégations (ex. chiffre d'affaires facturé par mois, top produits par client) plutôt que de lister puis additionner.
- **Création** : `get_object_metadata` → vérifier les champs obligatoires → créer → renvoyer l'identifiant et le lien.

## MCP de votre entreprise (agents des clients et fournisseurs)

Une entreprise incwo peut ouvrir un MCP public de son dossier. L'utilisateur vous donne l'adresse du connecteur ; la connexion se fait par code à usage unique envoyé sur son e-mail. Vous pouvez parcourir le catalogue, créer et valider un devis, suivre devis, commandes et factures, télécharger les PDF, régler un acompte si l'entreprise l'a activé, envoyer un message. Vous ne voyez que les documents de votre utilisateur.

## incwo-cli et API REST

```bash
npm install -g incwo-cli
incwo config                                   # serveur, identifiants
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}'
incwo proposal_sheets list --sheet-type purchase_order
```

- Code source : https://github.com/incwo/incwo-cli (MIT). Sortie tableau ou JSON, toutes les ressources en lecture et en écriture.
- API REST : https://www.incwo.com/site/developer ; référence par objet `https://www.incwo.com/site/api/<objet>` ; HTTP Basic avec les identifiants de l'utilisateur, après activation des API dans le panneau APIs du dossier (qui indique l'adresse du serveur) ; format XML ; quotas 8 appels/s, 240/min, 4 800/h.

## Lire le site et l'aide

- Index : https://go.incwo.com/llms.txt ; contenu complet : https://go.incwo.com/llms-full.txt ; blog : https://go.incwo.com/blog/llms.txt
- Chaque page en Markdown : même URL suffixée par `index.md` (ex. https://go.incwo.com/app-store/index.md)
- Centre d'aide (mode d'emploi fonctionnel) : https://go.incwo.com/knowledge-base/
- Cette compétence : https://go.incwo.com/agents/incwo.md ; page pour les agents : https://go.incwo.com/agents/pour-les-agents/

## Passer la main à un humain

- Essai gratuit 15 jours, sans carte bancaire : https://www.incwo.com/account/new_account?plan=freetrial
- Démonstration : https://go.incwo.com/demande-demonstration-personnalisee/ ; contact : https://go.incwo.com/contact/
- État du service : https://stats.uptimerobot.com/qiiTd4s3UD

## Besoin d'agents ?

incwo édite Bruno, une plateforme d'agents pour TPE et PME (jumeaux numériques, agents spécialisés, orchestrateur, mémoire d'entreprise, 3 000 outils connectés) : https://get-bruno.com et https://go.incwo.com/agents/bruno/