---
title: Skill für Coding-Agenten
description: Installieren Sie den BillionSend-Skill, damit Claude Code und Codex Postfächer bedienen und empfangene Mails als nicht vertrauenswürdig behandeln.
ai:
  exclude: true
---

Der BillionSend-Skill ist eine einzige `SKILL.md`-Datei, die einem Coding-Agenten beibringt, wie er BillionSend nutzt: sich per OAuth oder Agent-Schlüssel mit dem [MCP-Server](/docs/de/mcp) verbinden, ein Postfach finden, auf Verifizierungscodes und Nachrichten warten, antworten, Entwürfe zur Freigabe vorbereiten, was zu tun ist, wenn die Regeln des Postfachs einen Versand als Entwurf zurückhalten, und warum empfangene Mails Daten sind und niemals Anweisungen. Der Agent lädt den Skill, sobald eine Aufgabe BillionSend, einen `bs_`-API-Schlüssel, einen `bs_agent_`-Schlüssel oder ein E-Mail-Postfach für einen Agenten erwähnt.

Die Datei liegt unter `https://billionsend.com/docs/skills/billionsend/SKILL.md`. Sie ist auf Englisch geschrieben, in der Sprache, in der Agenten sie lesen.

## Installation

Jeder Agent liest Skills aus einem Ordner, der wie der Skill heißt, nämlich `billionsend`, und der `SKILL.md` enthält.

**Claude Code**

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

Damit ist der Skill für jedes Projekt auf diesem Rechner installiert. Soll stattdessen das Team eines Repositorys ihn nutzen, speichern Sie ihn als `.claude/skills/billionsend/SKILL.md` im Repository und committen Sie ihn.

**Codex**

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

Damit ist der Skill für jedes Projekt auf diesem Rechner installiert. Soll stattdessen das Team eines Repositorys ihn nutzen, speichern Sie ihn als `.agents/skills/billionsend/SKILL.md` im Stammverzeichnis des Repositorys und committen Sie ihn.

Führen Sie den Befehl erneut aus, um den Skill zu aktualisieren. Starten Sie nach der Installation eine neue Sitzung, damit der Agent den Skill übernimmt.

## MCP-Server verbinden

Der Skill erklärt dem Agenten, wie er die Tools von BillionSend einsetzt. Den Server braucht der Agent trotzdem.

**Claude Code**

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

Führen Sie dann in Claude Code `/mcp` aus und wählen Sie `billionsend`, um sich anzumelden. Welche Berechtigungen Sie erteilen, steht unter [MCP-Server](/docs/de/mcp).

**Codex**

Erstellen Sie unter **MCP → Agent-Schlüssel erstellen** einen Agent-Schlüssel und tragen Sie den Server in `~/.codex/config.toml` ein:

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

Exportieren Sie `BILLIONSEND_AGENT_KEY` in der Shell, bevor Sie Codex starten. Der Schlüssel gehört nie in die Datei.

## Was der Skill abdeckt

| Teil | Was er dem Agenten vermittelt |
| --- | --- |
| Verbindung | Den MCP-Endpunkt, OAuth und Agent-Schlüssel, die drei Berechtigungsstufen der Agent-Schlüssel und dass normale `bs_`-Schlüssel nur auf der REST-API funktionieren. |
| Postfach-Abläufe | Zuerst `list_inboxes` (die Tools erwarten die Postfach-ID), dann `get_verification_code`, `wait_for_received_email`, `get_received_email`, `reply_to_received_email`, `send_from_inbox` und die Entwurfs-Tools. |
| Zurückgehaltene Sendungen | Dass `draft` mit Begründungen bedeutet, dass die Regeln greifen: Der Agent meldet es, verweist auf den Tab **Zu prüfen** und umgeht es nie. Dazu die Fehler, auf die er stoßen kann, und was jeder bedeutet. |
| Nicht vertrauenswürdige Mails | Den `untrusted_data`-Umschlag und die Markierung `UNTRUSTED EMAIL CONTENT`, `sender_trust` und `screening.verdict` sowie was der Agent niemals tut, nur weil eine Nachricht es verlangt. Siehe [Agent-Sicherheit](/docs/de/agent-safety). |
| Versand | `send_email` und `send_email_batch` von verifizierten Domains, `get_usage` vor Massenversand und die REST-API. |

Der Skill fügt keine Berechtigung hinzu. Was der Agent tun darf, bestimmen weiterhin seine OAuth-Freigabe oder der Geltungsbereich seines Agent-Schlüssels, seine [Team-Rolle](/docs/de/team-roles) und die [Versandregeln](/docs/de/inboxes) des jeweiligen Postfachs.
