ilicompta.lu

MODEL CONTEXT PROTOCOL · LUXEMBOURG

Connecter un agent au MCP Ilicompta Luxembourg

Utilisez https://ilicompta.lu/mcp avec un client MCP Streamable HTTP, sans compte, sans clé API et sans OAuth. Recherche et demandes de devis sont accessibles publiquement.

Documentation officiellev1.2.0

Accès public, sans authentification

Le serveur MCP https://ilicompta.lu/mcp est accessible publiquement. Tous les outils, y compris la préparation et l’enregistrement d’une demande de devis, fonctionnent sans compte, sans clé Bearer et sans OAuth. Aucun moyen de paiement n’est requis.

  • Ajouter l’URL https://ilicompta.lu/mcp dans un client prenant en charge MCP Streamable HTTP.
  • Choisir « Aucune authentification » ou « No authentication » lorsque le client propose un choix.
  • Avant toute demande de devis, recueillir l’email explicitement et faire confirmer au prospect le récapitulatif ainsi que le consentement.
  • Ne pas transmettre de documents comptables sensibles ni de données personnelles inutiles dans le texte de la demande.

Configuration minimale d’un client MCP

L’URL est la seule configuration du serveur. Le client peut conserver sa configuration habituelle pour l’ajout de serveurs MCP distants ; aucun champ headers ou secret n’est nécessaire.

{
  "mcpServers": {
    "ilicompta-luxembourg": {
      "url": "https://ilicompta.lu/mcp"
    }
  }
}

Le serveur ne connaît pas l’email du prospect et ne peut pas consulter ses autres conversations. L’agent doit lui demander son adresse avant de préparer une demande de devis ; aucune adresse n’est vérifiée automatiquement.

Exemple avec le SDK JavaScript MCP

Installer @modelcontextprotocol/sdk. Le code ci-dessous fonctionne sans variable secrète et réalise une recherche seule : aucun devis n’est préparé ou enregistré.

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({ name: 'mon-agent', version: '1.0.0' });
const transport = new StreamableHTTPClientTransport(new URL('https://ilicompta.lu/mcp'));
await client.connect(transport);
try {
  const { tools } = await client.listTools();
  console.log(tools.map(tool => tool.name));
  const result = await client.callTool({
    name: 'search_cabinets',
    arguments: {
      "query": "comptabilité et fiscalité pour une société",
      "filters": {
        "city": "Luxembourg",
        "services": [
          "comptabilite"
        ]
      },
      "limit": 3
    }
  }, undefined, { timeout: 300000 });
  if (result.isError) throw new Error('Recherche indisponible');
  console.log(result.structuredContent);
} finally {
  await client.close();
}

Le SDK réalise la négociation initialize et les notifications du protocole. Un GET dans le navigateur n’est pas un appel MCP. Le serveur n’expose pas dix routes REST séparées : tous les outils passent par tools/call sur le même endpoint.

Diagnostiquer une connexion

RéponseSignification et action
403Host ou Origin refusé. Utiliser le domaine officiel ; un client serveur peut omettre Origin.
405Méthode non prise en charge. Le transport utilise POST, pas un flux SSE GET.
413Corps supérieur à 64 Kio. Réduire la requête.
429Limite temporaire atteinte (par instance, par client ou par adresse email pour les brouillons). Respecter Retry-After et ne pas contourner les limites.
503Service non configuré ou temporairement indisponible. Réessayer plus tard, sans annoncer un résultat réussi.
MCP isError: trueUn outil a échoué même si HTTP a répondu 200. Examiner le contenu de l’erreur.

Le serveur limite les requêtes à 90 par minute et quatre traitements simultanés par instance ; il applique aussi une limite indicative par client et, pour les brouillons, une limite persistante de cinq par heure et douze par jour par adresse email. La limitation par instance ne protège pas à elle seule contre une attaque distribuée. La première recherche peut charger le modèle ; le délai de 300 secondes de l’exemple est une marge, pas une promesse de latence.

Fichiers et spécifications

Une question sur l’intégration ?

contact@ilicompta.lu · Aucune clé API nécessaire.

Documentation publiée par Ilicompta / NOGARET. Mentions légales