Pour développeurs et agents IA

Donnez un comptable
à votre agent IA.

WeeKeeper expose 83 outils MCP et une API REST complète. Votre agent peut consulter les livres, catégoriser les transactions, créer des factures et générer des rapports — avec une sécurité humain-dans-la-boucle intégrée.

Outils MCP ↓API REST ↓agents.md →

🤖

Serveur MCP — pour agents IA

Connectez Claude, GPT ou tout agent compatible MCP à WeeKeeper. Votre agent obtient des outils qu'il peut appeler directement — aucune plomberie REST nécessaire.

Server: https://mcp.weekeeper.com
Transport: SSE (Server-Sent Events)
Auth: Bearer pk_live_...

🔌

API REST — pour intégrations personnalisées

API JSON standard avec pagination par curseur, clés d'idempotence et abonnements webhook. Fonctionne avec tout client HTTP.

Base URL: https://api.weekeeper.com
Auth: Bearer pk_live_... ou JWT
Format: JSON, pagination par curseur

83 outils MCP

Les outils principaux sont listés ci-dessous. Votre agent découvre le catalogue complet — clients, suivi du temps, services et factures récurrentes compris — à la connexion.

Outil	Description	Portée
get_cash_position	Solde de trésorerie actuel pour tous les comptes	read
list_transactions	Transactions avec filtres par date/catégorie/statut	read
categorize_transaction	Définir ou modifier la catégorie d'une transaction	categorize
batch_categorize	Catégoriser jusqu'à 500 transactions à la fois	categorize
get_profit_and_loss	État des résultats pour une période donnée	report
get_balance_sheet	Bilan à une date donnée	report
get_tax_estimate	Estimation d'impôt trimestriel (TPS/TVH)	report
create_invoice	Créer une nouvelle facture avec postes	invoice
list_invoices	Lister les factures avec filtre par statut	read
send_invoice	Envoyer une facture au client par courriel	invoice
scan_receipt	Numériser un reçu et le jumeler à une transaction	write
ask_question	Question en langage naturel sur les finances	read
list_uncategorized	Transactions nécessitant une révision humaine	read
propose_action	Demander l'approbation humaine pour une action	write
list_connections	Comptes bancaires reliés, avec état et date de la dernière synchronisation	read
check_sync_status	État et date de la dernière synchronisation d'une connexion bancaire	read
trigger_sync	Lancer une synchronisation des transactions à la demande	write

Voyez-le en action

Un agent IA demande à WeeKeeper un résumé financier — et reçoit des données structurées en retour.

agent-interaction.txt

# L'agent appelle l'outil get_profit_and_loss
Agent: Quelles étaient mes dépenses le dernier trimestre?

# Le serveur MCP WeeKeeper répond
Tool call: get_profit_and_loss
Parameters: {
  "start_date": "2026-01-01",
  "end_date": "2026-03-31"
}

Response: {
  "revenue": 24500.00,
  "expenses": 18200.00,
  "net_income": 6300.00,
  "currency": "CAD",
  "top_expenses": [
    {"category": "Fournitures de bureau", "amount": 3200.00},
    {"category": "Logiciels", "amount": 2800.00},
    {"category": "Repas et divertissements", "amount": 1950.00}
  ]
}

Agent: Vos dépenses totales du dernier trimestre
  étaient de 18 200 $ CAD. Catégories principales :
  Fournitures de bureau (3 200 $), Logiciels
  (2 800 $) et Repas (1 950 $). Le revenu net
  était de 6 300 $.

API REST

API JSON standard pour intégrations personnalisées. Mêmes données, même authentification, transport différent.

# Obtenir la position de trésorerie
curl -H "Authorization: Bearer pk_live_abc123" \
  https://api.weekeeper.com/api/cash-position

# Lister les transactions non catégorisées
curl -H "Authorization: Bearer pk_live_abc123" \
  "https://api.weekeeper.com/api/transactions?status=uncategorized&limit=50"

# Créer une facture
curl -X POST \
  -H "Authorization: Bearer pk_live_abc123" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: inv-2026-001" \
  -d '{
    "client_email": "client@exemple.com",
    "items": [{"description": "Consultation", "amount": 2500.00}],
    "due_date": "2026-04-15",
    "currency": "CAD"
  }' \
  https://api.weekeeper.com/api/invoices

Portées des clés API

Permissions granulaires. Donnez à votre agent uniquement l'accès dont il a besoin.

Portée	Permet	Outils exemples
read	Consulter transactions, soldes, factures	get_cash_position, list_transactions
write	Créer et modifier des enregistrements	scan_receipt, propose_action
categorize	Catégoriser les transactions	categorize_transaction, batch_categorize
invoice	Créer et envoyer des factures	create_invoice, send_invoice
report	Générer des rapports financiers	get_profit_and_loss, get_tax_estimate
admin	Accès complet incluant les paramètres	Tous les outils

Sécurité humain-dans-la-boucle

Votre agent peut proposer des actions. Les humains approuvent. Chaque action est auditée.

API de propositions

Les agents appellent propose_action pour les opérations sensibles. L'utilisateur reçoit une notification push et approuve ou rejette dans l'appli.

Politiques configurables

Les utilisateurs définissent des politiques d'approbation par type d'action. Approuver automatiquement les catégorisations mais exiger l'approbation pour les factures de plus de 1 000 $. Vous définissez les valeurs par défaut; les utilisateurs personnalisent.

Piste d'audit complète

Chaque action enregistre qui l'a faite — utilisateur, agent ou système. L'identité de l'agent (nom de la clé API) est consignée. Les utilisateurs peuvent examiner toute l'activité des agents dans l'appli.

Découverte d'agents lisible par machine

Notre fichier agents.md donne aux agents IA tout ce dont ils ont besoin pour découvrir et se connecter à WeeKeeper.

Voir agents.md →

Donnez un comptableà votre agent IA.