+170 XP

Des workflows réels avec les connecteurs

Les connecteurs prennent toute leur puissance quand vous les enchaînez : Claude lit votre agenda, voit que vous avez trois réunions demain, puis récupère les documents Drive pertinents et les emails récents pour vous briefer sur chacune. Une requête, plusieurs outils, une réponse nette. Cette leçon vise à rendre cette orchestration fiable plutôt qu'accidentelle.

Vous savez déjà ce qu'est un connecteur au niveau conceptuel. Ici, on entre dans le détail : **comment Claude *décide* quel connecteur utiliser, comment formuler vos requêtes pour qu'il choisisse les bons**, et comment construire un workflow reproductible de type « prépare-moi pour demain ».

Comment Claude choisit un outil

Quand vous activez des connecteurs sur Claude.ai (Paramètres, puis Connecteurs), chacun enregistre un ensemble d'outils avec leurs descriptions. Un connecteur Google Calendar expose des choses comme « lister les événements » et « obtenir les détails d'un événement ». Un connecteur Drive expose « rechercher des fichiers » et « lire un fichier ». En coulisses, c'est le même câblage Model Context Protocol que vous avez rencontré plus tôt : chaque connecteur est un serveur MCP, et les descriptions d'outils sont ce que Claude lit pour décider quoi appeler.

Ce dernier point compte plus qu'on ne le croit. Claude ne devine pas votre intention. Il confronte vos mots aux descriptions d'outils. Si votre requête est vague, il devine. Si votre requête nomme clairement le travail, le routage est correct.

Deux requêtes, même objectif, fiabilité très différente :

  • Faible : « Qu'est-ce qui se passe demain ? »
  • Forte : « Regarde mon agenda pour demain, puis pour chaque réunion cherche dans mon Drive et mes emails récents les documents liés. »

La seconde version indique à Claude la séquence (l'agenda d'abord, puis une recherche par réunion) et les sources (Drive, email). Vous n'écrivez pas de code, mais vous donnez un plan d'exécution en français courant.

Connectez ce dont vous avez vraiment besoin

Avant que le workflow tourne, vérifiez que les bons connecteurs sont activés et autorisés. Pour le workflow de préparation d'agenda, il vous faut en général :

  • Un connecteur agenda (Google Calendar via le connecteur Google Workspace)
  • Un connecteur documents (Google Drive)
  • Éventuellement un connecteur email (Gmail) pour le contexte des fils de discussion

Vous les activez depuis le répertoire de connecteurs sur Claude.ai. Anthropic maintient un ensemble croissant de connecteurs officiels et partenaires, consultables dans le répertoire des connecteurs Claude. Chacun passe par son propre consentement OAuth : vous accordez l'accès connecteur par connecteur, et vous pouvez en révoquer un plus tard sans toucher aux autres.

Le workflow « prépare-moi pour demain »

Voici la requête complète, écrite de la façon qui fonctionne réellement bien. Notez qu'elle est structurée mais conversationnelle.

Récupère tous mes événements Google Calendar pour demain. Pour chaque réunion, donne-moi : l'horaire, les participants, et un brief de préparation d'un paragraphe. Pour construire chaque brief, cherche dans mon Google Drive les documents liés au sujet de la réunion ou aux participants, et vérifie mes fils Gmail récents avec ces participants. Signale toute réunion pour laquelle tu n'as trouvé aucun élément d'appui, que je sache qu'il faut la préparer manuellement.

Ce que fait Claude, dans l'ordre :

  1. Il appelle l'outil agenda, limité à demain.
  2. Il relit la liste d'événements (titres, horaires, participants).
  3. Pour chaque événement, il lance une recherche Drive en utilisant le titre et les noms des participants comme termes de requête.
  4. Éventuellement, il vérifie dans Gmail les fils récents avec ces personnes.
  5. Il synthétise un brief par réunion et signale explicitement les manques.

La phrase « signale toute réunion pour laquelle tu n'as trouvé aucun élément d'appui » fait un vrai travail. Sans elle, Claude a tendance à combler le silence par des suppositions assurées. Avec elle, vous obtenez une carte honnête de ce qui est couvert et de ce qui ne l'est pas.

Pourquoi l'ordre des instructions compte

Les connecteurs fonctionnent en boucle, pas en un seul coup. Claude appelle un outil, lit le résultat, puis décide de l'appel suivant en fonction de ce qui est revenu. C'est pour cela que « l'agenda d'abord, puis une recherche par réunion » fonctionne : le résultat de l'agenda devient l'entrée qui façonne chaque requête Drive.

Si vous inversez l'ordre (« cherche dans mon Drive, puis regarde mon agenda »), Claude n'a encore rien *à* chercher : soit il vous demande de préciser, soit il produit un déversement générique. Séquencez votre requête comme les données circulent réellement.

Resserrer le brief avec les Projects et les Styles

Lancez ce workflow une fois, il marche. Lancez-le tous les matins et vous voudrez de la constance. Deux fonctionnalités déjà croisées plus tôt le rendent reproductible.

Les Projects permettent de sauvegarder le contexte du workflow. Créez un Project nommé « Daily Prep », déposez-y le contexte permanent (votre rôle, les noms de votre équipe, les clients récurrents, à quoi ressemble un bon brief pour vous), et les connecteurs restent disponibles à l'intérieur. Votre prompt du matin peut alors être court : « Lance ma préparation standard de demain. » Le Project porte le reste.

Les Styles contrôlent la *forme* de la sortie. Si vous définissez un Style qui dit « utilise des puces serrées, commence par la décision que je dois prendre, garde chaque brief sous 80 mots », chaque brief revient dans ce format sans que vous ayez à le répéter. Le Style gouverne le ton et la structure ; le Project gouverne le contexte et les connecteurs. Ils se cumulent.

Une configuration concrète :

text
Project: Daily Prep
  Custom instructions:
    - I'm a product lead at Acme. My recurring stakeholders are Dana (design),
      Raj (eng), and the Northwind client account.
    - For each meeting, lead with "Decision needed:" or "FYI only:".
    - When you find a Drive doc, cite its title so I can open it.
  Connectors enabled: Google Calendar, Google Drive, Gmail
  Style applied: "Exec Brief" (terse bullets, decision-first)

Ce n'est pas du code. C'est la configuration que vous posez une fois dans l'interface Claude.ai pour que le prompt quotidien tienne en une ligne.

Connect Claude to Your Apps with Connectors

Watch on YouTube

Quand vous voulez que ça tourne sans vous

Jusqu'ici, vous tapez encore le prompt du matin. La question suivante vient naturellement : est-ce que ça peut simplement *se déclencher* à 7h ? Aujourd'hui, les connecteurs sur Claude.ai sont interactifs : ils s'exécutent dans une conversation que vous lancez. Il n'y a pas de planificateur intégré « déclenche ceci à 7h chaque jour » dans l'application de chat elle-même.

C'est la frontière où vous passez de l'application Claude au Claude Agent SDK : la boîte à outils d'Anthropic pour construire des agents qui exécutent vos propres boucles, appellent le même type d'outils (y compris des serveurs MCP) et fonctionnent selon un calendrier ou un déclencheur que vous contrôlez. Vous avez rencontré le concept du SDK plus tôt ; le point pertinent ici est que la *logique de connecteur exactement identique* que vous avez prototypée dans le chat se transpose proprement, parce que les deux parlent MCP.

Une esquisse minimale de la même préparation d'agenda sous forme d'agent planifié, en utilisant l'API Messages avec des serveurs MCP attachés :

python
import anthropic

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=2048,
    mcp_servers=[
        {"type": "url", "name": "gcal", "url": "https://mcp.example.com/calendar"},
        {"type": "url", "name": "gdrive", "url": "https://mcp.example.com/drive"},
    ],
    messages=[{
        "role": "user",
        "content": (
            "Pull my calendar events for tomorrow. For each meeting, search "
            "Drive for related docs and write a one-paragraph prep brief. "
            "Flag any meeting with no supporting material."
        ),
    }],
    betas=["mcp-client-2025-04-04"],
)

print(response.content)

Notez que le prompt est presque identique à la version chat. La compétence acquise en formulant une bonne requête interactive se transfère directement à l'API. Vérifiez les noms de modèles actuels et l'en-tête beta MCP exact dans la documentation de l'API Messages avant de partir en production, car ces éléments évoluent.

Vérification des acquis

1. Selon la leçon, comment Claude décide-t-il réellement quel outil de connecteur utiliser pour une requête ?

2. Pourquoi la requête « Regarde mon agenda pour demain, puis pour chaque réunion cherche dans mon Drive et mes emails récents les documents liés » est-elle jugée plus forte que « Qu'est-ce qui se passe demain ? » ?

3. Quelle est la relation technique sous-jacente entre un connecteur Claude et le Model Context Protocol (MCP) ?

CHOIX MULTIPLES

4. Sélectionnez TOUTES les affirmations qui décrivent correctement le fonctionnement de l'autorisation des connecteurs sur Claude.ai.

Sélectionnez toutes les réponses correctes.

CHOIX MULTIPLES

5. Pour le workflow « prépare-moi pour demain », sélectionnez TOUS les connecteurs que la leçon recommande d'activer.

Sélectionnez toutes les réponses correctes.

Déboguer une chaîne qui déraille

Les workflows multi-connecteurs échouent de façon prévisible. Voici comment lire les symptômes.

Claude n'a utilisé qu'un seul connecteur. En général, la requête ne nommait pas la seconde source, ou le premier résultat semblait « assez complet » pour s'arrêter. Corrigez en étant explicite : « Pour *chaque* événement, cherche aussi dans Drive », avec le mot « chaque » et la seconde source nommée.

Claude a cherché dans Drive avec de mauvais termes. Il a utilisé le titre littéral de la réunion (« Sync ») et n'a rien trouvé d'utile. Donnez-lui de meilleurs points d'accroche : « Utilise les noms des participants et le nom du projet dans la description comme termes de recherche, pas seulement le titre de la réunion. »

Claude a inventé un document qui n'existe pas. C'est le cas dangereux. Cela signifie qu'une recherche n'a rien renvoyé et que le modèle a comblé le vide. Votre instruction « signale les réunions sans élément d'appui » est le garde-fou. Gardez-la dans chaque prompt de préparation.

Un connecteur a renvoyé une erreur d'authentification. Les tokens OAuth expirent. Réautorisez depuis Paramètres, puis Connecteurs. Claude vous dira en général quel connecteur a échoué ; sinon, demandez « quels appels de connecteurs ont échoué et pourquoi ? » et il rapportera directement les erreurs d'outils.

Cadrez vos permissions sérieusement

Chaque connecteur que vous activez est une autorisation d'accès permanente. Le workflow de préparation d'agenda n'a besoin que d'un accès en lecture à l'agenda, à Drive et à l'email. Il n'a jamais besoin de créer ou de supprimer quoi que ce soit. Quand un connecteur propose des scopes granulaires pendant l'OAuth, prenez la voie lecture seule. Vous pourrez toujours élargir plus tard. Un connecteur qui ne peut que lire ne peut pas envoyer par accident un email au mauvais client pendant qu'il « vous aide ».

Pousser le pattern plus loin

Une fois que « prépare-moi pour demain » est solide, le même pattern d'enchaînement s'étend naturellement :

  • Dossiers de pré-lecture : « Pour mon rendez-vous de 14h avec Northwind, récupère les trois derniers documents Drive qu'ils ont touchés et le fil d'emails le plus récent, et résume où nous en sommes restés. »
  • Rédaction de suivi : après une réunion, « Trouve le document de notes du jour dans Drive, puis rédige des emails de suivi à chaque participant avec ses actions. » (Attention, celui-ci nécessite un scope d'*écriture* sur l'email, à activer délibérément.)
  • Réconciliation entre sources : « Compare les dates du document de plan projet aux jalons de mon agenda et dis-moi ce qui est désynchronisé. »

Chacun de ces cas repose sur la même boucle : un connecteur produit la donnée d'ancrage, un autre l'enrichit, Claude synthétise. La seule chose qui change, ce sont les sources que vous nommez et dans quel ordre.

À retenir

  • Nommez la séquence et les sources. « Lis mon agenda, puis pour chaque réunion cherche dans Drive et les emails » route bien plus fiablement que « à quoi ressemble demain ? ». Les connecteurs sont choisis en confrontant vos mots aux descriptions d'outils.
  • Incluez toujours une instruction de signalement des manques. « Signale toute réunion pour laquelle tu n'as trouvé aucun élément d'appui » transforme une hallucination silencieuse en un rapport de couverture honnête.
  • Utilisez les Projects pour le contexte, les Styles pour la forme. Sauvegardez le workflow une fois dans un Project « Daily Prep » pour que votre prompt du matin tienne en une ligne, et laissez un Style imposer le format de sortie.
  • Accordez des scopes en lecture seule sauf si vous avez vraiment besoin d'écrire. Un connecteur en lecture seule ne peut pas déclencher d'actions en votre nom par erreur. N'élargissez l'accès que pour les workflows qui rédigent ou envoient.
  • Le même prompt passe à l'Agent SDK. Les exécutions interactives en chat sont parfaites pour le prototypage ; quand vous avez besoin d'exécutions planifiées et sans intervention, déplacez la logique MCP identique vers l'API Messages ou l'Agent SDK.

À faire, tiré de cette leçon

Ces actions sont compilées dans le plan d'action du rôle.

  • Accordez aux connecteurs des scopes en lecture seule et révoquez les tokens chez le fournisseur chaque trimestre
  • Nommez explicitement la séquence d'outils et les sources quand vous enchaînez des connecteurs
Voir le plan d'action complet →