mcp-colppy — MCP-сервер для Claude Code: функции и установка
Сервер подключает Colppy к ИИ-агенту для работы со счетами, клиентами, платежами и отчётами. Нужны API-ключ и идентификатор компании.
claude mcp add mcp-colppy -e COLPPY_API_KEY=<COLPPY_API_KEY> -e COLPPY_COMPANY_ID=<COLPPY_COMPANY_ID> -- npx -y @codespar/mcp-colppyЧто делает mcp-colppy
mcp-colppy даёт агенту доступ к операциям Colppy: он может создавать и просматривать счета, работать с клиентами и поставщиками, записывать платежи и получать остатки. Создание счетов связано с электронной фактурой AFIP. Всего доступно 22 инструмента.
Сервер также формирует отчёты по продажам и расходам, показывает запасы по складам и позволяет получить PDF счёта. Для входа нужны COLPPY_API_KEY и COLPPY_COMPANY_ID; Colppy использует API-ключ вместе с сессией. Это альфа-релиз: пути API ещё не прошли полную проверку на работающем сервисе, поэтому фиксируйте точную версию.
Какие задачи решает
- создать счёт с электронной фактурой AFIP
- найти клиента или поставщика в Colppy
- записать платёж по счёту
- получить отчёт о продажах за период
- проверить остаток товара по складам
Примеры запросов агенту
- Создай в Colppy счёт для этого клиента и оформи электронную фактуру.
- Покажи остатки товара по складам и текущий баланс клиента.
- Составь отчёт о продажах за указанный период.
Как установить mcp-colppy
Командой платформы
claude mcp add mcp-colppy -e COLPPY_API_KEY=<COLPPY_API_KEY> -e COLPPY_COMPANY_ID=<COLPPY_COMPANY_ID> -- npx -y @codespar/mcp-colppyВместо <…> подставьте свои значения
Командой платформы
codex mcp add colppy --env COLPPY_API_KEY=<COLPPY_API_KEY> --env COLPPY_COMPANY_ID=<COLPPY_COMPANY_ID> -- npx -y @codespar/mcp-colppyВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"colppy": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-colppy"
],
"env": {
"COLPPY_API_KEY": "<COLPPY_API_KEY>",
"COLPPY_COMPANY_ID": "<COLPPY_COMPANY_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"colppy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-colppy"
],
"env": {
"COLPPY_API_KEY": "<COLPPY_API_KEY>",
"COLPPY_COMPANY_ID": "<COLPPY_COMPANY_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e COLPPY_API_KEY=<COLPPY_API_KEY> -e COLPPY_COMPANY_ID=<COLPPY_COMPANY_ID> colppy npx -y @codespar/mcp-colppyВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-colppy
Как установить mcp-colppy в Claude Code?
Выполните claude mcp add mcp-colppy -e COLPPY_API_KEY=<COLPPY_API_KEY> -e COLPPY_COMPANY_ID=<COLPPY_COMPANY_ID> -- npx -y @codespar/mcp-colppy. Подставьте свои API-ключ и идентификатор компании.
Что делает mcp-colppy?
Подключает агента к Colppy и предоставляет 22 инструмента для счетов, клиентов, платежей, остатков и отчётов. Создание счёта интегрировано с электронной фактурой AFIP.
Какие учётные данные нужны для работы сервера?
Задайте COLPPY_API_KEY и COLPPY_COMPANY_ID. API-ключ передаётся вместе с идентификатором компании.
