# mcp

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

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

## Что делает

Сервер подключается к BillingServ API v2 и отдаёт ассистенту три инструмента. `billingserv_list_endpoints` показывает, какие адреса доступны и какие у них параметры. `billingserv_get` вызывает один разрешённый GET-эндпоинт, `billingserv_create` пишет записи через POST и заодно активирует и проверяет лицензии на софт.

Разделение чтения и записи сделано намеренно: чтение можно разрешить свободно, а на `billingserv_create` поставить подтверждение в клиенте. Ходит сервер только по фиксированному списку эндпоинтов, и список проверяется на каждом запросе. Удаление записей и приём платежей не предусмотрены вовсе, поэтому лишнего ассистент не натворит.

Нужен Node.js 20 или новее (вместе с ним ставится `npx`) и API-ключ BillingServ. В конфигурации три переменные окружения: `BILLINGSERV_API_BASE_URL` с базой API v2, `BILLINGSERV_API_KEY` и необязательный `BILLINGSERV_TIMEOUT_MS`, по умолчанию 15000. Без ключа или с неверным адресом базы сервер не ответит на запросы.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add --env BILLINGSERV_API_BASE_URL=<BILLINGSERV_API_BASE_URL> --env BILLINGSERV_API_KEY=<BILLINGSERV_API_KEY> --env BILLINGSERV_TIMEOUT_MS=<BILLINGSERV_TIMEOUT_MS> --transport stdio billingserv-mcp -- npx -y @billingserv/mcp-server
```
Вместо <…> подставьте свои значения

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

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

## Примеры запросов агенту
- Покажи клиентов с неоплаченными счетами за этот месяц
- Посмотри динамику выручки за год по отчётам BillingServ
- Проверь активацию этой лицензии и заведи тикет, если она недействительна

## Похожие
- [mcp-vindi](https://affpapa.org/nevibecode/mcp/mcp-vindi.md) — MCP-сервер · ★ 274
- [mcp-tiny](https://affpapa.org/nevibecode/mcp/mcp-tiny.md) — MCP-сервер · ★ 274
- [fortnox](https://affpapa.org/nevibecode/mcp/fortnox.md) — MCP-сервер · ★ 45
- [Xero](https://affpapa.org/nevibecode/mcp/xero.md) — MCP-сервер · ★ 13
- [quote-to-cash](https://affpapa.org/nevibecode/skills/quote-to-cash.md) — скилл · 1700 установок

## Другие версии с тем же именем
- [mcp · kubeshark](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — ★ 12110
- [mcp · butterbase-ai](https://affpapa.org/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/nevibecode/mcp/mcp.md) — ★ 2766
- [mcp · sceneview](https://affpapa.org/nevibecode/mcp/sceneview-mcp.md) — ★ 1349
- [mcp · buoy-gg](https://affpapa.org/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

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