Intégration MCP

Cette page s’adresse aux développeurs qui connectent un client compatible MCP (Cursor, Claude Desktop, agents maison, etc.) à l’API de lomi. via notre serveur MCP.

Ce dont vous avez besoin côté organisation

• URL de base du MCP — ex. https://votre-mcp.example (hébergée par votre org ou URL partagée).
• Secret de transport (optionnel) — si LOMI_MCP_BEARER_TOKEN est défini sur le serveur, vous devez l’envoyer en en-tête Bearer (voir ci‑dessous).
• Clé API — secret lomi_* pour les appels d’outils (flux navigateur dans le tableau de bord ou Développeurs → Clés API).

Points de terminaison

Le chemin MCP peut différer si l’hôte définit un LOMI_MCP_HTTP_PATH personnalisé.

Authentification

Si un secret de transport est configuré sur le serveur :

• Envoyez Authorization: Bearer <secret-de-transport> (côté serveur, plusieurs valeurs peuvent être configurées pour la rotation ; vous ne recevez en général qu’une valeur à utiliser).
• Mettez votre clé marchande dans x-lomi-api-key ou x-api-key — ne comptez pas sur Authorization pour la clé marchande dans ce cas.

Si aucun secret de transport n’est configuré (plutôt rare en production) :

• Vous pouvez utiliser Authorization: Bearer <clé marchande lomi_*> pour des configs locales simples ; x-lomi-api-key reste préférable.

Obtenir une clé lomi_mcp_* (flux navigateur)

1. POST https://<projet-supabase>.supabase.co/functions/v1/mcp-auth/device-auth — sans corps. Conservez device_code, user_code, verification_uri.
2. Ouvrez verification_uri (chemin tableau de bord /connect/mcp-verify), connectez‑vous, saisissez user_code, autorisez.
3. POST https://<projet-supabase>.supabase.co/functions/v1/mcp-auth/token avec le JSON { "device_code": "<device_code>" } — interrogez en boucle jusqu’à obtenir { "api_key": "lomi_mcp_…" } (en attente : authorization_pending).
4. Configurez votre client MCP : x-lomi-api-key: <api_key> et Authorization: Bearer <secret-de-transport> si votre hôte MCP l’exige.

Vous pouvez aussi utiliser toute clé secrète valide depuis Développeurs → Clés API comme x-lomi-api-key.

Développement local (Cursor, stdio)

Compilez apps/mcp (pnpm install && pnpm run build), puis configurez Cursor pour pointer vers dist/index.js avec les variables LOMI_API_KEY (ou X_API_KEY) et LOMI_API_BASE_URL (https://api.lomi.africa ou https://sandbox.api.lomi.africa). Un exemple JSON se trouve dans le README du package dans le dépôt.

Sandbox

Les appels d’outils utilisent l’URL d’API configurée sur le serveur MCP (LOMI_API_BASE_URL). Pour des données sandbox, cette URL doit être https://sandbox.api.lomi.africa.