BeeL — MCP-сервер для Claude Code: испанская электронная отчётность
MCP-сервер BeeL для выпуска испанских электронных счетов с регистрацией VeriFactu в AEAT. Агент проверяет NIF, создаёт счета типа F1/F2 и корректировки R1–R5 прямо из Claude Code, Cursor или VS Code.
MIT ★ 2 обновлён 2026-10-21
claude mcp add --transport http mcp https://mcp.beel.es/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, подключение платежей.
Какие задачи решает
- Выпустить испанский электронный счёт с регистрацией VeriFactu в AEAT
- Проверить NIF контрагента в реестре налоговой
- Создать корректировку счёта типа R1–R5 с соблюдением требований
- Настроить налоговые режимы и серии документов для компании
Примеры запросов агенту
- Проверь NIF ES12345678A в реестре и создай счёт типа F1 на сумму 1200 евро
- Выпусти корректировку R2 к счёту INV-2024-001 и зарегистрируй в VeriFactu
- Покажи, что нужно настроить для NIF ESB87654321, чтобы начать выпускать счета
Как установить BeeL
1Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://mcp.beel.es/mcp2Командой платформы
claude mcp add --env BEEL_API_KEY=<BEEL_API_KEY> --env BEEL_ENV=<BEEL_ENV> --transport stdio beel -- npx -y @beel_es/mcpВместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add beel --url https://mcp.beel.es/mcp2Командой платформы
codex mcp add beel --env BEEL_API_KEY=<BEEL_API_KEY> --env BEEL_ENV=<BEEL_ENV> -- npx -y @beel_es/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"beel": {
"url": "https://mcp.beel.es/mcp"
}
}
}{
"mcpServers": {
"beel": {
"command": "npx",
"args": [
"-y",
"@beel_es/mcp"
],
"env": {
"BEEL_API_KEY": "<BEEL_API_KEY>",
"BEEL_ENV": "<BEEL_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"beel": {
"type": "http",
"url": "https://mcp.beel.es/mcp"
}
}
}{
"servers": {
"beel": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@beel_es/mcp"
],
"env": {
"BEEL_API_KEY": "<BEEL_API_KEY>",
"BEEL_ENV": "<BEEL_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http beel https://mcp.beel.es/mcp2Командой платформы
gemini mcp add -e BEEL_API_KEY=<BEEL_API_KEY> -e BEEL_ENV=<BEEL_ENV> beel npx -y @beel_es/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о BeeL
Как установить BeeL в Claude Code?
Для удалённого сервера с OAuth выполни claude mcp add --transport http beel https://mcp.beel.es/mcp. Для локального сервера с API-ключом: claude mcp add --env BEEL_API_KEY=<BEEL_API_KEY> --env BEEL_ENV=<BEEL_ENV> --transport stdio beel -- npx -y @beel_es/mcp.
Что делает BeeL?
BeeL — MCP-сервер для выпуска испанских электронных счетов с регистрацией VeriFactu в AEAT. Агент проверяет NIF, создаёт счета типа F1/F2, корректировки R1–R5 и управляет клиентами и продуктами через 125 инструментов, построенных из OpenAPI-контракта.
Чем отличаются ключи beel_sk_test_ и beel_sk_live_?
Ключи beel_sk_test_ безопасны для экспериментов и не создают настоящих фискальных документов. Ключи beel_sk_live_ выпускают реальные счета с регистрацией в AEAT.