API Meridian et Skill Claude

L'API Meridian expose les données CRM de votre organisation via REST — opportunités, propositions, projets, base de connaissances — authentifiées par une clé personnelle qui hérite de vos permissions (et uniquement des vôtres).

Différence avec l'API Router

L'API Router (/api/v1/chat/completions, /api/v1/embeddings, etc.) est une passerelle IA compatible OpenAI. Les clés Router sont liées à l'organisation.

L'API Meridian (/api/meridian/v1/*) donne accès aux ressources CRM. Les clés Meridian sont liées à l'utilisateur : elles héritent exactement de vos rôles et permissions au moment de chaque requête. Si votre accès est révoqué dans Meridian, la clé cesse de fonctionner immédiatement.

Obtenir une clé API

1. Connectez-vous à Meridian.
2. Allez à Paramètres → Intégrations.
3. Sur la carte « API Meridian & Skill Claude », cliquez + Nouvelle clé API.
4. Donnez-lui un nom (claude-skill, script-reporting, etc.).
5. Copiez la clé immédiatement — elle n'est affichée qu'une seule fois.

export MERIDIAN_API_KEY="votre-clé-ici"

Vous pouvez avoir jusqu'à 50 clés actives. Révoquez les clés inutilisées depuis la même page.

Authentification

Toutes les requêtes utilisent un header Authorization: Bearer :

curl https://meridian.signalorange.ca/api/meridian/v1/me \
  -H "Authorization: Bearer $MERIDIAN_API_KEY"

Réponse :

{
  "data": {
    "user": {
      "id": 42,
      "email": "[email protected]",
      "name": "Alice",
      "is_super_admin": false
    },
    "organization": { "id": 7, "name": "Acme", "slug": "acme" },
    "permissions": ["crm_read", "crm_write", "proposals_read", "proposals_write"],
    "api_key": { "id": 3, "name": "claude-skill", "kind": "meridian" }
  }
}

Le champ permissions liste exactement ce que votre clé peut faire (les super-admins reçoivent ["*"]). Ce n'est pas un secret — c'est votre propre profil de permission. La réponse contient aussi organization (incluant catalogues et statuts configurés) ; consultez la documentation interactive pour le schéma complet.

Limites de taux

300 requêtes par minute par clé. En cas de dépassement, vous recevez HTTP 429 avec un header Retry-After.

Documentation interactive (Swagger)

La référence complète est disponible à :

/api/meridian/docs/

Vous pouvez y tester chaque endpoint directement depuis le navigateur en collant votre clé dans le champ « Authorize ».

Skill Claude

Le Skill Claude est un paquet zip que vous installez dans votre client Claude. Une fois installé, vous pouvez interroger et agir sur votre organisation Meridian directement dans une conversation Claude — en tant que vous-même, avec vos permissions.

Installer le Skill

1. Allez à Paramètres → Intégrations.
2. Cliquez Télécharger le Meridian Skill (.zip) (fichier meridian-code-skill-<version>.zip).
3. Dans votre client Claude, importez le fichier zip.
4. Lors de l'activation, le Skill demande votre clé API. Collez la valeur de MERIDIAN_API_KEY.

Le Skill contient une référence API générée automatiquement depuis la spec OpenAPI en vigueur — il est toujours synchronisé avec la version déployée.

Pour Claude.ai, Claude Desktop et Claude Cowork, ajoutez plutôt le connecteur MCP distant : dans Claude → Paramètres → Connecteurs → Ajouter un connecteur personnalisé, collez l'URL https://meridian.signalorange.ca/api/meridian/mcp puis connectez-vous avec votre compte Meridian. Aucun téléchargement requis.

Exemples d'utilisation

Requête directe (curl) :

curl https://meridian.signalorange.ca/api/meridian/v1/opportunities \
  -H "Authorization: Bearer $MERIDIAN_API_KEY" \
  -G -d "status=open&limit=10"

Via le Skill Claude :

« Montre-moi les 5 opportunités les plus récentes avec leur valeur estimée et leur étape dans le pipeline. »

Claude appelle l'API à votre place, formate les résultats et peut enchaîner : créer une note, générer un résumé ou préparer un courriel de suivi.

Et après ?

• Paramètres → Intégrations — gérer vos clés et télécharger le Skill
• Documentation API interactive — tous les endpoints avec schémas et exemples
• Assistant IA — Vue d'ensemble — autres façons d'utiliser l'IA dans Meridian
• Router — Démarrage rapide — si vous avez besoin de l'API LLM compatible OpenAI