Serveur Curriculo ATS MCP

On this page

Retour rapide
Connectez un client
L' authentification
Résumé des outils
Exemples de requêtes
FAQ et résolution des problèmes
La sécurité

Connectez votre Curriculo ATS à Claude, Cursor et tout client MCP qui parle Streamable HTTP, ou à ChatGPT via un GPT personnalisé. Demandez en langage clair pour examiner les candidats, déplacer les pipelines, répondre aux candidats, planifier des entretiens et tirer des analyses. Votre client AI fait le travail directement dans votre ATS.

Point final	Transports	Auteur	Les champs d'application	Les outils
`https://mcp.curriculo.me/mcp`	HTTP diffusée	OAuth 2.1, ou un jeton d'accès personnel	`ats:read`, `ats:write`	25

Le serveur est distant et hébergé, donc il n'y a rien à installer ou à exécuter localement. Pointez n'importe quel client MCP au point final, authentifiez une fois, et le client obtient des outils qui lisent et agissent sur vos données d'embauche en temps réel.

Un produit différent du public API, avec une authentification différente. MCP parle à Curriculo ATS et l'utilisateur se connecte. Un API public key_ n'atteint pas ces outils, et le API public n'atteint pas votre ATS.

Retour rapide

Utilisez ce point final partout:

https://mcp.curriculo.me/mcp

Le chemin le plus rapide est le flux de connecteur de Claude:

Ouvrez Claude, puis Paramètres, puis Connecteurs.
Cliquez sur Ajouter le connecteur personnalisé et coller le serveur URL ci-dessus.
Remplissez la fiche de connexion OAuth lorsque cela vous est demandé. Claude est connecté à votre organisation.
Commencez une conversation et demandez, par exemple: " Qu'est-ce qui se passe dans chaque étape de mes rôles ouverts ? "

Vous êtes nouveau ici ? Suivez le tutoriel étape par étape: exécutez votre ATS en Claude, avec des captures d'écran qui vous permettent de connecter, de classer les candidats par AI et de planifier des entretiens à partir d'un chat.

Connectez un client

Tout client qui parle Streamable HTTP fonctionne. Authentifier avec OAuth 2.1 ou avec un jeton d'accès personnel envoyé dans une en-tête Authorization: Bearer . La configuration pour les clients communs suit.

Claude

Dans Claude (web ou bureau), allez à Paramètres,Connecteurs,Ajouter un connecteur personnalisé, puis entrez:

https://mcp.curriculo.me/mcp

Cliquez sur Ajouter, complétez la connexion OAuth, puis ouvrez le connecteur pour activer les outils spécifiques que vous voulez que Claude utilise.

Code de Claude

Ajoutez le serveur avec une seule commande. OAuth s' ouvre dans votre navigateur via /mcp:

claude mcp add --transport http curriculo https://mcp.curriculo.me/mcp

Ou passer un jeton d'accès personnel directement avec une 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 le login OAuth.

Cursor

Ouvrez les paramètres Cursor,Tools & MCP,Nouveau serveur MCP et ajoutez cela à mcp.json:

{
  "mcpServers": {
    "curriculo": {
      "url": "https://mcp.curriculo.me/mcp"
    }
  }
}

Le curseur montre que a besoin de. Cliquez dessus pour exécuter le flux de consentement OAuth, et les outils deviennent verts.

Code VS et autres clients

Tout client sans support distant natif 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 GPT personnalisées)

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éez une nouvelle action.

Importer le schéma de ce URL:

https://mcp.curriculo.me/api/v2/mcp/openapi.json

Réglez Authentification à OAuth, avec ces valeurs du schéma:

Réglage La valeur
Autorisation URL https://mcp.curriculo.me/api/v2/ats/oauth/authorize
Le jeton URL https://mcp.curriculo.me/api/v2/ats/oauth/token
La portée ats:read ats:write (ou seulement ats:read)
Enregistrez, puis connectez-vous à Curriculo et approuvez l'accès lorsque le GPT appelle une action.

Réglage	La valeur
Autorisation URL	`https://mcp.curriculo.me/api/v2/ats/oauth/authorize`
Le jeton URL	`https://mcp.curriculo.me/api/v2/ats/oauth/token`
La portée	`ats:read ats:write` (ou seulement `ats:read`)

L' authentification

Il y a deux façons d'authentifier. Les deux résolvent à un utilisateur dans une organisation avec des autorisations de portée.

OAuth 2.1 (recommandé)

Les clients interactifs (Claude, Cursor, ChatGPT) utilisent OAuth 2.1 avec le flux de code d'autorisation. L'enregistrement client dynamique est pris en charge, PKCE (S256) est requis pour les clients publics et les URIs de redirection doivent être https. Vous vous connectez à Curriculo, approuvez la connexion, et le client stocke un jeton de courte durée qu'il renouvelle automatiquement. Il n'y a pas de secrets à copier ou à tourner à la main. Les métadonnées du serveur sont publiées à https://mcp.curriculo.me/.well-known/oauth-authorization-server.

Token d'accès personnel

Pour les configurations CLI ou sans tête, générez un jeton dans le ATS et envoyez-le comme en-tête de support:

Connectez-vous à ats.curriculo.me.
Allez aux paramètres ****,API et intégrations,Tokens d' accès personnel.
Créez un jeton, choisissez son champ d'application et copiez-le. Il est montré une fois.
Passez-le comme Authorization: Bearer <token>, comme indiqué dans les étapes d'installation ci-dessus.

Les champs d'application

Les jetons portent une ou les deux portées. Donnez seulement ce dont vous avez besoin.

La portée	Permet
`ats:read`	Liste et lecture des emplois, candidats, boîte de réception, entrevues et analyse.
`ats:write`	Créer et modifier des données: déplacer des étapes, envoyer des courriels, planifier des entretiens, mettre à jour des emplois.

Vous ne savez pas qui est un symbole ? Appelez l'outil whoami . Il renvoie l'utilisateur authentifié, l'organisation, la méthode d'autorisation et les champs d'application accordés.

Résumé des outils

Vingt-cinq outils. Le type d'accès vous indique le risque:

Je ne lis que les regards de .
Écrire changements de données ATS.
Write+ modifie les données et arrive à l'extérieur: un e-mail s'en va, une invitation est envoyée ou un travail AI commence.

Dix-sept des vingt-cinq outils sont uniquement lus. Les six outils Write+ ont des conséquences extérieures, et l'assistant confirme l'intention avant de les utiliser. Aucun outil ne supprime rien.

Les emplois

Outil	Accès	Ce qu'il fait	Paramètres
`list_jobs`	Lisez	Liste d'emplois dans votre organisation, récemment mis à jour en premier. Filtre d'état facultatif.	`status`, `page`, `limit`
`get_job`	Lisez	Détail complet pour un emploi, y compris les étapes de l'entonnoir et le nombre de candidats.	`jobId` (obligatoire)
`create_job`	Écrivez	Il crée un emploi et l'ouvre immédiatement: il est en direct et accepte des candidatures, pas un projet. Les étapes par défaut sont les prospects + demandes, le dépistage, l'entrevue, l'offre. Il suffit d'un titre.	`title` (obligatoire), `description`, `location`, `type`, `headcount`, `must_have_skills`, `preferred_skills`, `salary_min`, `salary_max`, `salary_currency`
`update_job_status`	Écrire +	Modifie le statut d'un emploi (DRAFT, OPEN, PAUSED, CLOSED, ARCHIVED). La fermeture ou l'arrêt peuvent être envoyés par e-mail aux candidats qui n'ont pas atteint l'offre, lorsque les avis de candidature sont activés; les candidats non abonnés et les candidats à l'entretien en direct sont ignorés. Utilisez-le délibérément.	`jobId`, `status` (les deux sont nécessaires)

Les candidats

Outil	Accès	Ce qu'il fait	Paramètres
`list_applicants`	Lisez	Liste des candidats, optionnellement pour un emploi, avec des filtres étoilés, rejetés et archivés.	`jobId`, `starred`, `rejected`, `archived`, `page`, `limit`
`get_applicant`	Lisez	Un candidat complet: étape actuelle, lien d'emploi, notes et antécédents d'activité.	`applicantId` (obligatoire)
`search_candidates`	Lisez	Recherche en langage simple dans toute la piscine de candidats. Retourne les correspondances classées avec les passages CV et le raisonnement derrière chacun.	`query` (obligatoire), `jobId`, `timestamp`, `page`, `limit`
`move_applicant_stage`	Écrire +	Ça fait passer quelqu'un à un autre stade. Activer les automatisations de cette étape; atteindre l'Offre peut fermer automatiquement l'emploi une fois le nombre d'employés atteint.	`applicantId`, `funnelId` (obligatoire), `reason`
`add_applicant_note`	Écrivez	Ajout d'une note, optionnellement marquée par une décision PASS ou FAIL et la ronde à laquelle elle appartient. Privé par défaut.	`applicantId`, `content` (obligatoire), `noteType`, `decisionFlag`, `roundName`
`get_applicant_resume_text`	Lisez	Le contenu CV analysé sous forme de texte et de champs, sans fichier attaché.	`applicantId` (obligatoire)
`get_applicant_evaluation`	Lisez	L'évaluation AI: score d'adéquation, étiquettes, résumé et lacunes.	`applicantId` (obligatoire)
`reprocess_resume`	Écrire +	Retourne le pipeline AI complet sur un CV (analyse, évaluation, indexation). Il court en arrière-plan.	`applicantId` (obligatoire)

La boîte de réception et le courrier électronique

Outil	Accès	Ce qu'il fait	Paramètres
`get_applicant_email_thread`	Lisez	La conversation complète avec un candidat, dans les deux sens.	`applicantId` (obligatoire)
`list_inbox_emails`	Lisez	Liste de courrier entrant, filtré par poste, statut ou recherche de texte.	`jobId`, `status`, `search`, `page`, `limit`
`get_inbox_stats`	Lisez	On ne lit pas les chiffres et les totaux.	aucun
`reply_to_applicant_email`	Écrire +	Réponses sur le fil existant, de la boîte aux lettres envoyée par Curriculo ou de la boîte aux lettres de votre organisation qui a reçu la conversation. Aucune connexion à la boîte aux lettres n'est nécessaire.	`applicantId`, `body` (obligatoire), `subject`
`send_bulk_email`	Écrire +	Envoie un message à un ou plusieurs candidats, pour obtenir des mises à jour de portée ou de statut, depuis la boîte aux lettres de Curriculo. Aucune connexion à la boîte aux lettres n'est nécessaire.	`applicantIds`, `subject`, `messageBody` (tous requis)

Des entrevues

Outil	Accès	Ce qu'il fait	Paramètres
`list_interviews`	Lisez	Liste des entretiens par emploi, candidat, statut, type ou date.	`jobId`, `applicantId`, `status`, `type`, `dateFrom`, `dateTo`, `page`, `limit`
`schedule_interview`	Écrire +	Enregistrer l'entrevue, ajouter des intervieweurs et créer 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 via un calendrier Google, Microsoft Teams via un calendrier Microsoft. Le `meetingProvider: ZOOM` est stocké uniquement comme étiquette et ne génère aucun lien. L'entrevue est sauvegardée de toute façon.	`applicantId`, `jobId`, `title`, `scheduledStart`, `scheduledEnd` (obligatoire), `type`, `location`, `meetingProvider`, `participantIds`, `externalInterviewers`, `timezone`, `instructions`

L' analyse

Outil	Accès	Ce qu'il fait	Paramètres
`get_analytics`	Lisez	Total, changement de période sur période, ventilation des étapes, emplois de premier plan et mélange de sources. Les 30 derniers jours par défaut.	`dateFrom`, `dateTo`
`get_dashboard`	Lisez	La boîte de réception, plus une ventilation de l'entonnoir par emploi de tous les actifs actuellement.	aucun

Automatisations et importations

Outil	Accès	Ce qu'il fait	Paramètres
`list_job_automations`	Lisez	Liste des automatisations configurées dans un emploi: courrier électronique, planification des entretiens, étiquetage et notifications.	`jobId` (obligatoire)
`get_automation_executions`	Lisez	Faites un historique pour une automatisation.	`automationId` (obligatoire), `page`, `limit`
`get_import_batch`	Lisez	Progress de l'importation de candidat: état par fichier et éventuelles erreurs.	`batchId` (obligatoire)

Compte

Outil	Accès	Ce qu'il fait	Paramètres
`whoami`	Lisez	Confirme l'utilisateur et l'organisation que l'assistant est en train d'accomplir, en utilisant la méthode et les champs d'action attribués. Ça vaut la peine de courir en premier dans n'importe quelle session.	aucun

Les outils d'e-mail envoient depuis la boîte aux lettres de Curriculo, donc ils fonctionnent sans boîte aux lettres connectée. La planification des entretiens fonctionne également sans calendrier: elle conserve toujours l'entretien et rapporte que les invitations n'ont pas été envoyées.

Exemples de requêtes

Une fois connecté, demandez en langage clair. Le client choisit les bons outils.

"Montrez-moi ce qui est assis dans chaque étape de mes rôles ouverts, et marquez tout ce qui est bloqué".
" Trouvez des ingénieurs Senior React avec une expérience de leader d'équipe et résumons les cinq premiers. "
"Monte Priya à une deuxième interview et rédige une réponse demandant sa disponibilité la semaine prochaine".
"Préparez une interview vidéo de 45 minutes avec ce candidat jeudi à 14h 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 mieux converti?"

Les outils d'écriture ont de réels effets secondaires: envoyer des courriels, changer de pipeline, fermer des emplois. Gardez les approbations des outils activées pour les actions d'écriture jusqu'à ce que vous ayez confiance dans un flux de travail, et accordez uniquement ats:read si vous voulez juste l'analyse.

FAQ et résolution des problèmes

Dois-je installer ou héberger quelque chose ? - Je ne sais pas. Le serveur est entièrement hébergé à https://mcp.curriculo.me/mcp. Pointez votre client à la URL et authentifiez.

Quels clients sont pris en charge ? Tout client MCP qui prend en charge des serveurs distants sur Streamable HTTP, avec OAuth 2.1 ou un jeton d'accès personnel: Claude (web et bureau), Claude Code, Cursor, Code VS et autres. Les clients sans support à distance natif peuvent utiliser le pont mcp-remote . ChatGPT se connecte à travers un Custom GPT avec Actions.

Mes outils montrent "Needs login" ou ne se connecteront pas. Réinitialisez le flux OAuth (dans le code Claude, tapez /mcp; dans Cursor, cliquez sur Needs login). Si vous utilisez un jeton d'accès personnel, confirmez que l'en-tête est exactement Authorization: Bearer <token> et que le jeton n'a pas été révoqué ou expiré.

Les outils de courrier électronique ont-ils besoin d'une boîte aux lettres connectée? - Je ne sais pas. send_bulk_email et reply_to_applicant_email envoient 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 reçoit la conversation. Pour envoyer à partir de votre propre adresse en général, voir le guide de configuration de l'agent de messagerie .

Le schedule_interview crée des liens Zoom ? - Je ne sais pas. Les liens vidéo proviennent d'un calendrier connecté: Google Meet avec Google, Microsoft Teams avec Microsoft. Sans calendrier, l'interview est enregistrée sans lien.

Comment limiter ce que le AI peut faire ? Émettez un jeton avec seulement ats:read pour l'accès à l'analyse uniquement, et 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 attaché à votre jeton. Appelez whoami pour confirmer l'utilisateur, l'organisation et la portée à tout moment.

La sécurité

Accès scanner. Chaque jeton est lié à un utilisateur et à une organisation et porte des champs explicites ats:read ou ats:write . Tout ce que l'assistant voit est limité à votre propre organisation.
Le moindre privilège. Accordez la portée la plus étroite qui fait le travail; préférer les jetons uniquement lus pour l'analyse.
Vous pouvez annuler à tout moment. Les jetons d' accès personnels peuvent être révoqués dans Paramètres,API & Integrations. Les connexions OAuth peuvent être supprimées des paramètres du connecteur de votre client.
Sécurité des transports. Tout le trafic est HTTPS sur Streamable HTTP. Ne collez jamais un jeton dans des clients non fiables ou ne le partagez jamais en texte ordinaire.

Une partie du hub Curriculo ATS MCP, qui relie les guides d'installation, la référence des outils et les documents de connexion.

Updated 12 October 2026