Как подключить Falco к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Falco, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Falco + Cursor

Falco, бельгийская бухгалтерия и электронные счета Peppol: документы закупок и продаж с файлами, счета, полученные через Peppol, поиск участников Peppol, а также клиенты, товары и счета модуля выставления счетов Falco. В основном только чтение; установка статуса оплаты закупки и отправка ответов Peppol на счета отключены при установке.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

FALCO_APP_SECRET, FALCO_API_KEY

Шаг 1 — Получите учётные данные

Коннектору нужны два ключа, и оба обязательны: application secret интегратора и API-ключ клиента Falco.

1. Интегратор создаёт приложение на портале разработчиков Falco (dev.falco-app.be), запрашивает нужные scopes, например documents:purchases:read, documents:sales:read, peppol:inbound:read, peppol:participants:read, customers:read, articles:read и invoices:read, и делает его Public. Его боевой Application Secret (as_live_...) вставляется в FALCO_APP_SECRET.
2. Клиент Falco, администратор организации на тарифе Expert Essential или Expert Premium, открывает API access под своими инициалами в настольном приложении Falco, выбирает это приложение по его ID (app_...) и создаёт API key (sk_live_...) для своей организации. Он вставляется в FALCO_API_KEY.
3. Установите коннектор и запустите falco_get_organization, чтобы проверить оба ключа. Коннектор обращается к боевому API https://api.falco-app.be/v1; ключи песочницы (as_test_, sk_test_) работают только на хосте песочницы и здесь отклоняются.

Что он читает: организацию, которой принадлежит ключ (название, номер плательщика НДС, идентификатор Peppol, адрес, IBAN, тариф); документы закупок (счета и кредит-ноты поставщиков) со статусом оплаты и статусом Peppol, историей событий и вложенными файлами; документы продаж, в том числе импортированные как PDF или UBL; документы, полученные через Peppol, с отправителем, суммами, сроком оплаты, назначением платежа и банковским счётом; а также клиентов, товары и счета модуля выставления счетов Falco с позициями, промежуточными итогами по НДС и статусом Peppol. Он также скачивает файлы: основной файл, UBL XML или вложение документа закупки, UBL документа, полученного через Peppol, и PDF счёта из модуля выставления счетов.

Как с ним работает ИИ: для счетов поставщиков он начинает с falco_list_peppol_inbound (что пришло через Peppol) и falco_list_purchase_documents (все документы закупок с файлами); для продаж с falco_list_sale_documents или, для документов из модуля выставления счетов, с falco_list_invoices. Чтобы узнать, может ли компания получать электронные счета, он использует falco_find_peppol_participant с номером плательщика НДС или falco_check_peppol_participant с идентификатором участника вроде 0208:0123456789.

Отключено при установке: falco_set_purchase_payment_status и falco_send_invoice_response. Первый заменяет статус оплаты документа закупки на not_paid, partially_paid или paid, например после оплаты поставщику. Второй отправляет отправителю полученного документа ответ на счёт через Peppol (acknowledged, in_process, under_query, conditionally_accepted, rejected, accepted или paid); поставщик получает его сразу, и отозвать его нельзя. Администратор включает их осознанно. И тогда ИИ показывает вам документ и новый статус или ответ и ждёт вашего «да».

Даты и суммы: фильтры принимают YYYY-MM-DD. Суммы передаются строками в валюте документа, обычно EUR. Списки разбиты на страницы через page (с 0) и page_size (от 20 до 200, для счетов до 100), и ИИ запрашивает следующую страницу, пока страница возвращается полной.

Ограничения: 60 запросов в минуту на один application secret. Сверх этого Falco отвечает 429, и ИИ ждёт и повторяет запрос.

Частые ошибки: ошибки следуют RFC 9457 с полями title, detail и code. 401 означает неверный application secret или API-ключ либо ключ песочницы на боевом API. 403 означает, что у ключа нет scope для этой области; клиент выдаёт scopes при создании ключа. 404 при поиске участника означает, что компания недоступна через Peppol.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Falco.

Доступные инструменты

Примеры запросов

• «Какие счета поставщиков, полученные через Peppol в этом месяце, ещё не оплачены и когда наступает срок их оплаты?»
• «Покажите документы закупок за последние 30 дней с поставщиком, суммой и статусом оплаты.»
• «Может ли компания с номером плательщика НДС BE0123456789 получать электронные счета через Peppol?»
• «Перечислите счета из модуля выставления счетов, которые отправлены, но ещё не оплачены, с суммами с НДС.»
• «Скачайте PDF счёта 2026-0142 из модуля выставления счетов.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot