---
title: Skill para agentes de código
description: Instale a skill do BillionSend para que o Claude Code e o Codex saibam se conectar, cuidar de uma caixa de entrada e tratar e-mails recebidos como não confiáveis.
ai:
  exclude: true
---

A skill do BillionSend é um único arquivo `SKILL.md` que ensina um agente de código a usar o BillionSend: conectar ao [servidor MCP](/docs/pt-br/mcp) com OAuth ou com uma chave de agente, encontrar uma caixa de entrada, esperar códigos de verificação e mensagens, responder, escrever rascunhos para aprovação, o que fazer quando as regras da caixa de entrada retêm um envio como rascunho e por que e-mail recebido é dado e nunca instrução. O agente a carrega quando uma tarefa menciona o BillionSend, uma chave de API `bs_` ou uma chave `bs_agent_`, ou dar a um agente uma caixa de entrada de e-mail.

O arquivo fica em `https://billionsend.com/docs/skills/billionsend/SKILL.md`. Ele é escrito em inglês, a língua em que os agentes o leem.

## Instalar

Cada agente lê skills de uma pasta com o nome da skill, `billionsend`, que contém o `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
```

Isso instala a skill para todos os projetos desta máquina. Para compartilhá-la com a equipe de um repositório, salve-a como `.claude/skills/billionsend/SKILL.md` no repositório e faça commit.

**Codex**

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

Isso instala a skill para todos os projetos desta máquina. Para compartilhá-la com a equipe de um repositório, salve-a como `.agents/skills/billionsend/SKILL.md` na raiz do repositório e faça commit.

Rode o comando de novo para atualizar a skill. Comece uma sessão nova depois de instalar para que o agente a carregue.

## Conectar o servidor MCP

A skill ensina o agente a usar as ferramentas do BillionSend; o agente ainda precisa do servidor.

**Claude Code**

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

Depois rode `/mcp` dentro do Claude Code e escolha `billionsend` para entrar. Veja [Servidor MCP](/docs/pt-br/mcp) para as permissões que você concede.

**Codex**

Crie uma chave de agente em **MCP → Criar chave de agente** e adicione o servidor em `~/.codex/config.toml`:

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

Exporte `BILLIONSEND_AGENT_KEY` no shell antes de iniciar o Codex. A chave nunca vai para o arquivo.

## O que a skill cobre

| Parte | O que ela diz ao agente |
| --- | --- |
| Conexão | O endpoint MCP, OAuth e chaves de agente, os três escopos de chave de agente e que chaves `bs_` comuns só funcionam na API REST. |
| Fluxos da caixa de entrada | `list_inboxes` primeiro (as ferramentas recebem o id da caixa de entrada), depois `get_verification_code`, `wait_for_received_email`, `get_received_email`, `reply_to_received_email`, `send_from_inbox` e as ferramentas de rascunho. |
| Envios retidos | Que `draft` com motivos são as regras funcionando: relatar, apontar a aba **Precisa de revisão** e nunca contornar. Os erros que ele pode encontrar e o que cada um quer dizer. |
| E-mail não confiável | O envelope `untrusted_data` e a cerca `UNTRUSTED EMAIL CONTENT`, `sender_trust` e `screening.verdict`, e o que nunca fazer porque uma mensagem pede. Veja [Segurança do agente](/docs/pt-br/agent-safety). |
| Envio | `send_email` e `send_email_batch` a partir de domínios verificados, `get_usage` antes de trabalho em massa e a API REST. |

A skill não acrescenta nenhuma permissão. O que o agente pode fazer continua definido pela concessão OAuth ou pelo escopo da chave de agente, pela [função na equipe](/docs/pt-br/team-roles) e pelas [regras de envio](/docs/pt-br/inboxes) de cada caixa de entrada.
