# mcp-alegra

Подключает агента к Alegra для счетов, контактов, товаров и платежей. Пригодится для работы с бухгалтерскими данными через MCP.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Автор: codespar
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/colombia/alegra
- Обновлён: 2026-09-27
- HTML: https://affpapa.org/nevibecode/mcp/mcp-alegra

## Что делает

mcp-alegra подключает агента к облачной бухгалтерской платформе Alegra. Через сервер можно создавать, получать, перечислять и отменять счета, скачивать ссылку на PDF и отправлять счета по email. Доступны операции с контактами, товарами и услугами, платежами, категориями, банковскими счетами и профилем компании.

Сервер запускается через пакет `@codespar/mcp-alegra` в режиме stdio. Для HTTP-транспорта предусмотрен флаг `--http`; порт можно задать через `MCP_PORT`, а включение HTTP — через `MCP_HTTP`. Аутентификация использует Basic auth с email и API-токеном Alegra.

Перед запуском нужны `ALEGRA_EMAIL` и `ALEGRA_API_TOKEN`, причём токен берётся в настройках Alegra. Без этих двух переменных сервер не сможет подключиться к аккаунту.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `ALEGRA_EMAIL`, `ALEGRA_API_TOKEN` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add mcp-alegra -e ALEGRA_EMAIL=<ALEGRA_EMAIL> -e ALEGRA_API_TOKEN=<ALEGRA_API_TOKEN> -- npx -y @codespar/mcp-alegra
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add alegra --env ALEGRA_EMAIL=<ALEGRA_EMAIL> --env ALEGRA_API_TOKEN=<ALEGRA_API_TOKEN> -- npx -y @codespar/mcp-alegra
```
Вместо <…> подставьте свои значения

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e ALEGRA_EMAIL=<ALEGRA_EMAIL> -e ALEGRA_API_TOKEN=<ALEGRA_API_TOKEN> alegra npx -y @codespar/mcp-alegra
```
Вместо <…> подставьте свои значения

## Когда брать
- создать и отменить счёт в Alegra
- получить PDF-ссылку на счёт
- найти контакт, товар или платёж
- записать новый платёж
- проверить профиль компании и банковские счета

## Примеры запросов агенту
- Создай счёт для клиента и отправь его по email через Alegra.
- Найди все платежи за нужный период и покажи их идентификаторы.
- Добавь новый товар в каталог Alegra и проверь его данные.

## Похожие
- [Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres](https://affpapa.org/nevibecode/mcp/ekwo-os-open-source-accounting-ledger-invoices-and-vat-on-your-own-supabase-or-p.md) — MCP-сервер · ★ 40
- [BuchhaltungsButler](https://affpapa.org/nevibecode/mcp/buchhaltungsbutler.md) — MCP-сервер · ★ 9
- [billing-automation](https://affpapa.org/nevibecode/skills/billing-automation.md) — скилл · 11245 установок
- [QuickBooks Automation](https://affpapa.org/nevibecode/skills/quickbooks-automation.md) — скилл · 4700 установок
- [xero](https://affpapa.org/nevibecode/skills/xero.md) — скилл · 346 установок
- [quickbooks](https://affpapa.org/nevibecode/skills/quickbooks.md) — скилл · 338 установок

Из того же набора: [codespar/mcp-dev-latam](https://affpapa.org/nevibecode/by/codespar/mcp-dev-latam.md) — 124 карточки

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