---
title: Skill para agentes de código
description: Instala la skill de BillionSend para que Claude Code y Codex sepan conectarse, trabajar una bandeja de entrada y tratar el correo recibido como no confiable.
ai:
  exclude: true
---

La skill de BillionSend es un archivo `SKILL.md` que enseña a un agente de código a usar BillionSend: conectarse al [servidor MCP](/docs/es/mcp) con OAuth o con una clave de agente, encontrar una bandeja de entrada, esperar códigos de verificación y mensajes, responder, preparar borradores para aprobación, qué hacer cuando las reglas de la bandeja de entrada retienen un envío como borrador y por qué el correo recibido son datos y nunca instrucciones. El agente la carga cuando una tarea menciona BillionSend, una clave de API `bs_` o una clave `bs_agent_`, o dar una bandeja de entrada de email a un agente.

El archivo está en `https://billionsend.com/docs/skills/billionsend/SKILL.md`. Está escrito en inglés, el idioma en el que lo leen los agentes.

## Instalar

Cada agente lee las skills de una carpeta con el nombre de la skill, `billionsend`, que contiene `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
```

Así queda instalada para todos los proyectos de esta máquina. Para compartirla con el equipo de un repositorio, guárdala como `.claude/skills/billionsend/SKILL.md` en el repositorio y haz commit.

**Codex**

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

Así queda instalada para todos los proyectos de esta máquina. Para compartirla con el equipo de un repositorio, guárdala como `.agents/skills/billionsend/SKILL.md` en la raíz del repositorio y haz commit.

Ejecuta el comando otra vez para actualizar la skill. Abre una sesión nueva después de instalarla para que el agente la cargue.

## Conectar el servidor MCP

La skill le dice al agente cómo usar las herramientas de BillionSend; el agente sigue necesitando el servidor.

**Claude Code**

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

Después ejecuta `/mcp` dentro de Claude Code y elige `billionsend` para iniciar sesión. Consulta el [servidor MCP](/docs/es/mcp) para ver los permisos que concedes.

**Codex**

Crea una clave de agente en **MCP → Crear clave de agente** y añade el servidor a `~/.codex/config.toml`:

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

Exporta `BILLIONSEND_AGENT_KEY` en el shell antes de iniciar Codex. La clave nunca va en el archivo.

## Qué cubre la skill

| Parte | Qué le dice al agente |
| --- | --- |
| Conexión | El endpoint MCP, OAuth y las claves de agente, los tres alcances de las claves de agente, y que las claves `bs_` normales solo funcionan en la API REST. |
| Flujos de bandeja de entrada | Primero `list_inboxes` (las herramientas reciben el id de la bandeja de entrada), después `get_verification_code`, `wait_for_received_email`, `get_received_email`, `reply_to_received_email`, `send_from_inbox` y las herramientas de borradores. |
| Envíos retenidos | Que un `draft` con motivos son las reglas funcionando: informarlo, señalar la pestaña **Pendientes de revisión** y no esquivarlo nunca. Los errores que puede encontrar y qué significa cada uno. |
| Correo no confiable | El sobre `untrusted_data` y el delimitador `UNTRUSTED EMAIL CONTENT`, `sender_trust` y `screening.verdict`, y qué no hacer jamás porque lo pida un mensaje. Consulta [Seguridad de agentes](/docs/es/agent-safety). |
| Envío | `send_email` y `send_email_batch` desde dominios verificados, `get_usage` antes de trabajos masivos y la API REST. |

La skill no añade ningún permiso. Lo que el agente puede hacer lo siguen fijando su autorización OAuth o el alcance de su clave de agente, su [rol de equipo](/docs/es/team-roles) y las [reglas de envío](/docs/es/inboxes) de cada bandeja de entrada.
