# MCP

Da documentação da API do Lero: https://lero.studio/docs/ai#mcp. Tudo num arquivo só: https://lero.studio/docs/llms-full.txt.

O MCP coloca o Lero dentro do seu agente. Ele ganha 3 ferramentas e passa a gerar áudio direto da conversa, sem você escrever código. Rode o comando do seu agente, com a sua chave no lugar de `lero_sua_chave`:

Claude Code:

```bash
claude mcp add --env LERO_API_KEY=lero_sua_chave lero -- npx -y lero-mcp
```

Codex:

```bash
codex mcp add lero --env LERO_API_KEY=lero_sua_chave -- npx -y lero-mcp
```

Cursor:

```json
{
  "mcpServers": {
    "lero": {
      "command": "npx",
      "args": [
        "-y",
        "lero-mcp"
      ],
      "env": {
        "LERO_API_KEY": "lero_sua_chave"
      }
    }
  }
}
```

Claude Desktop:

```json
{
  "mcpServers": {
    "lero": {
      "command": "npx",
      "args": [
        "-y",
        "lero-mcp"
      ],
      "env": {
        "LERO_API_KEY": "lero_sua_chave"
      }
    }
  }
}
```

No Cursor, o JSON vai em `~/.cursor/mcp.json`. No Claude Desktop, em Settings > Developer > Edit Config. Precisa do Node 18 ou mais novo.

Depois é só pedir, por exemplo: *gera um áudio na voz de São Paulo dizendo "seu pedido saiu para entrega"*.

| ferramenta | o que faz | custo |
|---|---|---|
| `lero_fala` | Transforma o texto em fala e salva o MP3. Até 500 caracteres por chamada. | 1 crédito por caractere |
| `lero_vozes` | Lista as vozes. | grátis |
| `lero_saldo` | Mostra os créditos da conta e o plano. | grátis |

Os MP3 ficam em `~/Downloads/Lero`. Para mudar a pasta, adicione `LERO_PASTA` na config, do mesmo jeito que a chave. A chave fica só na config do seu agente, no seu computador, e vai direto para a API do Lero.
