Serveur MCP SYLI

Serveur Model Context Protocol : Cursor, Claude, ChatGPT (via un hôte MCP) et d’autres IA peuvent appeler l’API SYLI (checkout, paiements, devis, webhooks) avec votre clé syli_live_….

Ne mettez jamais la clé dans le chat. Elle passe par env du serveur MCP.

Outils

| Tool | Action | |---|---| | syli_status | Santé de l’API | | syli_list_currencies | Cryptos du compte (wallet validé, clé requise) | | syli_estimate | Estimation USDT → crypto | | syli_min_amount | Minimum d’encaissement | | syli_create_invoice | Checkout hébergé (invoice_url) | | syli_get_invoice | Lire une facture | | syli_create_payment | Paiement API (pay_address) | | syli_get_payment | Statut d’un paiement | | syli_verify_webhook | Vérifier x-syli-sig |

Prompt : syli_integrate_checkout.

Cursor

Dans Cursor Settings → MCP, ou fichier .cursor/mcp.json :

{
  "mcpServers": {
    "syli": {
      "command": "npx",
      "args": ["-y", "syli-mcp"],
      "env": {
        "SYLI_API_KEY": "syli_live_xxxxxxxx",
        "SYLI_API_URL": "https://syliagregateur.netlify.app/api/v1"
      }
    }
  }
}

Depuis ce dépôt (avant publication npm) :

{
  "mcpServers": {
    "syli": {
      "command": "node",
      "args": ["sdk/mcp/dist/index.js"],
      "env": {
        "SYLI_API_KEY": "syli_live_xxxxxxxx"
      }
    }
  }
}

Relancez Cursor, puis demandez par exemple : « Crée une facture SYLI de 20 USDT ».

Claude Desktop

Fichier claude_desktop_config.json (même bloc mcpServers que ci-dessus).

ChatGPT / Claude.ai

Ces produits parlent souvent à un MCP distant (HTTP). Ce paquet est un serveur stdio (processus local), le mode standard pour Cursor et Claude Desktop. Pour ChatGPT, installez-le dans un hôte local compatible MCP, ou hébergez plus tard un endpoint HTTP.

Variables d’environnement

| Variable | Rôle | |---|---| | SYLI_API_KEY | Clé syli_live_… (obligatoire sauf syli_status / estimate / min-amount). syli_list_currencies exige la clé. | | SYLI_API_URL | Défaut https://syliagregateur.netlify.app/api/v1 | | SYLI_IPN_SECRET | Secret webhook (optionnel, pour syli_verify_webhook) |

Build local

cd sdk/mcp
npm install
npm run build
node dist/index.js

Inspecteur :

npx @modelcontextprotocol/inspector node dist/index.js

Documentation API

https://syliagregateur.netlify.app/docs/api