Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api-docs.jarvi.tech/llms.txt

Use this file to discover all available pages before exploring further.

Qu’est-ce que le MCP ?

Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants IA de se connecter à des outils et sources de données externes. Jarvi expose un serveur MCP pour que vous puissiez utiliser des assistants IA pour rechercher, lire et mettre à jour vos données Jarvi directement.

Clients compatibles

Tout client compatible MCP peut se connecter à Jarvi, notamment :

Configuration

Claude Desktop

Allez dans Paramètres > Connecteurs > Ajouter un connecteur personnalisé, entrez un nom (ex : “Jarvi”) et l’URL :
https://mcp.jarvi.tech
Claude Desktop gère l’authentification automatiquement via OAuth2 — vous serez redirigé pour vous connecter avec votre compte Jarvi.

Autres clients

Pour les clients qui ne supportent pas OAuth2, utilisez une clé privée d’API :
  • Transport : Streamable HTTP
  • URL : https://mcp.jarvi.tech
  • Authentification : header x-api-key avec votre clé privée d’API
Votre clé privée donne un accès complet à vos données Jarvi. Ne la partagez jamais publiquement.

Outils disponibles

Une fois connecté, les outils suivants sont disponibles pour votre assistant IA :
OutilDescription
whoAmIRetourne l’identité de l’utilisateur connecté (nom, email, workspace)
getStatusesLister les statuts disponibles pour les profils, entreprises ou projets
getCustomFieldsLister les champs personnalisés définis pour un type d’entité
getHistorySubtypesLister les sous-types personnalisés d’interactions (ex : catégories d’appels)
advancedSearchRechercher des profils, entreprises ou projets en langage naturel
getEntityDataRécupérer les données détaillées de profils, entreprises ou projets par IDs
getAgendaRécupérer les événements à venir des agendas connectés
getNotificationsRécupérer les notifications récentes de l’utilisateur
createProfileCréer un nouveau profil (talent et/ou contact)
createCompanyCréer une nouvelle entreprise
createProjectCréer un nouveau projet / mission de recrutement
associateProfilesLier un profil à un projet (talent ou contact) ou à une entreprise
createHistoryEntryAjouter une note ou un log d’appel à l’historique d’un profil
createTodoCréer un rappel/todo lié à un profil, entreprise ou projet
sendMessageEnvoyer des messages à un ou plusieurs profils (email, LinkedIn, WhatsApp, Telegram, SMS)
getMessageTemplatesLister les templates de messages disponibles (personnels et partagés par les collègues)
uploadFileUploader un fichier et le rattacher à une entité (profil, entreprise ou projet)
cancelScheduledMessagesAnnuler un ou plusieurs messages programmés
updateProfileMettre à jour un profil, ajouter des emails ou numéros de téléphone
updateCompanyMettre à jour une entreprise, changer le statut par nom, ajouter des emails
updateProjectMettre à jour un projet, changer le statut par nom, lier une entreprise
fillJobOfferGénérer ou affiner une offre d’emploi à partir des données du projet
getOutboxDiagnosticDiagnostiquer la boîte d’envoi : lister les messages programmés en attente avec statut et erreurs
retryOutboxTasksRelancer les tâches en erreur en réinitialisant leur statut
queryGraphQLExécuter des requêtes/mutations GraphQL sur les tables autorisées (vos permissions s’appliquent)
Toutes les opérations s’exécutent avec vos permissions. La sécurité au niveau des lignes s’applique — vous ne pouvez accéder qu’aux données auxquelles votre compte a accès.

Exemples de prompts

Une fois connecté, essayez de demander à votre assistant IA :
  • “Qui suis-je ?”
  • “Recherche des développeurs React à Paris”
  • “Montre-moi les détails du projet X”
  • “Crée un profil pour Jean Dupont, développeur”
  • “Positionne ce candidat sur le projet X”
  • “Mets le statut de l’entreprise Acme sur Qualifié”
  • “Quels champs personnalisés existent sur les profils ?”
  • “Note un appel avec Jean Dupont : a discuté de sa disponibilité”
  • “Rappelle-moi de relancer Acme lundi prochain”
  • “Mets à jour le titre de Jean Dupont en Développeur Senior”

Limites

  • Les mêmes limites d’utilisation s’appliquent : maximum 500 requêtes par jour.
  • Les opérations de suppression sont bloquées — utilisez la suppression douce (mise à jour de deletedAt) à la place.
  • Les réponses trop volumineuses sont automatiquement tronquées. Utilisez des arguments limit dans vos requêtes.
  • Les outils destructifs (mutations, lancement de campagne, relance de messages) nécessitent une confirmation de l’assistant IA avant exécution.