Vos contacts, là où vous travaillez.

Les contacts de votre carnet — ceux que le scanner a lus sur les cartes papier — sont accessibles par une API authentifiée par clé. Une clé appartient à un compte et ne donne accès qu'à ce compte : chaque requête est filtrée sur son propriétaire, sans exception.

Le connecteur MCP expose les mêmes données à un assistant. Vous demandez à Claude « qui ai-je rencontré au salon de mars et pas encore relancé », il interroge votre carnet et répond. C'est la même clé, les mêmes autorisations, et la même règle d'isolement.

Depuis votre espace client, section API. La clé s'affiche une seule fois, à sa création : nous n'en conservons que l'empreinte, pas la clé elle-même. Copiez-la à ce moment-là, ou créez-en une autre.

Une clé porte les autorisations que vous lui donnez :

• contacts:read — Lire les contacts du carnet
• contacts:write — Ajouter et modifier des contacts
• profil:read — Lire le profil public et ses statistiques

Une clé de lecture ne peut pas écrire, même si l'appel le demande. Révoquez-la depuis le même écran ; une clé révoquée ne redevient jamais valide.

Le Model Context Protocol permet à un assistant d'interroger vos outils. Notre serveur répond sur https://creativcard.fr/api/mcp, avec la même clé. Cette adresse ne changera pas : elle est indépendante de l'application qui répond derrière, et vous n'aurez pas à retoucher votre configuration.

Treize outils sont exposés :

• lister_contacts — Cherche dans le carnet, avec ses filtres.
• obtenir_contact — Un contact complet, par son identifiant.
• creer_contact — Ajoute un contact au carnet.
• modifier_contact — Met à jour une fiche existante.
• supprimer_contact — Retire un contact du carnet.
• lister_notes — Les notes attachées à un contact.
• creer_note — Consigne ce qui s'est dit, sur un contact.
• lister_taches — Ce qu'il reste à faire, par contact ou en entier.
• creer_tache — Ajoute une tâche, avec son échéance.
• terminer_tache — Marque une tâche comme faite.
• lister_echeances — Les relances qui arrivent, par date.
• lister_cartes — Les cartes de visite scannées.
• scanner_carte — Lit une carte photographiée et en tire un contact.

Ces deux-là ne proposent qu'un champ d'adresse, sans en-tête à remplir. La clé voyage donc dans l'adresse elle-même : ajoutez un connecteur personnalisé avec

https://creativcard.fr/api/mcp?cle=cc_votre_cle

et rien d'autre. Laissez les réglages avancés vides : aucun identifiant OAuth n'est nécessaire.

Une clé dans une adresse est moins bien protégée qu'un en-tête : elle se retrouve dans les journaux des serveurs traversés et dans l'historique de qui la colle. Créez-en une dédiée à cet usage, que vous pourrez révoquer seule si besoin — et préférez l'en-tête partout où votre outil sait le poser, comme Claude Code plus haut.

Les treize outils suffisent à travailler, mais un assistant qui les découvre improvise : il crée un contact sans consigner ce qui s'est dit, propose une relance sans lire les notes, ou rappelle quelqu'un qui vient de l'être. Une compétence lui donne la marche à suivre — dans quel ordre appeler les outils, quoi noter au moment d'ajouter un contact, ce qui mérite une confirmation avant d'être fait.

Elle tient en un fichier, à déposer dans les compétences de votre assistant :

Télécharger la compétence

Elle ne remplace pas le connecteur, elle l'accompagne : sans connecteur, elle n'a aucun outil à piloter.

L'application scanner sait pousser vos contacts vers une adresse de votre choix, au fil de l'eau ou selon une fréquence que vous réglez, avec correspondance des champs et signature du message. La configuration se fait depuis le scanner, pas par cette API.

C'est le chemin à préférer quand votre outil doit recevoir sans interroger : l'API sert à aller chercher, le webhook à être prévenu.

• Une clé ne voit qu'un compte. Chaque requête filtre sur son propriétaire. Un identifiant de contact appartenant à quelqu'un d'autre répond 404, pas 403 : l'API ne confirme pas son existence.
• La clé n'est jamais stockée. Seule son empreinte l'est. Perdue, elle se remplace ; elle ne se retrouve pas.
• Pagination : 50 contacts par défaut, 200 au plus par requête.
• HTTPS uniquement. Une clé envoyée en clair est une clé à révoquer.

Une question, un besoin que l'API ne couvre pas ? Écrivez-nous.