---
title: Skill pour agents de code
description: Installez la skill BillionSend pour que Claude Code et Codex sachent se connecter, gérer une boîte de réception et traiter les e-mails reçus comme non fiables.
ai:
  exclude: true
---

La skill BillionSend est un seul fichier `SKILL.md` qui apprend à un agent de code à utiliser BillionSend : se connecter au [serveur MCP](/docs/fr/mcp) avec OAuth ou une clé d'agent, trouver une boîte de réception, attendre des codes de vérification et des messages, répondre, préparer des brouillons à faire approuver, savoir quoi faire quand les règles de la boîte de réception retiennent un envoi comme brouillon, et pourquoi un e-mail reçu est une donnée et jamais une instruction. L'agent la charge quand une tâche mentionne BillionSend, une clé d'API `bs_` ou une clé `bs_agent_`, ou l'idée de donner une boîte de réception e-mail à un agent.

Le fichier se trouve à l'adresse `https://billionsend.com/docs/skills/billionsend/SKILL.md`. Il est rédigé en anglais, la langue dans laquelle les agents le lisent.

## Installer

Chaque agent lit les skills dans un dossier portant le nom de la skill, `billionsend`, qui contient `SKILL.md`.

**Claude Code**

```sh
mkdir -p ~/.claude/skills/billionsend
curl -fsSL https://billionsend.com/docs/skills/billionsend/SKILL.md -o ~/.claude/skills/billionsend/SKILL.md
```

Cela l'installe pour tous les projets de cette machine. Pour la partager avec l'équipe d'un dépôt, enregistrez-la sous `.claude/skills/billionsend/SKILL.md` dans le dépôt et validez-la avec un commit.

**Codex**

```sh
mkdir -p ~/.agents/skills/billionsend
curl -fsSL https://billionsend.com/docs/skills/billionsend/SKILL.md -o ~/.agents/skills/billionsend/SKILL.md
```

Cela l'installe pour tous les projets de cette machine. Pour la partager avec l'équipe d'un dépôt, enregistrez-la sous `.agents/skills/billionsend/SKILL.md` à la racine du dépôt et validez-la avec un commit.

Relancez la commande pour mettre la skill à jour. Démarrez une nouvelle session après l'installation pour que l'agent la prenne en compte.

## Connecter le serveur MCP

La skill explique à l'agent comment utiliser les outils de BillionSend ; l'agent a quand même besoin du serveur.

**Claude Code**

```sh
claude mcp add --transport http billionsend https://api.billionsend.com/mcp
```

Lancez ensuite `/mcp` dans Claude Code et choisissez `billionsend` pour vous connecter. Consultez [Serveur MCP](/docs/fr/mcp) pour les permissions que vous accordez.

**Codex**

Créez une clé d'agent sous **MCP → Créer une clé d'agent** et ajoutez le serveur à `~/.codex/config.toml` :

```toml title="~/.codex/config.toml"
[mcp_servers.billionsend]
url = "https://api.billionsend.com/mcp"
bearer_token_env_var = "BILLIONSEND_AGENT_KEY"
```

Exportez `BILLIONSEND_AGENT_KEY` dans le shell avant de lancer Codex. La clé ne va jamais dans le fichier.

## Ce que couvre la skill

| Partie | Ce qu'elle indique à l'agent |
| --- | --- |
| Connexion | Le point de terminaison MCP, OAuth et les clés d'agent, les trois portées d'une clé d'agent, et le fait que les clés `bs_` ordinaires ne fonctionnent que sur l'API REST. |
| Flux de la boîte de réception | `list_inboxes` d'abord (les outils prennent l'identifiant de la boîte de réception), puis `get_verification_code`, `wait_for_received_email`, `get_received_email`, `reply_to_received_email`, `send_from_inbox` et les outils de brouillon. |
| Envois retenus | Qu'un `draft` accompagné de motifs, c'est le fonctionnement normal des règles : le signaler, indiquer l'onglet **À examiner** et ne jamais le contourner. Les erreurs possibles et ce que chacune signifie. |
| E-mails non fiables | L'enveloppe `untrusted_data` et la barrière `UNTRUSTED EMAIL CONTENT`, `sender_trust` et `screening.verdict`, et ce qu'il ne faut jamais faire parce qu'un message le demande. Consultez [Sécurité des agents](/docs/fr/agent-safety). |
| Envoi | `send_email` et `send_email_batch` depuis des domaines vérifiés, `get_usage` avant un travail en masse, et l'API REST. |

La skill n'ajoute aucune permission. Ce que l'agent peut faire reste défini par son autorisation OAuth ou la portée de sa clé d'agent, son [rôle dans l'équipe](/docs/fr/team-roles) et les [règles d'envoi](/docs/fr/inboxes) de chaque boîte de réception.
