Skip to main content
llms.txt

Se connecter au serveur MCP Coworkies

Configurez le serveur MCP, choisissez OAuth ou une clé API, vérifiez les espaces et permissions éligibles, puis confirmez un aperçu avant toute modification.

Le serveur MCP Coworkies vous permet de rechercher des annonces publiques ou de gérer vos offres depuis un client compatible. Coworkies ne propose actuellement ni plugin pour ChatGPT ni connecteur pour Claude.

Adresse et authentification

ParamètreValeur
Adressehttps://mcp.coworkies.com/mcp
TransportStreamable HTTP
AuthentificationAutorisation OAuth du compte, ou clé API directe pour la découverte uniquement
Vérification de santéhttps://mcp.coworkies.com/healthz

Choisissez OAuth pour connecter un compte Coworkies ou une clé API pour rechercher des annonces publiques.

Connexion par OAuth

  1. Dans un client compatible avec Streamable HTTP distant et OAuth, ajoutez l’adresse ci-dessus.
  2. Lancez l’autorisation et connectez-vous à votre compte Coworkies actif et vérifié.
  3. Vérifiez les permissions demandées et le compte de recrutement choisi sur Coworkies. Autorisez uniquement l’accès voulu, ou annulez.
  4. Revenez au client et vérifiez les outils réellement disponibles.
  5. Commencez par une lecture. Avant toute écriture, vérifiez et confirmez l’aperçu.

Lorsque Coworkies vous demande quel compte connecter, choisissez My own jobs pour gérer vos propres offres sans espace, ou sélectionnez un espace confirmé et ouvert dont vous êtes propriétaire ou membre de l’équipe. Le site affiche jusqu’à 20 espaces éligibles. Un espace gratuit ou dont la couverture Pro a expiré peut être sélectionné pour le recrutement. Le financement et les opérations privilégiées sur l’espace ont leurs propres conditions. Reconnectez-vous pour changer de compte.

Clé API directe

Dans les paramètres sécurisés du client, configurez soit Authorization: Bearer <votre-clé>, soit X-API-Key: <votre-clé>. Ne placez jamais la vraie clé dans une URL, une configuration partagée ou du code public de navigateur.

Cette méthode donne accès uniquement à la découverte publique. Les permissions d’écriture REST d’une clé n’accordent pas les outils privés MCP, qui nécessitent OAuth et un consentement personnel ou un espace éligible. « Publique » décrit les données, pas un accès anonyme. Consultez les Clés API.

Limites de découverte et clés API

Les comptes OAuth gratuits peuvent découvrir les offres publiques, avec une limite configurée de 20 requêtes par minute et 10 résultats par page.

Votre formule détermine la limite de recherche de vos clés API. Vos clés et vos connexions OAuth partagent cette limite. Créer ou renouveler une clé ne vous donne pas de requêtes supplémentaires. Si vous recevez une erreur 429, attendez le délai indiqué par Retry-After.

Permissions et outils disponibles

PermissionAccès
mcp:readDécouverte publique via OAuth.
jobs:readOffres privées et brouillons du compte personnel ou de l’espace choisi.
jobs:draft, jobs:publish, jobs:edit, jobs:lifecycleCréer un brouillon, publier ou republier, modifier ou retirer dans le compte choisi. Les anciennes autorisations jobs:write conservent leurs opérations.
Connexion actuelleSi disponible, get_connection_context indique les permissions effectives et les actions accessibles.
offline_accessRenouvellement des jetons, sans permission supplémentaire sur les offres.
OpérationOutils
Découvrir du contenu publicsearch_jobs, get_career_board, list_cities, find_spaces, list_events, search_articles
Lire les offres et brouillons du compte choisilist_my_jobs, get_my_job
Créer une offrepreview_job → create_job
Publier un brouillonpreview_publish_job → publish_job si disponibles
Modifier une offrepreview_job_update → update_job
Republier une offrepreview_repost_job → repost_job
Dépublier une offrepreview_unpublish_job → unpublish_job

Pour gérer des fiches d’espace, des lieux, des médias ou des offres commerciales, consultez les outils proposés après la connexion. Les outils disponibles dépendent de votre rôle et des permissions accordées.

Vérifier et confirmer chaque écriture

  1. Consultez le schéma de l’outil et réunissez les informations nécessaires. Utilisez les résultats de recherche de villes, sans inventer d’identifiants ni de slugs. contract et freelance sont distincts.
  2. Appelez l’outil d’aperçu correspondant.
  3. Présentez le contenu et les conséquences à l’utilisateur, notamment le compte de recrutement visé et le résultat prévu pour la publication ou le paiement.
  4. Obtenez sa confirmation avant l’outil d’écriture.
  5. Utilisez l’aperçu correspondant au même utilisateur, compte de recrutement, contenu et opération. Une offre existante nécessite aussi sa révision actuelle.
  6. Indiquez le résultat réel : publiée, brouillon, paiement nécessaire ou échec. Tout paiement se termine sur Coworkies.

Si le contenu change après la confirmation, demandez un nouvel aperçu et faites-le confirmer. Si vous recevez une erreur 409, relisez l’offre avant de demander le nouvel aperçu.

Durée de connexion et retrait d’accès

Les jetons d’accès durent une heure. Le renouvellement est limité à 30 jours d’inactivité et 90 jours au total. Autorisez à nouveau le client après expiration. Chaque autorisation OAuth a son propre identifiant : révoquer celle d’un client ne révoque pas les autres.

La révocation, l’expiration ou la désactivation du compte bloque aussi le renouvellement. La perte du rôle de gestion bloque les offres privées de l’espace. La fin de Pro peut désactiver les opérations privilégiées et suspendre les jetons manuels. Les droits de recrutement et le financement sont vérifiés séparément.

Erreurs et nouvelles tentatives

Réponse ou symptômeAction
401Vérifiez l’authentification, l’expiration et la révocation ; reconnectez-vous si nécessaire.
403Vérifiez la permission, le rôle actuel et le compte choisi. Les opérations privilégiées sur l’espace peuvent aussi exiger Pro.
409Relisez l’offre et créez un nouvel aperçu ; ne rejouez pas une ancienne modification.
429Respectez Retry-After avant de réessayer.
Délai dépassé, réponse incomplète ou 5xx après une écritureVérifiez les offres privées ou le tableau Coworkies avant de réessayer ; l’écriture a pu réussir.

La découverte publique peut avoir jusqu’à 300 secondes de retard pour les offres et 1 800 secondes pour les espaces. Les lectures privées ne sont pas mises en cache. Un résultat de recherche publique seul ne prouve pas l’échec d’une écriture.

Consultez les Permissions et la Disponibilité et assistance.

Recrutement individuel sans espace

Choisissez My own jobs lors de la connexion par compte. Seules les offres créées par votre utilisateur Coworkies sans espace associé sont accessibles. Le nom de l’entreprise, l’adresse de contact et l’adhésion à Slack ne donnent aucun droit sur les offres d’autrui. Une ancienne clé sans espace ne reçoit aucun nouvel accès ; les clés API manuelles restent une fonctionnalité des espaces Pro.

Les requêtes de recrutement personnel partagent 20 requêtes par minute et 1 000 par jour UTC par utilisateur, entre MCP et Slack, vérifications d’identité comprises. Renouveler une clé ou ajouter une connexion n’augmente pas cette limite. En cas d’erreur 429, attendez le délai indiqué par Retry-After. Les limites de découverte MCP et les crédits de publication payante sont distincts.

Pour créer une offre, choisissez listing_option: "free" ou "standard" dans preview_job, puis gardez la même valeur dans create_job. La valeur par défaut est "standard". Free publie une annonce de 30 jours sans promotion payante. Standard utilise un crédit de recrutement disponible ou conserve l’offre en brouillon en attendant le paiement sur Coworkies.