> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.umamy.io/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Umamy MCP # Umamy MCP > Connectez Claude, ChatGPT et d'autres outils d'IA à vos hunts Umamy via MCP. Interrogez vos candidats, parcourez vos messages, obtenez des analytics de hunt et agissez sur votre pipeline depuis vos assistants IA préférés. Connectez vos outils d'IA à votre compte Umamy avec Umamy MCP. Une fois connecté, vous pouvez : parcourir vos hunts et leur configuration, rechercher dans vos candidats, lire les conversations et notes, obtenir des analytics sur votre funnel de sourcing, et répondre à des questions sur votre pipeline — directement depuis Claude, ChatGPT ou tout autre outil d'IA compatible MCP. Nous prenons actuellement en charge uniquement l'authentification via OAuth navigateur. Pour un accès programmatique de serveur à serveur (ex. depuis un backend que vous contrôlez), utilisez plutôt les clés API de l'[API client Umamy](https://help.umamy.io/api). > **Beta :** Umamy MCP est généralement disponible en test. La disponibilité et les fonctionnalités peuvent évoluer. # Guide de configuration ## Pré-requis * Un compte Umamy avec au moins un hunt * Un outil d'IA compatible MCP, comme Claude ou ChatGPT > Vous aurez besoin d'un compte Claude ou ChatGPT payant pour ajouter des connecteurs MCP personnalisés. Voir ci-dessous les paliers spécifiques. ## Comment connecter ### Claude > Les connecteurs personnalisés ne sont disponibles que sur les plans Claude payants. Sur les plans Team ou Enterprise, votre administrateur peut avoir besoin d'approuver les connecteurs personnalisés ou de connecter Umamy à votre place. 1. Ouvrez Claude et connectez-vous (claude.ai ou l'app desktop). 2. Allez dans **Paramètres** → **Connecteurs**. 3. Cliquez sur **Ajouter un connecteur personnalisé** et collez `https://api.umamy.io/mcp` comme URL du serveur. 4. Cliquez sur **Connecter**, connectez-vous avec votre compte Umamy dans la fenêtre qui s'ouvre, et autorisez la connexion. 5. Assurez-vous que le connecteur Umamy est activé pendant vos conversations. ### ChatGPT > Les connecteurs personnalisés ChatGPT ne sont disponibles que sur les plans Plus, Pro, Business ou Enterprise. 1. Ouvrez ChatGPT et connectez-vous. 2. Allez dans **Paramètres** → **Connecteurs**. 3. Cliquez sur **Ajouter un serveur MCP** et collez `https://api.umamy.io/mcp`. 4. Autorisez la connexion dans la fenêtre du navigateur qui s'ouvre. 5. Vous pouvez maintenant référencer Umamy dans ChatGPT — par exemple, demandez « résume mon dernier hunt » et ChatGPT appellera les outils Umamy MCP. ### Claude Code 1. Lancez `claude` dans votre terminal. 2. Ajoutez le connecteur : ```bash claude mcp add umamy --transport http https://api.umamy.io/mcp ``` 3. Ouvrez un nouvel onglet de terminal et relancez `claude`. 4. Lancez `/mcp`, sélectionnez **umamy**, puis choisissez **Authenticate**. 5. Connectez-vous avec votre compte Umamy dans la fenêtre du navigateur, puis demandez à Claude de référencer vos hunts. ### Autres outils d'IA Vous pouvez vous connecter manuellement au serveur Umamy MCP en utilisant l'URL publique `https://api.umamy.io/mcp` comme connexion personnalisée. Votre outil d'IA doit prendre en charge : * **Le protocole client MCP** avec le [transport Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http). * **L'authentification OAuth 2.0** — le serveur utilise OAuth dans le navigateur, donc votre outil doit pouvoir ouvrir une fenêtre de navigateur pour que l'utilisateur se connecte à Umamy. Après la connexion, l'outil reçoit un bearer token à inclure dans les requêtes suivantes. Chaque utilisateur s'authentifie individuellement via le flux OAuth navigateur. Il n'existe pas d'accès par clé API ou compte de service pour MCP — voir l'[API client Umamy](https://help.umamy.io/api) pour ce cas. # Outils et descriptions | Outil | Description | Exemple de prompt | | ---- | | `list_organizations` | Liste toutes les organisations Umamy auxquelles vous appartenez. C'est toujours le point d'entrée — utilisez l'`organization_id` retourné pour tous les autres appels. | « Dans quelles organisations Umamy suis-je ? » | | `list_hunts` | Liste les hunts d'une organisation avec leur statut, le nombre de candidats et la configuration clé. Filtrable par statut (DRAFT / LIVE / PAUSED / COMPLETED). | « Quels hunts sont en LIVE en ce moment ? » | | `get_hunt` | Retourne la configuration complète d'un hunt : persona, profil cible, mapping ATS et stats actuelles du pipeline. | « Donne-moi tout sur le hunt X. » | | `get_hunt_configuration` | Retourne les critères de recherche, les séquences et le persona expéditeur d'un hunt — utile pour auditer ou cloner la configuration. | « Comment est configuré le hunt sales EU ? » | | `get_organization_metrics` | Funnel agrégé pour toute l'organisation : hunts par statut de cycle de vie, comptages cross-hunts. | « Donne-moi un état rapide du pipeline de toute mon organisation. » | | `get_hunt_metrics_timeseries` | Métriques en série temporelle pour un hunt (ou toute l'organisation) sur une plage de dates — candidats sourcés, demandes de connexion envoyées/acceptées, messages, etc. | « Trace les connexions acceptées des 30 derniers jours sur le hunt X. » | | `get_hunt_metrics_distribution` | Métriques de distribution — statut pipeline, score, années d'expérience, sentiment, tags — pour un hunt ou toute l'organisation. | « Quelle est la répartition du funnel sur le hunt X ? » | | `list_candidates` | Liste paginée des candidats dans un hunt ou dans toute l'organisation, filtrable par statut de connexion ou de pipeline. Retourne URLs LinkedIn, noms, entreprise actuelle, état pipeline. | « Montre-moi 50 candidats qui ont accepté mais n'ont pas répondu sur le hunt X. » | | `get_candidate` | Retourne le profil complet d'un candidat : données LinkedIn, justification du score, état pipeline. | « Donne-moi plus de détails sur le candidat Y. » | | `get_candidate_messages` | Tous les messages entrants et sortants échangés avec un candidat, dans l'ordre. | « Qu'est-ce que j'ai dit en dernier au candidat Y et qu'a-t-il répondu ? » | | `list_candidate_notes` | Notes laissées sur un candidat (les vôtres et celles de vos coéquipiers). | « Quelles notes a-t-on sur le candidat Y ? » | # Guide de dépannage ## Limites de débit Les limites dépendent de votre plan Umamy et de l'outil d'IA utilisé. Par défaut, environ 100 requêtes par minute toutes outils confondus, sous réserve de modifications. Si vous les atteignez régulièrement, contactez le support. ## Les outils MCP ne fonctionnent pas Si votre agent IA dit qu'il ne peut pas accéder à Umamy ou utiliser les outils MCP, ré-authentifiez-vous : 1. Déconnectez le connecteur Umamy dans votre outil d'IA. 2. Reconnectez-le et complétez à nouveau le flux OAuth. 3. Retestez avec un prompt simple comme « Dans quelles organisations Umamy suis-je ? » ## Claude affiche « No tools available » Si Umamy est connecté dans Claude mais qu'il affiche **No tools available**, reconnectez le connecteur pour réinitialiser la session : 1. Allez sur les [paramètres de connecteurs Claude](https://claude.ai/customize/connectors) dans votre navigateur. Vous devez le faire sur claude.ai même si vous utilisez l'app desktop. 2. Sélectionnez **Umamy**. 3. Cliquez sur le menu trois points en haut à droite et choisissez **Disconnect**. 4. Sans rafraîchir la page, choisissez à nouveau **Connect** et complétez l'authentification. > Sur un plan Claude Team ou Enterprise, vous pourriez avoir besoin d'un administrateur pour déconnecter et reconnecter Umamy. ## « Unauthorized » ou « no organization found » après la connexion Si vous voyez ça après le flux OAuth, vous vous êtes peut-être connecté avec un email différent de celui de votre compte Umamy, ou vous n'appartenez plus à aucune organisation. Pour vérifier l'email utilisé par votre compte Umamy, ouvrez Umamy et regardez votre compte en bas à gauche de la sidebar. Reconnectez MCP avec exactement cet email. ## MCP ne trouve aucun de mes hunts ou candidats Si votre outil d'IA ne renvoie aucun résultat alors que vous savez que des données existent, MCP est peut-être connecté au mauvais compte Umamy ou vous interrogez la mauvaise organisation. Demandez à votre outil d'IA : **« Dans quelles organisations Umamy suis-je ? »** — il appellera `list_organizations` et retournera la liste. Ensuite : * **Bon compte, mauvaise organisation** : passez le bon `organization_id` dans le prompt suivant (ex. « liste les candidats dans l'organisation `` »). * **Mauvais compte entièrement** : déconnectez et reconnectez le connecteur avec le bon login Umamy. ## Connecté au mauvais compte dans Claude Si vous avez connecté Claude à Umamy en étant connecté au mauvais compte Umamy : 1. Allez sur [claude.ai/customize/connectors](https://claude.ai/customize/connectors). 2. Trouvez et déconnectez le connecteur Umamy. 3. Reconnectez-le avec le bon compte Umamy. # FAQ générale ## Dois-je utiliser la même adresse email pour mon outil d'IA et Umamy ? Non — vous pouvez utiliser des comptes différents. Pendant le flux OAuth, vous authentifiez le compte Umamy au nom duquel votre outil d'IA agira. ## Pourquoi mon outil d'IA ne voit-il pas un hunt ou un candidat spécifique ? Umamy MCP applique les mêmes règles d'accès que l'app web : vous ne voyez que les hunts dans les organisations dont vous êtes membre, et les candidats à l'intérieur. Si un hunt est dans une autre organisation à laquelle vous n'appartenez pas, il n'apparaîtra pas. ## Je viens d'upgrader mon plan — quand aurai-je accès aux outils supplémentaires ? L'upgrade prend effet immédiatement. Votre prochaine requête MCP utilisera les outils et limites du nouveau plan. ## Ai-je besoin d'un client ID ou d'un client secret ? Non. Umamy MCP utilise OAuth navigateur avec Dynamic Client Registration (DCR), donc les identifiants sont gérés automatiquement. Si une plateforme tierce affiche des champs client ID et client secret, laissez-les vides — la plateforme s'enregistrera automatiquement auprès d'Umamy. ## Puis-je connecter Umamy MCP à mon propre outil d'IA interne ? Oui — tout outil implémentant la [spécification client MCP](https://modelcontextprotocol.io/) avec le transport Streamable HTTP peut se connecter. Votre outil doit gérer le flux d'authentification OAuth 2.0 navigateur pour que chaque utilisateur puisse se connecter à son compte Umamy. Voir l'[API client](https://help.umamy.io/api) si vous avez besoin d'un flux non interactif de type compte de service. Pour de l'aide sur une intégration personnalisée, contactez [support@umamy.io](mailto:support@umamy.io).