# BeeL

MCP-сервер BeeL для выпуска испанских электронных счетов с регистрацией VeriFactu в AEAT. Агент проверяет NIF, создаёт счета типа F1/F2 и корректировки R1–R5 прямо из Claude Code, Cursor или VS Code.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2 у репозитория
- Автор: beel-es
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/beel-es/beel-mcp
- Обновлён: 2026-10-21
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/beel

## Что делает

Сервер предоставляет 125 инструментов, построенных из публичного OpenAPI-контракта BeeL: выпуск счетов, управление клиентами и продуктами, проверка NIF в реестре, настройка налоговых режимов. Входные схемы включают перечисления, ключи режима и структуру позиций документа — всё из реального API, без дрейфа. Семь синтетических инструментов покрывают поиск по документации, каталог фискальных правил и проверку готовности NIF к выпуску.

Работает в двух вариантах: удалённый сервер `https://mcp.beel.es/mcp` с OAuth-авторизацией (ничего не устанавливать) и локальный stdio-сервер через `npx @beel_es/mcp` для автоматизации, где нужен API-ключ. Ключи с префиксом `beel_sk_test_` безопасны для экспериментов, `beel_sk_live_` выпускают настоящие фискальные документы.

Встроенные ограждения останавливают запрос до создания документа, если нарушены инварианты регулирования. Ресурсы `beel://guardrails/*` содержат фискальные правила по доменам, каталог кодов ошибок и семь промптов рабочих процессов: выпуск счёта, исправление, онбординг NIF, подключение платежей.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.beel.es/mcp`
- Переменные окружения: `BEEL_API_KEY`, `BEEL_ENV` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp https://mcp.beel.es/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env BEEL_API_KEY=<BEEL_API_KEY> --env BEEL_ENV=<BEEL_ENV> --transport stdio beel -- npx -y @beel_es/mcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add beel --url https://mcp.beel.es/mcp
```

2. **Командой платформы**
```bash
codex mcp add beel --env BEEL_API_KEY=<BEEL_API_KEY> --env BEEL_ENV=<BEEL_ENV> -- npx -y @beel_es/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "beel": {
            "url": "https://mcp.beel.es/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "beel": {
            "command": "npx",
            "args": [
                "-y",
                "@beel_es/mcp"
            ],
            "env": {
                "BEEL_API_KEY": "<BEEL_API_KEY>",
                "BEEL_ENV": "<BEEL_ENV>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "beel": {
            "type": "http",
            "url": "https://mcp.beel.es/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "beel": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@beel_es/mcp"
            ],
            "env": {
                "BEEL_API_KEY": "<BEEL_API_KEY>",
                "BEEL_ENV": "<BEEL_ENV>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http beel https://mcp.beel.es/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e BEEL_API_KEY=<BEEL_API_KEY> -e BEEL_ENV=<BEEL_ENV> beel npx -y @beel_es/mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- Выпустить испанский электронный счёт с регистрацией VeriFactu в AEAT
- Проверить NIF контрагента в реестре налоговой
- Создать корректировку счёта типа R1–R5 с соблюдением требований
- Настроить налоговые режимы и серии документов для компании

## Примеры запросов агенту
- Проверь NIF ES12345678A в реестре и создай счёт типа F1 на сумму 1200 евро
- Выпусти корректировку R2 к счёту INV-2024-001 и зарегистрируй в VeriFactu
- Покажи, что нужно настроить для NIF ESB87654321, чтобы начать выпускать счета

## Похожие
- [Factuarea](https://affpapa.org/nevibecode/mcp/factuarea.md) — MCP-сервер
- [BORME API](https://affpapa.org/nevibecode/mcp/borme-api.md) — MCP-сервер
- [Hellobooks](https://affpapa.org/nevibecode/mcp/hellobooks.md) — MCP-сервер · 1748 установок
- [VAT Validator MCP](https://affpapa.org/nevibecode/mcp/vat-validator-mcp.md) — MCP-сервер · 42 установки
- [invoice-tax-checklist](https://affpapa.org/nevibecode/skills/invoice-tax-checklist.md) — скилл · ★ 12746 у репозитория
- [PropertyList - Official](https://affpapa.org/nevibecode/mcp/propertylist-official.md) — MCP-сервер · 976 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
