Documentation Skalin

Serveur MCP

Serveur MCP

Skalin expose votre espace de travail aux agents IA via le Model Context Protocol (opens new window) (MCP). Claude, ChatGPT, Cursor, Copilot ou votre propre agent lit le même contexte Customer Success que l'IA de Skalin — comptes, healthscore, usage produit, thèmes Voice of Customer, renouvellements, tâches — et propose des actions qu'un utilisateur Skalin valide dans l'application.

Point d'accès : https://mcp.skalin.io/mcp (Streamable HTTP).

# Connexion

  1. Créez une clé API dans Skalin : Paramètres › Intégrations › Clés API. Vous obtenez un identifiant (skm_…) et un secret (sks_…), affiché une seule fois.
  2. Donnez à votre agent le point d'accès et l'identifiant sous forme d'en-tête : Authorization: Bearer skm_xxx.sks_yyy.

Claude Code :

claude mcp add --transport http skalin https://mcp.skalin.io/mcp --header "Authorization: Bearer skm_xxx.sks_yyy"
1

Cursor (.cursor/mcp.json) :

{
  "mcpServers": {
    "skalin": {
      "url": "https://mcp.skalin.io/mcp",
      "headers": { "Authorization": "Bearer skm_xxx.sks_yyy" }
    }
  }
}
1
2
3
4
5
6
7
8

L'identifiant est aussi accepté en HTTP Basic (skm_xxx:sks_yyy), ou sous forme de jeton obtenu auprès de https://auth.skalin.io/oauth/token avec grant_type=client_credentials et audience=https://mcp.skalin.io/.

Connecteurs Claude.ai et ChatGPT

Ils exigent OAuth avec enregistrement dynamique des clients, prévu dans une prochaine version. Aujourd'hui, la connexion passe par un outil qui accepte des en-têtes statiques (Claude Code, Cursor, un framework d'agents).

# Ce que l'agent peut faire

Lire — tous les outils qu'utilise l'IA de Skalin : chercher des comptes, lire le contexte et l'historique de healthscore d'un compte, son usage et l'activité de ses contacts, ses interactions et ses insights ; classer le portefeuille par usage, lister les renouvellements à venir, les comptes sans contact récent, les comptes churnés, les tâches ouvertes ; explorer les thèmes Voice of Customer et leurs verbatims.

Proposer — créer ou mettre à jour une tâche, commenter une tâche ou une interaction, activer un playbook, ajuster le CSM Pulse, remplacer les tags d'un compte, d'un contact ou d'une interaction. Aucune de ces actions n'écrit quoi que ce soit : l'outil valide la demande contre vos données et enregistre une proposition. Un utilisateur de votre espace l'applique ou la refuse depuis Mes actions › Propositions des agents. L'agent reçoit un proposal_id et peut en suivre le sort avec get_proposal.

Ressources — skalin://customer/{id}/context, /healthscore, /insights, /interactions, /alerts, skalin://topics, skalin://portfolio/renewals.

Prompts — prepare_meeting, portfolio_triage, voice_of_customer, ainsi que les prompts enregistrés dans votre espace et partagés avec tous.

# Périmètre, limites et audit

  • Une clé API voit tout son espace de travail, comme l'API d'intégration. Il n'y a pas de périmètre par utilisateur : l'agent agit pour l'espace, c'est pourquoi il ne peut que lire et proposer.
  • Quotas : 120 requêtes par minute et par espace, 5 000 par jour et par clé. Au-delà, le serveur répond 429 avec un en-tête Retry-After.
  • Chaque appel est journalisé — quelle clé, quel outil, quels paramètres (jamais les résultats). Les administrateurs le consultent dans Paramètres › IA.
  • Une proposition que personne ne traite expire après 14 jours. La même proposition envoyée deux fois par un agent renvoie le même proposal_id (duplicate: true), jamais une seconde carte.
Contributeurs: Julien