> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Lancer un audit de prospection pour un prospect avec MCP

> Créez un audit de prospection depuis un assistant MCP, relisez et enregistrez ses prompts, confirmez les crédits avec un jeton, puis lisez le rapport.

Préparez l’audit d’un prospect depuis une conversation : l’assistant crée l’audit et prépare les prompts, vous les relisez, et vous confirmez avant toute consommation de crédits. Ce guide utilise MCP. L’API REST propose le même cycle de vie dans [Créer un audit de prospection](https://docs.qwairy.co/fr/developers/endpoints/pitch-audits/create.md).

## Avant de commencer

Utilisez une équipe agence sur une offre Business, Agency Business ou Enterprise active. Connectez-vous avec le rôle Manager ou Propriétaire et accordez `read:pitch-audits` et `write:pitch-audits`. Si l’assistant recherche votre équipe avec `list_brands`, accordez aussi `read:brands`. Vous pouvez lui fournir directement l’identifiant de l’équipe. Consultez [l’authentification OAuth](https://docs.qwairy.co/fr/mcp/oauth.md).

## Étapes

1. Appelez [`create_pitch_audit`](https://docs.qwairy.co/fr/mcp/write/pitch-audits#create_pitch_audit) avec le `teamId` de l’agence, l’`url` du prospect, le marché `countryCode` et `promptCount: 30`. Laissez `autoStartResponses` désactivé pour relire les questions.
2. Suivez cet identifiant d’audit jusqu’à `AWAITING_PROMPTS`. Lisez le brouillon complet et sa `version` avec [`get_pitch_audit`](https://docs.qwairy.co/fr/mcp/tools/pitch-audits). Arrêtez le parcours si l’audit passe à `FAILED`.
3. Relisez les 30 prompts du point de vue du prospect. Dans cet exemple, vous en retirez deux. Transmettez **les 28 objets conservés**, avec leurs champs `id`, `text`, `category` et `topic`, à [`save_pitch_audit_prompts`](https://docs.qwairy.co/fr/mcp/write/pitch-audits#save_pitch_audit_prompts). Indiquez l’identifiant de l’audit, sa version sous la clé `expectedVersion`, et `dryRun: true`. Un nouveau brouillon accepte de 20 à 100 prompts.
4. **Approuvez le remplacement.** Renvoyez la même liste et la même version avec le `confirmationToken` de cet aperçu. Omettez `dryRun` ou passez-le à `false`. Enregistrer le brouillon ne consomme aucun crédit. Si sa version a changé, relisez le brouillon avant de recommencer.
5. Prévisualisez [`confirm_pitch_audit`](https://docs.qwairy.co/fr/mcp/write/pitch-audits#confirm_pitch_audit) sur le même audit avec `dryRun: true`. Lisez le coût et les avertissements. **Approuvez la collecte** si le montant vous convient. Rappelez cet outil avec son propre jeton et `dryRun` omis ou à `false`. Chaque jeton est utilisable une fois et valable dix minutes.
6. Suivez cet identifiant jusqu’à `COMPLETED` et ouvrez le rapport avec `get_pitch_audit`. Sur `FAILED`, arrêtez le parcours et consultez l’audit dans le tableau de bord. Une intégration REST peut s’abonner à [`pitch_audit.completed`](https://docs.qwairy.co/fr/developers/integration-webhooks/events#pitch_audit-completed).

![Un brouillon de 30 prompts devient une liste de 28 après le premier accord. Le second accord lance la collecte au prix annoncé.](https://mintcdn.com/qwairy/GXmjWkbE2RPS6XHd/images/guides/pitch-audit-fr.svg?fit=max\&auto=format\&n=GXmjWkbE2RPS6XHd\&q=85\&s=eec21d826b36c942a05b9ed660746c08)

## Exemple de conversation

Vous demandez 30 prompts sur le marché américain pour prospect.example. Après relecture, vous approuvez l’enregistrement des 28 retenus. L’assistant vous présente le coût de collecte pour ces 28 prompts. Vous pouvez conserver le brouillon ou donner un second accord pour lancer la collecte.

## Limites

* Relancer un audit échoué et exporter un rapport restent des actions du tableau de bord.
* Le contenu du site du prospect peut parvenir à l’assistant via le rapport. Lisez les aperçus avant de confirmer. Consultez [Sécurité](https://docs.qwairy.co/fr/mcp/write/overview.md#sécurité).

## Voir aussi

* [Outils d’écriture des audits de prospection](https://docs.qwairy.co/fr/mcp/write/pitch-audits.md)
* [Audits de prospection pour les agences](https://docs.qwairy.co/fr/agencies/pitch-audits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.