mcp-afip — MCP-сервер для Claude Code: что делает и как установить
Интегрирует аргентинскую налоговую службу AFIP с ИИ-агентом для выставления электронных счетов и проверки CAE. Пригодится при автоматизации бухгалтерии в Аргентине.
claude mcp add mcp-afip -e AFIP_CERT_PATH=<AFIP_CERT_PATH> -e AFIP_KEY_PATH=<AFIP_KEY_PATH> -e AFIP_CUIT=<AFIP_CUIT> -- npx -y @codespar/mcp-afipЧто делает mcp-afip
С помощью 20 встроенных инструментов сервер позволяет ИИ-ассистенту работать с веб-службами WSFE налоговой службы Аргентины. Агент умеет запрашивать статус авторизации CAE, регистрировать счета-фактуры различных типов, создавать кредитные или дебетовые ноты и передавать пачки до 250 документов за один запрос.
Сервер преобразует обращения к SOAP-протоколу WSAA в вызовы инструментов. Для запуска понадобятся файлы сертификата .crt, приватного ключа .key и номер CUIT налогоплательщика. По умолчанию включён тестовый режим homologation.
Пакет опубликован в статусе alpha, поэтому разработчики советуют фиксировать точную версию из-за незавершённой живой валидации эндпоинтов. Подключение работает через стандартный ввод-вывод либо по HTTP на порту 3000.
Какие задачи решает
- зарегистрировать электронный счёт-фактуру через AFIP с получением CAE
- проверить контрагента по номеру CUIT в налоговом реестре Padrón
- выпустить кредитную или дебетовую ноту с привязкой к исходному счёту
- отправить пачку до 250 счетов за одно обращение к WSFE
Примеры запросов агенту
- Проверь статус налогоплательщика по CUIT 20123456789 через Padrón
- Выстави электронный счёт типа B для конечного потребителя и запроси CAE
- Узнай последний номер авторизованного счёта для точки продаж 1
Как установить mcp-afip
Командой платформы
claude mcp add mcp-afip -e AFIP_CERT_PATH=<AFIP_CERT_PATH> -e AFIP_KEY_PATH=<AFIP_KEY_PATH> -e AFIP_CUIT=<AFIP_CUIT> -- npx -y @codespar/mcp-afipВместо <…> подставьте свои значения
Командой платформы
codex mcp add afip --env AFIP_CERT_PATH=<AFIP_CERT_PATH> --env AFIP_KEY_PATH=<AFIP_KEY_PATH> --env AFIP_CUIT=<AFIP_CUIT> -- npx -y @codespar/mcp-afipВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"afip": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-afip"
],
"env": {
"AFIP_CERT_PATH": "<AFIP_CERT_PATH>",
"AFIP_KEY_PATH": "<AFIP_KEY_PATH>",
"AFIP_CUIT": "<AFIP_CUIT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"afip": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-afip"
],
"env": {
"AFIP_CERT_PATH": "<AFIP_CERT_PATH>",
"AFIP_KEY_PATH": "<AFIP_KEY_PATH>",
"AFIP_CUIT": "<AFIP_CUIT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e AFIP_CERT_PATH=<AFIP_CERT_PATH> -e AFIP_KEY_PATH=<AFIP_KEY_PATH> -e AFIP_CUIT=<AFIP_CUIT> afip npx -y @codespar/mcp-afipВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-afip
Как установить mcp-afip в Claude Code?
Выполните команду `claude mcp add mcp-afip -e AFIP_CERT_PATH=<AFIP_CERT_PATH> -e AFIP_KEY_PATH=<AFIP_KEY_PATH> -e AFIP_CUIT=<AFIP_CUIT> -- npx -y @codespar/mcp-afip`. Замените плейсхолдеры реальными путями к файлам сертификата, ключа и вашим номером CUIT.
Что делает mcp-afip?
Он предоставляет инструменты для прямого взаимодействия с аргентинской налоговой службой AFIP, позволяя генерировать Factura Electrónica, проверять статусы CAE и запрашивать налоговые реестры.
Что требуется подготовить до первого запуска?
Нужны валидный сертификат .crt от AFIP, приватный ключ .key и зарегистрированный CUIT. Без указания этих данных в переменных окружения авторизация через WSAA завершится ошибкой.
