Factuarea — MCP-сервер для Claude Code: счета и VeriFactu
Подключает агента к платформе Factuarea: выставляет счета по VeriFactu, ведёт контакты, товары и налоги прямо в диалоге.
claude mcp add --transport http mcp https://mcp.factuarea.comЧто делает Factuarea
Factuarea — платформа счетов и учёта для компаний и фрилансеров в Испании. Это её официальный MCP-сервер, тот же сервис, что работает в продакшене, а не обёртка поверх REST API. Агент получает доступ к тому же набору операций, что и в веб-панели: выставить счёт с VeriFactu, посмотреть, кто отметился на работе утром, проверить каталог или подачу по налогам.
Сервер живёт по адресу https://mcp.factuarea.com. Установка не нужна: добавляете URL в клиент и входите под своей учётной записью Factuarea. На экране согласия выбираете компанию, окружение — live или test — и какие права выдать. Доступ по MCP входит в любой тариф, включая пробный период.
Если браузера под рукой нет, для CI и запланированных задач есть ключ API: его создают в настройках разработчика и передают как bearer-токен. Ключи fact_test_… работают с песочницей, fact_live_… — с реальной компанией. Для клиентов, которые умеют запускать только локальные серверы, есть пакет @factuarea/mcp — небольшой stdio-сервер, который пересылает запросы на тот же адрес с вашим ключом. Ему нужен Node 20 или новее. Бизнес-логики в пакете нет: инструменты, правила и права всегда на стороне сервера, поэтому локальное подключение ведёт себя так же, как удалённое.
Какие задачи решает
- выставить счёт с отметкой VeriFactu для AEAT
- собрать коммерческое предложение из каталога товаров
- проверить, кто из сотрудников отметился на работе
- посмотреть контакты и налоги по компании
- подготовить подачу по налогам
Примеры запросов агенту
- Выставь счёт клиенту за прошлый месяц с VeriFactu
- Покажи, кто сегодня отметился на работе
- Сделай коммерческое предложение по товарам из каталога
Как установить Factuarea
1Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://mcp.factuarea.com2Командой платформы
claude mcp add --env FACTUAREA_API_KEY=<FACTUAREA_API_KEY> --env FACTUAREA_MCP_URL=<FACTUAREA_MCP_URL> --env FACTUAREA_REQUEST_TIMEOUT_MS=<FACTUAREA_REQUEST_TIMEOUT_MS> --transport stdio factuarea -- npx -y @factuarea/mcpВместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add factuarea --url https://mcp.factuarea.com2Командой платформы
codex mcp add factuarea --env FACTUAREA_API_KEY=<FACTUAREA_API_KEY> --env FACTUAREA_MCP_URL=<FACTUAREA_MCP_URL> --env FACTUAREA_REQUEST_TIMEOUT_MS=<FACTUAREA_REQUEST_TIMEOUT_MS> -- npx -y @factuarea/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"factuarea": {
"url": "https://mcp.factuarea.com"
}
}
}{
"mcpServers": {
"factuarea": {
"command": "npx",
"args": [
"-y",
"@factuarea/mcp"
],
"env": {
"FACTUAREA_API_KEY": "<FACTUAREA_API_KEY>",
"FACTUAREA_MCP_URL": "<FACTUAREA_MCP_URL>",
"FACTUAREA_REQUEST_TIMEOUT_MS": "<FACTUAREA_REQUEST_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"factuarea": {
"type": "http",
"url": "https://mcp.factuarea.com"
}
}
}{
"servers": {
"factuarea": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@factuarea/mcp"
],
"env": {
"FACTUAREA_API_KEY": "<FACTUAREA_API_KEY>",
"FACTUAREA_MCP_URL": "<FACTUAREA_MCP_URL>",
"FACTUAREA_REQUEST_TIMEOUT_MS": "<FACTUAREA_REQUEST_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http factuarea https://mcp.factuarea.com2Командой платформы
gemini mcp add -e FACTUAREA_API_KEY=<FACTUAREA_API_KEY> -e FACTUAREA_MCP_URL=<FACTUAREA_MCP_URL> -e FACTUAREA_REQUEST_TIMEOUT_MS=<FACTUAREA_REQUEST_TIMEOUT_MS> factuarea npx -y @factuarea/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Factuarea
Как установить Factuarea в Claude Code?
Выполните claude mcp add --transport http factuarea https://mcp.factuarea.com, затем откройте /mcp и нажмите Authenticate.
Что делает Factuarea?
Даёт агенту доступ к платформе Factuarea: счета с VeriFactu, коммерческие предложения, контакты, товары, налоги и подачи. Всё это выполняется в диалоге, без перехода в веб-панель.
Что нужно, чтобы сервер заработал без браузера?
Ключ API из настроек разработчика, переданный как bearer-токен. Ключи fact_test_… работают с песочницей, fact_live_… — с реальной компанией.
