Aller au contenu

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éePolitique des transportsResp.: Ministère de l'EnvironnementPortéeOutils
https://mcp.curriculo.me/mcpHTTP en continuOAuth 2.1, ou un jeton d'accès personnelats:read, ats:write25

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/mcp

Le trajet le plus rapide est le débit de connecteur de Claude:

  1. Ouvrez Claude, puis Personnalisez, puis connecteurs.
  2. Cliquez sur Ajouter le connecteur personnalisé et coller le serveur URL ci-dessus.
  3. Remplissez le OAuth s'il est demandé de signer . Claude se connecte à votre organisation.
  4. 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/mcp

Cliquez sur Ajouter, compléter la connexion OAuth, puis ouvrir le connecteur pour activer les outils spécifiques que vous souhaitez utiliser Claude.

Compositeur de chat Claude ouvert aux connecteurs; Curriculo ATS listé parmi les connecteurs avec connecteur Add
Ajouter le connecteur Curriculo dans Claude: Personnaliser → Connecteurs → Ajouter un connecteur personnalisé.

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/mcp

Ou 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.

  1. Dans ChatGPT, créez un GPT et ouvrez Configurez, puis Actions, puis Créer une nouvelle action.

  2. Importer le schéma de ce URL:

    https://mcp.curriculo.me/api/v2/mcp/openapi.json
  3. Définir Authentification à OAuth, avec un client ID et secret de https://mcp.curriculo.me/api/v2/ats/oauth/register et ces valeurs du schéma:

    RéglageValeur
    Autorisation URLhttps://mcp.curriculo.me/api/v2/ats/oauth/authorize
    Jeton URLhttps://mcp.curriculo.me/api/v2/ats/oauth/token
    Portéeats:read ats:write
  4. Enregistrer, 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:

  1. Connectez-vous à ats.curriculo.me.
  2. Allez dans les paramètres ****,Développeurs,Jetons d'accès personnels.
  3. Créez un jeton, choisissez son expiration et copiez-le. Il est montré une fois.
  4. 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éePermet
ats:readLister 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:writeCré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

OutilAccèsCe qu'il faitParamètres
list_jobsLireListe les emplois dans votre organisation, les plus récents d'abord. Filtre d'état facultatif.status, page, limit
get_jobLireDé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

OutilAccèsCe qu'il faitParamètres
list_applicantsLireListe les candidats, en option pour un emploi, avec des filtres marqués, rejetés et archivés.jobId, starred, rejected, archived, page, limit
get_applicantLireUn candidat complet : étape actuelle, lien de travail, notes et historique d'activité.applicantId (obligatoire)
search_candidatesLireUne 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ÉcrireAjoute 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_textLireLe contenu de CV analysé comme texte et champs, sans fichier joint.applicantId (obligatoire)
get_applicant_evaluationLireL'é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

OutilAccèsCe qu'il faitParamètres
get_applicant_email_threadLireLa conversation complète avec un candidat, les deux directions.applicantId (obligatoire)
list_inbox_emailsLireListes de courrier entrant, filtrées par travail, statut ou recherche de texte.jobId, status, search, page, limit
get_inbox_statsLireTraitement 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

OutilAccèsCe qu'il faitParamètres
list_interviewsLireListe 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

OutilAccèsCe qu'il faitParamètres
get_analyticsLireTotals, 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_dashboardLireBoîte de réception plus une panne d'entonnoir par emploi de tout le monde actuellement actif.aucune

Automatisations et importations

OutilAccèsCe qu'il faitParamètres
list_job_automationsLireListe les automatismes configurés sur un travail : email, calendrier d'entretien, marquage et notifications.jobId (obligatoire)
get_automation_executionsLireExécutez l'historique pour une automatisation.automationId (obligatoire), page, limit
get_import_batchLireProgrès d'une importation de candidat : compte et toute erreur.batchId (obligatoire)

Compte

OutilAccèsCe qu'il faitParamètres
whoamiLireConfirme 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? »
Claude réponse avec l'analyse de recrutement: 5 emplois ouverts, 153 candidats par étape
Demandez le nombre de pipelines; le client appelle des outils d'analyse sur votre ATS.
Claude résumant dix candidats Senior Frontend avec des rôles et une expérience parsés
Résumez les candidats d'aujourd'hui pour un rôle avant de creuser dans des CV.
Claude confirme que deux candidats ont été transférés à la présélection et montre un courriel d'invitation à la présélection provisoire
Déplacer les candidats à la présélection et rédiger une invitation - n'envoyer qu'après avoir confirmé les adresses. La planification des entretiens nécessite un calendrier connecté Google ou Microsoft.
Claude propose trois questions de présélection fondées sur les projets de curriculum vitae d'un candidat
Générer des questions de sélection à partir du CV déjà dans le ATS.

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

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.

Cette page vous a-t-elle été utile ?

Mis à jour le