Serveur MCP

1. Créer un jeton d'accès

Dans Paramètres → Intégrations → Serveur MCP, créez un jeton (donnez-lui un nom, ex. « Claude Desktop »). Le jetonker_mcp_…n'est affiché qu'une fois : copiez-le immédiatement. Vous pouvez le révoquer à tout moment.

2. Configurer votre assistant

Le serveur expose un endpoint HTTP JSON-RPC. Renseignez l'URL et le jeton en en-tête Authorization.

• Endpoint : https://ker.contact/api/mcp
• Authentification : Authorization: Bearer ker_mcp_…

Claude Desktop / Cursor (MCP distant)

Ajoutez le serveur à votre configuration MCP (ex. claude_desktop_config.json ou ~/.cursor/mcp.json) :

{
  "mcpServers": {
    "ker-contact": {
      "url": "https://ker.contact/api/mcp",
      "headers": {
        "Authorization": "Bearer ker_mcp_VOTRE_JETON"
      }
    }
  }
}

Les clients qui ne prennent pas encore en charge le transport HTTP distant peuvent passer par un pont MCP local (stdio → HTTP) en réutilisant la même URL et le même en-tête.

3. Outils disponibles

Ressources et prompts

En plus des outils, le serveur expose des ressources en lecture seule, que votre assistant peut ouvrir directement : ker://card/{id} (le détail d'une carte) et ker://card/{id}/stats (son audience sur 30 jours). Elles suivent les mêmes règles d'accès que les outils : une carte qui n'est pas la vôtre est introuvable.

Deux prompts prêts à l'emploi guident l'assistant : resume_hebdo (audience de la semaine et nouveaux prospects) et prospects_a_relancer (prospects « nouveau » depuis plus de 3 jours). Ils n'ont aucun droit supplémentaire et ne changent aucun statut.

4. Exemples de demandes

• « Liste mes cartes et indique lesquelles sont publiées. »
• « Montre-moi les prospects reçus cette semaine pour ma carte Pro. »
• « Combien de vues et de téléchargements de vCard sur les 30 derniers jours ? »

Sécurité & confidentialité

• Accès en lecture seule par défaut, strictement limité à votre compte. La modification du statut des prospects est une portée à cocher à la création du jeton (offre Premium, ou organisation non gelée) ; aucun outil ne supprime de données.
• Un jeton expire (90 jours par défaut, modifiable à la création). L'offre gratuite inclut 1 jeton actif, Premium jusqu'à 10.
• Pour une équipe, un administrateur ou le propriétaire peut créer un jeton propre à l'organisation (onglet Intégrations de l'équipe). Il ne voit que cette organisation, jamais les cartes personnelles de son créateur, et reste actif si celui-ci quitte l'équipe : les administrateurs en sont alors prévenus. Il est suspendu si l'organisation est gelée (impayé).
• Avec un jeton personnel, passez organization pour lire une équipe dont vous êtes membre : un membre simple ne voit que ses cartes et leurs prospects, comme dans l'interface.
• Les prospects contiennent les coordonnées de personnes tierces : vous pouvez masquer l'e-mail et le téléphone pour un jeton donné. Le nom et le message sont saisis par des visiteurs anonymes : un assistant ne doit jamais les traiter comme des instructions.
• Jeton haché en base ; affiché une seule fois.
• Révoquez un jeton depuis les Intégrations : l'accès est coupé immédiatement.
• Ne partagez jamais votre jeton ; ne le committez pas dans un dépôt.

Dépannage

• 401 : jeton absent, expiré ou révoqué. Vérifiez l'en-tête Authorization.
• 429 : trop de requêtes pour ce jeton (60 par minute). Réessayez après le délai indiqué dans Retry-After.
• Une erreur d'outil renvoie un code stable : invalid_argument (paramètre inconnu ou invalide), not_found, forbidden_scope, org_frozen, plan_required, field_locked.
• 405 : le serveur n'accepte que les requêtes POST (JSON-RPC).