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

* Une équipe agence sur une offre Business, Agency Business ou Enterprise active. Les outils d’écriture des audits de prospection ne sont pas disponibles autrement.
* Un rôle de Manager ou de Propriétaire dans l’équipe agence.
* Une connexion avec le scope `write:pitch-audits` pour les outils d’écriture et `read:pitch-audits` pour lire l’audit. Consultez [Authentification OAuth](https://docs.qwairy.co/fr/mcp/oauth.md).
* Des crédits pour l’audit. L’aperçu indique le montant avant que vous confirmiez.

## Étapes

**1. Trouver votre équipe agence**

Demandez l’identifiant de l’équipe à l’assistant. `list_brands` le renvoie dans l’objet `team` de chaque workspace. Les audits précédents renvoyés par `list_pitch_audits` indiquent aussi leur workspace.

**2. Créer l’audit**

L’assistant appelle [`create_pitch_audit`](https://docs.qwairy.co/fr/mcp/write/pitch-audits#create_pitch_audit) :

```json theme={null}
{
  "teamId": "team_agency_01",
  "url": "prospect.example",
  "name": "Prospect Co",
  "countryCode": "US",
  "promptCount": 20
}
```

Qwairy prépare les prompts et ne consomme aucun crédit à ce stade. Laissez `autoStartResponses` non défini : il supprime la relecture des prompts.

**3. Attendre l’état de relecture**

L’assistant lit l’audit avec `list_pitch_audits` jusqu’à ce que son statut soit `AWAITING_PROMPTS`, puis l’ouvre avec `get_pitch_audit`. Le rapport renvoie les prompts et la `version` de l’audit.

**4. Relire et enregistrer les prompts**

Lisez les prompts avec l’assistant. Retirez ou réécrivez ceux qui ne conviennent pas au prospect, puis enregistrez la liste complète avec [`save_pitch_audit_prompts`](https://docs.qwairy.co/fr/mcp/write/pitch-audits#save_pitch_audit_prompts), en passant la `version` lue comme `expectedVersion` :

```json theme={null}
{
  "auditId": "audit_01",
  "expectedVersion": 4,
  "prompts": [
    { "id": "p1", "text": "Which analytics tools suit a ten-person operations team?", "category": "TOFU", "topic": "Analytics tools" },
    { "id": "p2", "text": "How does Prospect Co compare with other analytics vendors?", "category": "MOFU", "topic": "Vendor comparison" }
  ]
}
```

L’appel remplace tout l’ensemble de prompts. Un conflit de version signifie que l’audit a changé : relisez-le.

**5. Prévisualiser le coût**

Demandez à l’assistant d’appeler [`confirm_pitch_audit`](https://docs.qwairy.co/fr/mcp/write/pitch-audits#confirm_pitch_audit) avec `dryRun` défini sur `true`, ou de l’appeler sans jeton. Qwairy renvoie les crédits que l’audit consommera, d’éventuels avertissements et un `confirmationToken`. Rien n’a démarré.

**6. Confirmer**

Si le coût est acceptable, approuvez-le. L’assistant appelle de nouveau `confirm_pitch_audit` avec les mêmes arguments et le jeton. Le jeton est à usage unique et valable 10 minutes, et il est rejeté si les prompts ou le coût ont changé depuis l’aperçu. Votre client MCP peut aussi demander sa propre approbation.

**7. Lire le rapport**

Interrogez `get_pitch_audit` jusqu’à ce que le statut soit `COMPLETED`. Pour comparer un co-concurrent, réutilisez un `subjectId` de `coCompetitors`. Consultez [Outils de lecture des audits de prospection](https://docs.qwairy.co/fr/mcp/tools/pitch-audits.md). Une intégration REST peut s’abonner à [`pitch_audit.completed`](https://docs.qwairy.co/fr/developers/integration-webhooks/events#pitch_audit-completed) au lieu d’interroger.

## Exemple de conversation

```text theme={null}
Vous : Prépare un audit de prospection pour prospect.example, 20 prompts, marché US.

Assistant : crée l’audit et indique qu’il attend la relecture des prompts.

Vous : Retire les deux prompts sur les carrières, puis montre-moi le coût.

Assistant : enregistre 18 prompts, puis affiche l’aperçu de la confirmation : les
crédits que l’audit consommera et un jeton de confirmation. Rien n’a démarré.

Vous : Confirme.

Assistant : confirme avec le jeton. La collecte des réponses démarre. Plus tard,
l’assistant lit le rapport final.
```

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