Model Context Protocol

Serveur MCP FindJob

Quinze outils pour mener une recherche d’emploi depuis un agent : constituer une base d’entreprises, rédiger des candidatures, lancer et suivre des campagnes d’envoi depuis la boîte Gmail de l’utilisateur.

https://www.findjob.tech/api/mcp

OAuth 2.1 + PKCE S256Streamable HTTPRFC 7591 · DCRRFC 9728MPP

Connexion

Claude

Réglages → Connecteurs → Ajouter, puis collez l’URL du serveur. L’enregistrement du client et le flow OAuth se font automatiquement.

ChatGPT

Paramètres → Applications → Ajouter une application, même URL.

Client générique

{
  "mcpServers": {
    "findjob": {
      "type": "http",
      "url": "https://www.findjob.tech/api/mcp"
    }
  }
}

Découverte disponible à /.well-known/oauth-authorization-server et /.well-known/oauth-protected-resource. Un appel non authentifié répond 401 avec l’en-tête WWW-Authenticate qui déclenche le flow.

Les quinze outils

Trois portées d’autorisation. L’utilisateur voit ce qu’il accorde au consentement.

Lecture

read

get_startedÉtat du compte et prochaine étape concrète

auth_statusVérifie la connexion et rend le profil

list_cvsCV avec métier, secteur, niveau et compétences

list_companiesEntreprises avec statut de contact et signaux de recrutement

list_templatesMessages enregistrés

list_campaignsCampagnes avec leurs résultats d’envoi

gmail_statusConnexion Gmail et quota du jour

get_metricsEnvois, taux d’ouverture, villes

get_billing_statusPack actif, quotas, expiration

Écriture

write

search_companiesCherche par ville et remplit la base

generate_email_templateRédige un message à partir d’un CV

create_campaignCrée une campagne et sa sélection

start_checkoutPrépare l’achat d’un pack

Envoi

send

test_campaignExemplaire d’essai, hors quota

send_campaignEnvoi réel, après confirmation en deux temps

Ce qui protège l’utilisateur

Un envoi part chez de vrais destinataires, au nom de quelqu’un, avec son CV. C’est irréversible — le serveur est construit autour de cette contrainte.

Confirmation avant tout envoi

send_campaign n’envoie jamais au premier appel : il décrit ce qui partirait et rend un jeton valable dix minutes. Le périmètre vient du jeton, pas des arguments du second appel.

Destinataires non transmissibles

Aucune liste de destinataires ne passe par les arguments. La sélection est lue sur la campagne, en base — un identifiant inventé fait échouer la création entière.

Quotas et plafonds

Les quotas du plan s’appliquent aux appels d’agent comme au site. Chaque outil coûteux a son propre plafond par fenêtre glissante.

Révocation immédiate

L’utilisateur voit les applications connectées dans ses réglages et coupe l’accès en un clic. Un jeton révoqué cesse d’être accepté au premier appel suivant.

Limites connues

Import du CV — fichier binaire, il passe par le site. Tout l’aval dépend d’un cv_id.
Connexion Gmail — OAuth à trois pattes, elle exige un navigateur. Sans elle, les outils d’envoi refusent.
Paiement — page hébergée par le prestataire. Le protocole MPP permet à un agent équipé d’un portefeuille de régler sans navigateur ; il reste expérimental côté Stripe.
Couverture géographique — le catalogue d’entreprises couvre Paris et l’Île-de-France, Lyon et Lille. Ailleurs, la recherche se lance depuis le site.

Le parcours est donc hybride : démarrage sur le site, pilotage quotidien depuis l’agent.

Voir ce que ça donne à l’usage Créer un compte