serveur Curriculo ATS MCP
Sur cette page
Connectez votre Curriculo ATS à Claude, Cursor et tout client MCP qui parle HTTP Streamable ou à ChatGPT via un GPT personnalisé. Demandez en langage clair pour examiner les candidats, déplacer les pipelines, répondre aux candidats, programmer les entrevues et tirer l'analyse. Votre client AI effectue le travail directement dans votre ATS.
| Point d'arrivée | Politique des transports | Resp.: Ministère de l'Environnement | Portée | Outils |
|---|---|---|---|---|
https://mcp.curriculo.me/mcp | HTTP en continu | OAuth 2.1, ou un jeton d'accès personnel | ats:read, ats:write | 25 |
Le serveur est distant et hébergé, il n'y a donc rien à installer ou à exécuter localement. Pointez n'importe quel client MCP au point final, authentifiez une fois, et le client gagne des outils qui lisent et agissent sur vos données d'embauche en temps réel.
Un produit différent du API public avec une authentification différente. MCP parle à Curriculo ATS et l'utilisateur se connecte. Un API
key_public n'atteint pas ces outils, et le API public n'atteint pas votre ATS.
Quel est le serveur Curriculo ATS MCP ?
Le serveur Curriculo ATS MCP est un terminal hébergé, https://mcp.curriculo.me/mcp, qui permet à Claude, ChatGPT, Cursor et d'autres clients MCP de lire et d'agir sur votre Curriculo ATS. Vous vous connectez une fois avec OAuth ou un jeton d'accès personnel, puis demandez en langage clair pour examiner les candidats, déplacer les étapes, répondre aux candidats ou programmer des entrevues.
Démarrage rapide
Utilisez ce paramètre dans chaque client MCP :
https://mcp.curriculo.me/mcpLe trajet le plus rapide est le débit de connecteur de Claude:
- Ouvrez Claude, puis Personnalisez, puis connecteurs.
- Cliquez sur Ajouter le connecteur personnalisé et coller le serveur URL ci-dessus.
- Remplissez le OAuth s'il est demandé de signer . Claude se connecte à votre organisation.
- Commencez une conversation et demandez, par exemple, « Qu'est-ce qui est assis à chaque étape de mes rôles ouverts ? »
Nouveau ici ? Suivez le tutoriel étape par étape : lancez votre ATS en Claude, qui passe par la connexion, le classement des candidats par AI et la planification des entretiens depuis un chat.
Connexion d'un client
Tout client qui parle Streamable HTTP fonctionne. Authentifier avec OAuth 2.1 ou avec un jeton d'accès personnel envoyé dans un en-tête Authorization: Bearer . La configuration pour les clients communs suit.
Claude
Dans Claude (web ou bureau), allez dans Personnalisez,Connecteurs,Ajouter connecteur personnalisé, puis entrez:
https://mcp.curriculo.me/mcpCliquez sur Ajouter, compléter la connexion OAuth, puis ouvrir le connecteur pour activer les outils spécifiques que vous souhaitez utiliser Claude.
Code Claude
Ajoutez le serveur avec une seule commande. OAuth ouvre dans votre navigateur via /mcp:
claude mcp add --transport http curriculo https://mcp.curriculo.me/mcpOu passez un jeton d'accès personnel directement avec un en-tête:
claude mcp add --transport http curriculo https://mcp.curriculo.me/mcp \
--header "Authorization: Bearer YOUR_CURRICULO_PAT"Exécutez /mcp à l'intérieur du code Claude pour vérifier l'état ou déclencher la connexion OAuth.
Cursor
Ouvrir Personnaliser dans la barre latérale de Cursor et ajouter ceci à mcp.json:
{
"mcpServers": {
"curriculo": {
"url": "https://mcp.curriculo.me/mcp"
}
}
}Cursor affiche Besoins de connexion. Cliquez dessus pour exécuter le flux de consentement OAuth, et les outils deviennent verts.
Code VS et autres clients
Tout client sans prise en charge Native distante MCP peut utiliser le pont mcp-remote :
{
"mcpServers": {
"curriculo": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.curriculo.me/mcp"]
}
}
}Pour authentifier sans tête, ajoutez un argument d'en-tête :
"args": ["-y", "mcp-remote", "https://mcp.curriculo.me/mcp",
"--header", "Authorization: Bearer YOUR_CURRICULO_PAT"]ChatGPT (actions personnalisées GPT)
ChatGPT se connecte à travers un GPT personnalisé avec Actions, en utilisant une surface REST qui reflète les 25 outils MCP.
Dans ChatGPT, créez un GPT et ouvrez Configurez, puis Actions, puis Créer une nouvelle action.
Importer le schéma de ce URL:
https://mcp.curriculo.me/api/v2/mcp/openapi.jsonDéfinir Authentification à OAuth, avec un client ID et secret de
https://mcp.curriculo.me/api/v2/ats/oauth/registeret ces valeurs du schéma:Réglage Valeur Autorisation URL https://mcp.curriculo.me/api/v2/ats/oauth/authorizeJeton URL https://mcp.curriculo.me/api/v2/ats/oauth/tokenPortée ats:read ats:writeEnregistrer, puis se connecter à Curriculo ATS et approuver l'accès lorsque le GPT appelle d'abord une action.
Authentification
Deux façons d'authentifier. Tous deux se résolvent à un utilisateur dans une organisation.
OAuth 2.1 (recommandé)
Les clients interactifs (Claude, Cursor, ChatGPT) utilisent OAuth 2.1 avec le flux de code d'autorisation. L'enregistrement dynamique des clients est pris en charge, PKCE (S256) est requis pour les clients publics, et rediriger les URI doit être https. Vous vous connectez à Curriculo ATS, approuvez la connexion, et le client stocke un jeton de courte durée qui se rafraîchit automatiquement. Avec Claude et Cursor il n'y a aucun secret à copier ou à faire tourner à la main. Les métadonnées du serveur sont publiées à l'adresse suivante: https://mcp.curriculo.me/.well-known/oauth-authorization-server.
Jeton d'accès personnel
Pour les configurations CLI ou sans tête, générer un jeton dans le ATS et l'envoyer en tant qu'en-tête du porteur:
- Connectez-vous à ats.curriculo.me.
- Allez dans les paramètres ****,Développeurs,Jetons d'accès personnels.
- Créez un jeton, choisissez son expiration et copiez-le. Il est montré une fois.
- Passez-le comme
Authorization: Bearer <token>, comme indiqué dans les étapes de configuration ci-dessus.
Portée
Les jetons portent un ou les deux champs.
| Portée | Permet |
|---|---|
ats:read | Lister et lire les emplois, les candidats, les boîtes de réception, les entrevues et l'analyse (pas encore mis en œuvre : n'importe quel jeton peut utiliser chaque outil). |
ats:write | Créer et modifier des données : déplacer des étapes, envoyer des courriels, programmer des entrevues, mettre à jour des emplois. |
Tu ne sais pas qui fait ça ? Appelez l'outil
whoami. Il retourne l'utilisateur authentifié, l'organisation, la méthode d'authentification et les champs d'application accordés.
Référence des outils
Vingt-cinq outils. Le type d'accès vous indique le risque :
- Lire semble seulement.
- Écrire modifie les données ATS.
- Write+ modifie les données et atteint l'extérieur : un e-mail quitte, une invitation est envoyée, ou un travail AI démarre.
Dix-sept des vingt-cinq outils sont en lecture seule. Les sept outils Write+ ont des conséquences extérieures; si l'assistant confirme l'intention avant de les utiliser dépend de votre client. Aucun outil ne supprime un enregistrement, mais reprocess_resume écrase l'évaluation AI stockée.
Emploi
| Outil | Accès | Ce qu'il fait | Paramètres |
|---|---|---|---|
list_jobs | Lire | Liste les emplois dans votre organisation, les plus récents d'abord. Filtre d'état facultatif. | status, page, limit |
get_job | Lire | Détail complet pour un emploi, y compris les étapes d'entonnoir et le nombre de candidats. | jobId (obligatoire) |
create_job | Écrire+ | Crée un travail et l'ouvre immédiatement : il est en direct et accepte des applications, pas une ébauche. Les étapes par défaut sont les responsables + les demandes, la présélection, l'entrevue, l'offre. Seul un titre est requis. | title (obligatoire), description, location, locations, location_ack_required, type, work_mode, headcount, must_have_skills, preferred_skills, salary_min, salary_max, salary_currency, salary_period, salary_public, ask_salary, experience_min, experience_max, experience_public, ask_experience |
update_job_status | Écrire+ | Modification de l'état d'un emploi (DRAFT, OPEN, PAUSED, CLOSED, ARCHIVED). Il ne envoie pas de courriel aux candidats. Utilisez-le délibérément. | jobId, status (tous les deux requis) |
Demandeurs
| Outil | Accès | Ce qu'il fait | Paramètres |
|---|---|---|---|
list_applicants | Lire | Liste les candidats, en option pour un emploi, avec des filtres marqués, rejetés et archivés. | jobId, starred, rejected, archived, page, limit |
get_applicant | Lire | Un candidat complet : étape actuelle, lien de travail, notes et historique d'activité. | applicantId (obligatoire) |
search_candidates | Lire | Une recherche en langage clair sur vos candidats actifs. Retours classés correspondances avec les compétences et les faits appariés et le raisonnement derrière chacun. | query (obligatoire), jobId, timestamp, page, limit |
move_applicant_stage | Écrire+ | Il déplace quelqu'un sur une autre scène. Déclenche les automatismes de cette étape; atteindre l'offre peut fermer automatiquement le travail une fois le nombre de têtes est satisfait. | applicantId, funnelId (obligatoire), reason |
add_applicant_note | Écrire | Ajoute une note, éventuellement étiquetée avec une décision PASS ou FAIL et le tour auquel elle appartient. Privé par défaut. | applicantId, content (obligatoire), noteType, decisionFlag, roundName |
get_applicant_resume_text | Lire | Le contenu de CV analysé comme texte et champs, sans fichier joint. | applicantId (obligatoire) |
get_applicant_evaluation | Lire | L'évaluation AI : score de pertinence, étiquettes, résumé et état des lacunes. | applicantId (obligatoire) |
reprocess_resume | Écrire+ | Réexécute le pipeline AI sur un CV (évaluer, indexer; analyser seulement si ce n'est pas encore analysé). Il court en arrière-plan. | applicantId (obligatoire) |
Boîte de réception et courriel
| Outil | Accès | Ce qu'il fait | Paramètres |
|---|---|---|---|
get_applicant_email_thread | Lire | La conversation complète avec un candidat, les deux directions. | applicantId (obligatoire) |
list_inbox_emails | Lire | Listes de courrier entrant, filtrées par travail, statut ou recherche de texte. | jobId, status, search, page, limit |
get_inbox_stats | Lire | Traitement des comptes et des totaux. | aucune |
reply_to_applicant_email | Écrire+ | Réponses sur le thread existant, de la boîte aux lettres d'envoi de Curriculo ou de la boîte aux lettres de votre organisation qui a reçu la conversation. Aucune connexion mailbox n'est nécessaire. | applicantId, body (obligatoire), subject |
send_bulk_email | Écrire+ | Envoie un message à un ou plusieurs candidats, pour des mises à jour d'information ou d'état, à partir de la boîte aux lettres d'envoi de Curriculo. Aucune connexion mailbox n'est nécessaire. | applicantIds, subject, messageBody (toutes les données requises) |
Entretiens
| Outil | Accès | Ce qu'il fait | Paramètres |
|---|---|---|---|
list_interviews | Lire | Liste les entrevues par emploi, candidat, statut, type ou date. | jobId, applicantId, status, type, dateFrom, dateTo, page, limit |
schedule_interview | Écrire+ | Réalise l'entrevue, ajoute les intervieweurs et crée des liens de rétroaction. Avec un calendrier connecté, il crée également l'événement, invite le candidat et génère le lien vidéo: Google Meet à travers un calendrier Google, Microsoft Teams à travers un calendrier Microsoft. meetingProvider: ZOOM ne génère aucun lien Zoom. L'entrevue est sauvée de toute façon. | applicantId, jobId, title, scheduledStart, scheduledEnd (obligatoire), type, location, meetingProvider, participantIds, externalInterviewers, timezone, instructions |
Analyse
| Outil | Accès | Ce qu'il fait | Paramètres |
|---|---|---|---|
get_analytics | Lire | Totals, ventilation par étape, emplois de premier plan et combinaison de sources (tous les temps), plus variation de période sur période pour une plage de dates qui est par défaut à date mensuelle. | dateFrom, dateTo |
get_dashboard | Lire | Boîte de réception plus une panne d'entonnoir par emploi de tout le monde actuellement actif. | aucune |
Automatisations et importations
| Outil | Accès | Ce qu'il fait | Paramètres |
|---|---|---|---|
list_job_automations | Lire | Liste les automatismes configurés sur un travail : email, calendrier d'entretien, marquage et notifications. | jobId (obligatoire) |
get_automation_executions | Lire | Exécutez l'historique pour une automatisation. | automationId (obligatoire), page, limit |
get_import_batch | Lire | Progrès d'une importation de candidat : compte et toute erreur. | batchId (obligatoire) |
Compte
| Outil | Accès | Ce qu'il fait | Paramètres |
|---|---|---|---|
whoami | Lire | Confirme l'utilisateur et l'organisation que l'assistant agit comme, avec la méthode auth et les champs d'application accordés. Ça vaut le coup de courir en premier dans une session. | aucune |
Les outils d'email envoient depuis la boîte aux lettres de Curriculo, donc ils fonctionnent sans boîte aux lettres connectée. Le calendrier des entretiens fonctionne également sans calendrier : il enregistre toujours l'entretien, mais une entrevue vidéo ne reçoit aucun lien de rencontre et ses invitations ne sont pas envoyées.
Exemple d'invites
Une fois connecté, demandez en langage clair. Le client choisit les bons outils.
- "Montre-moi ce qui est assis à chaque étape de mes rôles ouverts, et signe tout ce qui est bloqué."
- "Trouvez les ingénieurs Senior React avec une expérience de chef d'équipe et résumez les cinq premiers."
- "Mouvez Priya à la deuxième entrevue et rédigez une réponse demandant sa disponibilité la semaine prochaine."
- "Planifiez une entrevue vidéo de 45 minutes avec ce candidat jeudi à 14h00 ET et ajoutez un lien Google Meet."
- « Comment le volume des candidats a-t-il changé par rapport au mois dernier, et quel emploi est le meilleur pour convertir? »




Les outils d'écriture ont de vrais effets secondaires : envoyer des courriels, changer de pipelines, fermer des emplois. Gardez les approbations d'outils sur pour écrire des actions jusqu'à ce que vous faites confiance à un workflow.
Sécurité
- Accès étendu. Chaque jeton est lié à un utilisateur et à une organisation. Tout ce que l'assistant voit est limité à votre propre organisation.
- Le moindre privilège. Scopes ne sont pas encore appliqués; éteignez les outils d'écriture dans les paramètres d'outil de votre client pour l'analyse.
- Révoque quand tu veux. Les jetons d'accès personnels peuvent être révoqués dans les paramètres ****,Développeurs. Les connexions OAuth peuvent être supprimées des paramètres de connecteur de votre client.
- Sécurité des transports. Tout le trafic est HTTPS au-dessus de HTTP. Ne collez jamais un jeton dans des clients méfiants ou ne le partagez pas en texte clair.
Partie du moyeu Curriculo ATS MCP, qui relie les guides de configuration, la référence des outils et les documents de connecteur.
Prochaines étapes
- Slack via MCP: utilisez ces outils de Slack.
- Guide de configuration de l'agent d'email: connectez votre boîte de réception et votre calendrier de location.
- Curriculo ATS MCP hub: guides de configuration et documents de connecteur.
FAQ et dépannage
Dois-je installer ou héberger quelque chose ?
C'est pas vrai. Le serveur est entièrement hébergé à https://mcp.curriculo.me/mcp. Pointez votre client au URL et authentifiez-le.
Quels sont les clients soutenus?
Tout client MCP qui prend en charge les serveurs distants sur HTTP Streamable avec OAuth 2.1 ou un jeton d'accès personnel : Claude (web et bureau), Claude Code, Cursor, VS Code et autres. Les clients sans support distant natif peuvent utiliser le pont mcp-remote. ChatGPT se connecte via un GPT personnalisé avec des Actions.
Mes outils montrent les besoins de connexion ou ne se connecteront pas.
Re-exécuter le flux OAuth (en code Claude, type /mcp; en Cursor, cliquez sur Besoins de connexion). Si vous utilisez un jeton d'accès personnel, confirmez que l'en-tête est exactement Autorisation: <token> et le jeton n'a pas été révoqué ou expiré.
Les outils de messagerie ont-ils besoin d'une boîte aux lettres connectée?
C'est pas vrai. send_bulk_email et reply_to_applicant_email envoyer depuis la boîte aux lettres de Curriculo. Une réponse sort de la boîte aux lettres de votre organisation lorsque cette boîte aux lettres a reçu la conversation. Pour envoyer à partir de votre propre adresse en général, consultez le guide de configuration de l'agent de messagerie.
Est-ce que Schedule_interview crée des liens Zoom ?
C'est pas vrai. Les liens vidéo proviennent d'un calendrier connecté : Google Rencontre avec Google, Microsoft Teams avec Microsoft. Sans calendrier, l'entrevue est enregistrée sans lien.
Comment limiter ce que le AI peut faire ?
Utilisez les paramètres d'autorisation par outil de votre client pour désactiver des outils d'écriture spécifiques.
Sur quelle organisation agit-elle?
Celui lié à votre jeton. Appelez whoami pour confirmer l'utilisateur, l'organisation et les champs d'application à tout moment.
Mis à jour le