Serveur MCP

Le serveur MCP fiskaly-docs donne aux assistants de codage IA un accès direct à la documentation fiskaly, aux spécifications OpenAPI, aux métadonnées produit et aux codes d’erreur — sans web scraping ni recherches manuelles.

Il implémente le Model Context Protocol (MCP) et expose 9 outils que tout client compatible MCP peut appeler.

Outils disponibles

Outils de documentation

Rechercher des pages de documentation par mot-clé. Retourne les titres de pages correspondants, les chemins et des extraits pertinents de 500 caractères.

Paramètres :

• query (obligatoire) — mot-clé de recherche (correspondance de sous-chaîne sur le titre et le corps)
• product (optionnel) — filtrer par nom de produit, ex. SIGN DE, SIGN FR
• country (optionnel) — filtrer par code pays, ex. DE, FR, IT

Lire une page de documentation complète par chemin. Supporte la correspondance partielle et de suffixe. Retourne le corps complet de la page et les pages sœurs associées.

Paramètres :

• path (obligatoire) — chemin de la page ou suffixe, ex. getting-started/quickstart, quickstart

Obtenir les métadonnées d’un produit fiskaly : description, pays, architecture API, URLs de base, liens de documentation et pages associées.

Paramètres :

• product (obligatoire) — ID du produit (ex. sign-de, sign-fr) ou nom du produit (ex. SIGN DE, DSFinV-K)

Obtenir les codes d’erreur de l’API fiskaly avec statut HTTP, description et conseils de résolution. Filtrer optionnellement par produit.

Paramètres :

• product (optionnel) — filtrer par ID de produit (ex. sign-de, sign-fr). Omettre pour obtenir tous les codes d’erreur.

Outils d’exploration API

Obtenir la spécification OpenAPI d’un produit fiskaly. Utilisez format="summary" pour une vue d’ensemble des endpoints et des noms de schémas plutôt que la spécification complète.

Paramètres :

• product (obligatoire) — ID du produit : sign-de, sign-at, sign-fr, sign-it, sign-es, dsfinvk, ereceipt, management, obono
• format (optionnel) — full (par défaut) ou summary (info + liste d’endpoints + noms de schémas)

Lister tous les endpoints API d’un produit, groupés par tag. Affiche méthode, chemin, operationId et résumé.

Paramètres :

• product (obligatoire) — ID du produit
• tag (optionnel) — filtrer par nom de tag (correspondance partielle insensible à la casse)

Obtenir des informations détaillées sur un endpoint spécifique : paramètres, corps de requête, schémas de réponse et sécurité.

Paramètres :

• product (obligatoire) — ID du produit
• path (optionnel) — chemin API à faire correspondre (correspondance partielle)
• method (optionnel) — méthode HTTP (GET, POST, PUT, etc.)
• operationId (optionnel) — ID d’opération (partiel, insensible à la casse)

Rechercher un schéma OpenAPI par nom avec expansion des $ref (2 niveaux de profondeur, sécurisé contre les cycles). Utilisez list=true pour voir tous les noms de schémas disponibles.

Paramètres :

• product (obligatoire) — ID du produit
• schema (optionnel) — nom du schéma (correspondance partielle, insensible à la casse)
• list (optionnel) — mettre à true pour lister tous les noms de schémas

Outils d’intégration

Obtenir un guide d’intégration étape par étape pour un produit. Compose les informations d’environnement, le flux d’authentification, les étapes de démarrage rapide issues de la documentation, les endpoints clés de la spécification et les liens de documentation.

Paramètres :

• product (obligatoire) — ID ou nom du produit (ex. sign-de, SIGN FR)

Configuration

Claude Code

Ajoutez le serveur MCP fiskaly-docs à votre projet :

claude mcp add fiskaly-docs -- npx @fiskaly/docs-mcp

Ou ajoutez-le au .mcp.json de votre projet :

{
  "mcpServers": {
    "fiskaly-docs": {
      "command": "npx",
      "args": ["@fiskaly/docs-mcp"]
    }
  }
}

Cursor

Ajoutez à votre .cursor/mcp.json :

{
  "mcpServers": {
    "fiskaly-docs": {
      "command": "npx",
      "args": ["@fiskaly/docs-mcp"]
    }
  }
}

Windsurf

Ajoutez à ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "fiskaly-docs": {
      "command": "npx",
      "args": ["@fiskaly/docs-mcp"]
    }
  }
}

VS Code (GitHub Copilot)

Ajoutez au .vscode/mcp.json de votre projet :

{
  "servers": {
    "fiskaly-docs": {
      "command": "npx",
      "args": ["@fiskaly/docs-mcp"]
    }
  }
}

IDEs JetBrains

Allez dans Paramètres > Outils > Assistant IA > Model Context Protocol et ajoutez un nouveau serveur avec :

• Commande : npx
• Arguments : @fiskaly/docs-mcp

Clients MCP génériques

Le serveur communique via stdio en utilisant le protocole MCP. Démarrez-le avec :

npx @fiskaly/docs-mcp

Il nécessite Node.js 24+.

Exemples d’utilisation

Lire une page de documentation complète

Tool: get_doc_page
Input: { "path": "getting-started/quickstart" }

Retourne le corps complet de la page avec des liens vers les pages sœurs — idéal pour lire les guides d’intégration de bout en bout.

Parcourir les endpoints API

Tool: list_endpoints
Input: { "product": "sign-de", "tag": "Transaction" }

Retourne tous les endpoints liés aux transactions groupés par tag, avec méthode, chemin, operationId et résumé.

Rechercher un endpoint spécifique

Tool: get_endpoint
Input: { "product": "sign-de", "operationId": "upsertTransaction" }

Retourne des détails ciblés : paramètres, schéma du corps de requête (résolu), schémas de réponse et exigences de sécurité.

Obtenir un guide d’intégration

Tool: get_integration_guide
Input: { "product": "sign-fr" }

Retourne un guide composé avec les URLs d’environnement, le flux d’authentification, le contenu de démarrage rapide, les endpoints clés de la spécification et des liens vers les pages de documentation pertinentes.

Résoudre un schéma

Tool: resolve_schema
Input: { "product": "sign-de", "schema": "Transaction" }

Retourne le schéma résolu avec $ref développé sur 2 niveaux de profondeur. Utilisez list=true pour voir d’abord tous les noms de schémas disponibles.

Obtenir un résumé de spécification

Tool: get_openapi_spec
Input: { "product": "sign-de", "format": "summary" }

Retourne les informations API, une liste de tous les endpoints et les noms de schémas — sans la spécification complète de plus de 5000 lignes.

Rechercher dans la documentation

Tool: search_docs
Input: { "query": "transaction", "product": "SIGN DE" }

Retourne les pages correspondantes avec titres, chemins et extraits de contenu de 500 caractères pertinents pour les transactions SIGN DE.

Rechercher des métadonnées produit

Tool: get_product_info
Input: { "product": "sign-de" }

Retourne des métadonnées structurées :

• Nom, description et pays du produit
• Architecture API (spécialisée ou unifiée)
• URLs de base pour les environnements TEST et LIVE
• URL de spécification, URL de documentation et pages associées

Rechercher des codes d’erreur

Tool: get_error_codes
Input: { "product": "sign-de" }

Retourne tous les codes d’erreur pour SIGN DE avec codes de statut HTTP, descriptions et conseils de résolution.

Dépannage

Le serveur ne démarre pas ? Assurez-vous d’avoir Node.js 24+ installé. Exécutez node --version pour vérifier.

Aucun résultat de search_docs ? Essayez un terme de recherche plus large. La recherche utilise la correspondance de sous-chaîne sur les titres et le texte — les mots-clés plus courts retournent plus de résultats.

get_openapi_spec retourne une erreur ? Tous les produits n’ont pas une spécification OpenAPI. Utilisez get_product_info pour vérifier si un produit possède un specFile.

Alternative : Endpoints HTTP

Si vous préférez HTTP à MCP, les mêmes données sont disponibles comme endpoints lisibles par machine :

• Rechercher dans la documentation — récupérer et rechercher dans /llms-full.txt
• Spécifications OpenAPI — récupérer /specs/{product}.json ou .yaml directement
• Informations produit — récupérer /products.json
• Codes d’erreur — utiliser get_error_codes via MCP, ou consulter la référence Codes d’Erreur