# sevdesk-mcp

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

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

## Что делает

sevdesk-mcp даёт агенту доступ к sevDesk: можно просматривать и создавать ваучеры и счета, сверять банковские операции, получать PDF счета и вызывать все 151 API-операцию через каталог. В сервере 24 инструмента, включая проверки НДС, поиск дублей, пропущенных подписок и документов без платежей.

Для запуска нужны Node.js версии ≥ 22, аккаунт sevDesk и API-токен. По умолчанию подключение можно оставить в режиме только чтения; запись включается через `SEVDESK_READ_ONLY=false`, а операции поддерживают `dryRun`. Для сверки локальной папки с PDF-квитанциями используется `SEVDESK_RECEIPT_DIRS`. Без API-токена сервер не подключится к sevDesk.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add --env SEVDESK_API_TOKEN=<SEVDESK_API_TOKEN> --env SEVDESK_READ_ONLY=<SEVDESK_READ_ONLY> --env SEVDESK_RATE_LIMIT=<SEVDESK_RATE_LIMIT> --transport stdio sevdesk-mcp -- npx -y sevdesk-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add sevdesk-mcp --env SEVDESK_API_TOKEN=<SEVDESK_API_TOKEN> --env SEVDESK_READ_ONLY=<SEVDESK_READ_ONLY> --env SEVDESK_RATE_LIMIT=<SEVDESK_RATE_LIMIT> -- npx -y sevdesk-mcp
```
Вместо <…> подставьте свои значения

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e SEVDESK_API_TOKEN=<SEVDESK_API_TOKEN> -e SEVDESK_READ_ONLY=<SEVDESK_READ_ONLY> -e SEVDESK_RATE_LIMIT=<SEVDESK_RATE_LIMIT> sevdesk-mcp npx -y sevdesk-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- проверить записи по НДС и Reverse Charge
- сверить банковские платежи с ваучерами
- найти счета без оплаты или отправки
- сопоставить папку с PDF-квитанциями и учётные документы
- получить данные через нужную операцию sevDesk API

## Примеры запросов агенту
- Проведи аудит НДС за этот год и объясни все находки с высокой серьёзностью.
- Покажи банковские платежи, у которых ещё нет подтверждающего документа.
- Создай черновик счёта для контакта 1009: 3 дня консультаций по 800 €.

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89609
- [CCXT](https://affpapa.org/nevibecode/mcp/ccxt.md) — MCP-сервер · ★ 44591
- [Finance Toolkit](https://affpapa.org/nevibecode/mcp/finance-toolkit.md) — MCP-сервер · ★ 5469
- [EdgarTools](https://affpapa.org/nevibecode/mcp/edgartools.md) — MCP-сервер · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/nevibecode/mcp/letsfg-flights-hotels.md) — MCP-сервер · ★ 2197
- [AutoTS](https://affpapa.org/nevibecode/mcp/autots.md) — MCP-сервер · ★ 1434

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