mcp · billingserv — MCP-сервер для Claude Code: BillingServ в диалоге с ИИ
MCP-сервер BillingServ даёт ассистенту доступ к клиентам, счетам и заказам вашей биллинговой системы. Пригодится, когда ответ нужен из живых данных, а не по памяти модели.
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Что делает 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. Без ключа или с неверным адресом базы сервер не ответит на запросы.
Какие задачи решает
- найти клиентов с неоплаченными счетами за месяц
- посмотреть динамику выручки за год
- проверить, какие пакеты есть у клиента и на что их можно сменить
- проверить активацию лицензии на софт
- создать тикет или черновик счёта из диалога с ассистентом
Примеры запросов агенту
- Покажи клиентов с неоплаченными счетами за этот месяц
- Посмотри динамику выручки за год по отчётам BillingServ
- Проверь активацию этой лицензии и заведи тикет, если она недействительна
Как установить mcp
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp
Как установить mcp в Claude Code?
Одной командой: `claude mcp add mcp -e BILLINGSERV_API_BASE_URL=<BILLINGSERV_API_BASE_URL> -e BILLINGSERV_API_KEY=<BILLINGSERV_API_KEY> -- npx -y @billingserv/mcp-server`. После этого перезапустите Claude.
Что делает mcp?
Даёт ассистенту доступ к BillingServ API v2: список эндпоинтов, чтение через billingserv_get и запись через billingserv_create.
Можно ли ограничить запись, оставив чтение свободным?
Да, это заложено в устройстве сервера: чтение и запись — разные инструменты, и в клиенте можно требовать подтверждение только для billingserv_create.
Похожие MCP-серверы
Все MCP-серверы по теме «Финансы и бизнес» →Сначала — mcp от других авторов.
