MCP Server Paperasse

Serveur Model Context Protocol (MCP) pour l'API Paperasse, permettant d'intégrer les fonctionnalités de Paperasse dans des modèles de langage comme Claude et GPT.

Installation

npm install @closiqode/mcp-server-paperasse

Utilisation

Démarrage du serveur

npx @closiqode/mcp-server-paperasse

Configuration

Le serveur peut être configuré à l'aide des variables d'environnement suivantes :

| Variable | Description | Valeur par défaut | |----------|-------------|------------------| | PAPERASSE_API_URL | URL de base de l'API Paperasse | https://argenteuil.paperasse.co/api | | PAPERASSE_API_KEY | Clé API pour l'authentification (obligatoire) | "" |

Comportement de la clé API

• La clé API doit être configurée via la variable d'environnement PAPERASSE_API_KEY.
• Si aucune clé API n'est configurée, le serveur générera une erreur lors des appels à l'API Paperasse.
• La clé API est passée à l'API Paperasse sous forme de paramètre GET key dans l'URL.

Endpoints disponibles

Le serveur MCP Paperasse expose 31 endpoints qui couvrent toutes les fonctionnalités de l'API Paperasse :

Gestion des clients

1. paperasse_clients - Liste tous les clients avec leurs commandes
2. paperasse_client_details - Obtient les détails d'un client spécifique
3. paperasse_client_orders - Liste les commandes d'un client spécifique
4. paperasse_client_estimates - Liste les devis pour un client

Gestion des rendez-vous

5. paperasse_appointments - Liste les créneaux de rendez-vous disponibles pour un utilisateur
6. paperasse_client_appointments - Liste les rendez-vous pour un client spécifique
7. paperasse_order_appointment - Obtient le rendez-vous pour une commande spécifique
8. paperasse_book_appointment - Réserve un rendez-vous pour une commande
9. paperasse_update_appointment - Met à jour un rendez-vous existant
10. paperasse_delete_appointment - Supprime un rendez-vous

Gestion des commandes

11. paperasse_order_update - Met à jour le statut d'une commande
12. paperasse_order_details - Obtient les détails d'une commande spécifique
13. paperasse_order_payments - Obtient les paiements d'une commande spécifique
14. paperasse_create_order - Crée une nouvelle commande

Gestion des produits

15. paperasse_products - Liste tous les produits disponibles
16. paperasse_product_details - Obtient les détails d'un produit spécifique

Gestion des rappels

17. paperasse_reminders - Liste les rappels pour une commande
18. paperasse_create_reminder - Crée un nouveau rappel pour une commande

Recherche

19. paperasse_search - Effectue une recherche globale de ressources
20. paperasse_search_products - Recherche des produits
21. paperasse_search_clients - Recherche des clients par divers attributs
22. paperasse_search_orders - Recherche des commandes
23. paperasse_search_messages - Recherche des messages liés à une commande

Gestion des conversations et messages

24. paperasse_conversations - Liste toutes les conversations
25. paperasse_create_conversation - Crée une nouvelle conversation
26. paperasse_create_message - Crée un message dans une conversation

Gestion des identifiants

27. paperasse_credentials - Liste les identifiants disponibles
28. paperasse_send_all_credentials - Envoie tous les identifiants à un client
29. paperasse_send_credentials - Envoie des identifiants spécifiques à un client

Informations utilisateur

30. paperasse_user_info - Obtient les informations de l'utilisateur actuel
31. paperasse_users_list - Liste tous les assistants du système

Exemple d'utilisation avec Claude

Installation sur Claude Desktop

1. Assurez-vous que Node.js est installé sur votre ordinateur pour que npx fonctionne.
2. Allez dans : Paramètres > Développeur > Modifier la configuration
3. Ajoutez ce qui suit à votre fichier claude_desktop_config.json :

{
  "mcpServers": {
    "paperasse": {
      "command": "npx",
      "args": [
        "-y",
        "@closiqode/mcp-server-paperasse"
      ],
      "env": {
        "PAPERASSE_API_URL": "https://argenteuil.paperasse.co/api",
        "PAPERASSE_API_KEY": "votre_clé_api_par_défaut"
      }
    }
  }
}

4. Redémarrez Claude Desktop et commencez à utiliser l'API Paperasse !

Exemple de prompt pour Claude

Je veux que tu m'aides à gérer mes clients et mes rendez-vous avec l'API Paperasse. 
Voici ma clé API : [VOTRE_CLE_API].

Peux-tu me montrer la liste de tous mes clients ?

Licence

MIT