# Se connecter au serveur MCP Coworkies

Source: https://docs.coworkies.com/fr/integrations/mcp/

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

> **My own jobs** est déployé pour Slack et le serveur MCP hébergé. Les intégrations clientes GPT/ChatGPT et Claude restent non testées et non déployées.

Le serveur MCP hébergé est déployé. **Le plugin GPT / ChatGPT et le connecteur Claude ne sont pas encore testés ni déployés.** Ce guide décrit le contrat du serveur pour les clients MCP compatibles ; ce n’est pas un guide d’installation vérifié dans ChatGPT ou Claude.

## Adresse et authentification

| Paramètre | Valeur |
| --- | --- |
| Adresse | `https://mcp.coworkies.com/mcp` |
| Transport | Streamable HTTP |
| Authentification | Autorisation OAuth du compte, ou clé API directe pour la découverte uniquement |
| Vérification de santé | `https://mcp.coworkies.com/healthz` |

L’authentification est obligatoire. Ne configurez pas d’accès anonyme ni d’authentification « None ». Un serveur sain ne valide pas l’authentification ou les outils d’un client.

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

Les écrans varient selon le client. Les parcours exacts dans GPT/ChatGPT et Claude restent à vérifier.

Pour les offres privées, choisissez **My own jobs** lors du consentement : seuls les postes créés par votre compte, sans espace associé, sont accessibles. Un compte actif et vérifié et les permissions demandées suffisent ; Pro n’est pas nécessaire. Si vous gérez exactement un espace Pro confirmé éligible, vous pouvez le choisir à la place. La sélection parmi plusieurs espaces Pro reste indisponible. Une connexion personnelle ne peut jamais gérer les offres d’un espace.

### 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](https://docs.coworkies.com/fr/spaces/api-keys/).

## 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. Cela limite le volume sans garantir que les annonces publiques ne peuvent pas être collectées.

Les clés directes utilisent les droits actuels de leur propriétaire retournés par l’API ; posséder une clé ne signifie pas être Pro. Les clés d’un compte gratuit ont les mêmes limites gratuites. Toutes les clés d’un propriétaire partagent son identité de limitation OAuth : plusieurs clés ou une rotation n’ajoutent pas de quota. Les métadonnées absentes ou invalides sont refusées. Les droits des clés sont vérifiés à chaque requête ; le niveau OAuth est établi au consentement, tandis que les droits d’opération privée sont vérifiés côté serveur. Les limites sont approximatives, pas un quota quotidien global strict.

## Permissions et outils disponibles

| Permission | Accès |
| --- | --- |
| `mcp:read` | Découverte publique via OAuth. |
| `jobs:read` | Offres privées et brouillons du compte personnel ou de l’espace choisi. |
| `jobs:write` | Aperçus et écritures ; les aperçus d’offres existantes nécessitent aussi `jobs:read`. |
| `offline_access` | Renouvellement des jetons, sans permission supplémentaire sur les offres. |

| Opération | Outils |
| --- | --- |
| Découvrir du contenu public | `search_jobs`, `get_career_board`, `list_cities`, `find_spaces`, `list_events`, `search_articles` |
| Lire les offres et brouillons du compte choisi | `list_my_jobs`, `get_my_job` |
| Créer une offre | `preview_job` → `create_job` |
| Modifier une offre | `preview_job_update` → `update_job` |
| Republier une offre | `preview_repost_job` → `repost_job` |
| Dépublier une offre | `preview_unpublish_job` → `unpublish_job` |

Les modifications de profil d’espace et d’offres commerciales sont désactivées dans la configuration actuelle. Les candidatures et offres enregistrées ne sont pas prises en charge. Un menu d’outils en cache ne remplace pas les permissions actuelles du serveur.

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

Le serveur exige un aperçu signé, mais celui-ci ne prouve pas qu’une personne l’a vérifié. L’assistant doit obtenir la confirmation ; l’expérience réelle de confirmation GPT/Claude reste non testée. Un contenu modifié exige un nouvel aperçu. Une révision périmée renvoie `409` : relisez l’offre et faites confirmer 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.

Des identifiants révoqués/expirés ou un compte désactivé arrêtent l’accès, y compris le renouvellement. La perte du rôle de gestion bloque les opérations privées. Pour une connexion liée à un espace, la perte de Pro bloque l’accès privé MCP même si les outils restent affichés ; la découverte peut continuer si le compte et la connexion restent valides. Slack et REST n’utilisent pas cette même condition Pro propre à MCP.

## Erreurs et nouvelles tentatives

| Réponse ou symptôme | Action |
| --- | --- |
| `401` | Vérifiez l’authentification, l’expiration et la révocation ; reconnectez-vous si nécessaire. |
| `403` | Vérifiez permissions, rôle et espace Pro éligible. Un contrôle de sécurité HTML n’est pas une réponse MCP réussie. |
| `409` | Relisez l’offre et créez un nouvel aperçu ; ne rejouez pas une ancienne modification. |
| `429` | Respectez `Retry-After` avant de réessayer. |
| Délai dépassé, réponse incomplète ou `5xx` après une écriture | Vé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.

## Conditions de lancement GPT et Claude

Ces deux intégrations clientes restent **pas encore testées ni déployées**. Avant de changer ce statut, vérifiez l’installation réelle, l’accord et l’annulation OAuth, les permissions, les outils, les aperçus et confirmations, les résultats réels, le renouvellement, les autorisations distinctes, la perte de rôle/Pro, la révocation et la reconnexion. La publication dans un annuaire est une étape distincte. Les tests locaux ou simulations de Worker ne suffisent pas.

Consultez les [Permissions](https://docs.coworkies.com/fr/integrations/permissions/) et la [Disponibilité et assistance](https://docs.coworkies.com/fr/integrations/).

## 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. Si le stockage des quotas est indisponible, les opérations sont refusées avec `503` ; la déconnexion reste possible. Les limites de découverte MCP et les crédits de publication payante sont distincts.

Le formulaire Slack et l’aperçu MCP proposent **Free** ou **Standard** (`listing_option: "free"` ou `"standard"`). Standard est la valeur par défaut. Free utilise l’annonce de base de 30 jours sans promotion payante ; Standard utilise un crédit disponible ou enregistre un brouillon nécessitant un paiement. Consultez toujours le résultat. MCP permet de modifier et republier les offres ; dans Slack, utilisez le formulaire, la liste des offres actives et la dépublication, puis [Mes offres](https://www.coworkies.com/jobs/my-jobs) pour les brouillons et les autres modifications.