# Factuarea

Подключает агента к платформе Factuarea: выставляет счета по VeriFactu, ведёт контакты, товары и налоги прямо в диалоге.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: factuarea
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/factuarea/factuarea-mcp
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/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 или новее. Бизнес-логики в пакете нет: инструменты, правила и права всегда на стороне сервера, поэтому локальное подключение ведёт себя так же, как удалённое.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.factuarea.com`
- Переменные окружения: `FACTUAREA_API_KEY`, `FACTUAREA_MCP_URL`, `FACTUAREA_REQUEST_TIMEOUT_MS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp https://mcp.factuarea.com
```

2. **Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add factuarea --url https://mcp.factuarea.com
```

2. **Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "factuarea": {
            "url": "https://mcp.factuarea.com"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "factuarea": {
            "type": "http",
            "url": "https://mcp.factuarea.com"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http factuarea https://mcp.factuarea.com
```

2. **Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

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

## Примеры запросов агенту
- Выставь счёт клиенту за прошлый месяц с VeriFactu
- Покажи, кто сегодня отметился на работе
- Сделай коммерческое предложение по товарам из каталога

## Похожие
- [Boletín Claro](https://affpapa.org/nevibecode/mcp/boletin-claro.md) — MCP-сервер
- [QuickBooks Automation](https://affpapa.org/nevibecode/skills/quickbooks-automation.md) — скилл · 4700 установок
- [popbill](https://affpapa.org/nevibecode/skills/popbill.md) — скилл · 4400 установок
- [plan-payroll](https://affpapa.org/nevibecode/skills/plan-payroll.md) — скилл · 1800 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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