Кратко
Sage Business Cloud Accounting, южноафриканская версия (бывший Sage One): компании, клиенты, поставщики, товары, налоговые счета, котировки, счета поставщиков, план счетов, банковские транзакции, квитанции клиентов, дебиторская задолженность, отчет о прибылях и убытках и баланс. Войдите с помощью своего логина Sage и API-ключа от Sage.
Пошаговая настройка
Подключи Sage Accounting к Microsoft Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Sage Accounting в пошаговой настройке и добавь свой MCP URL в Microsoft Copilot. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Sage Accounting (South Africa)
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди, нажми Connectors → Sage Accounting (South Africa), вставь свои учетные данные, создай API-ключ MCP и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Sage Accounting (Южная Африка) + Microsoft Copilot
Sage Business Cloud Accounting, южноафриканская версия (бывший Sage One): компании, клиенты, поставщики, товары, налоговые счета, котировки, счета поставщиков, план счетов, банковские транзакции, квитанции клиентов, дебиторская задолженность, отчет о прибылях и убытках и баланс. Войдите с помощью своего логина Sage и API-ключа от Sage.
Предварительные требования
Смотри полные инструкции по настройке, встроенные в коннектор (видимые в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
SAGE_ZA_API_HOST, SAGE_ZA_USERNAME, SAGE_ZA_PASSWORD, SAGE_ZA_API_KEY
Шаг 1 — Получи учетные данные
Настройка занимает до 2 рабочих дней.
- Запроси API-ключ на https://accounting.sageone.co.za/marketing/developerprogram.aspx (Запроси свой API-ключ). Sage выдает один ключ на приложение; он выглядит как
39478ac6-ac2a-44d8-a31c-7e7e14af4de3. Вставь его вSAGE_ZA_API_KEY. - Выбери сайт, на котором ты входишь в
SAGE_ZA_API_HOST: accounting.sageone.co.za для большинства аккаунтов или resellers.accounting.sageone.co.za, если это твоя страница входа. - Введи адрес электронной почты и пароль пользователя Sage Accounting в
SAGE_ZA_USERNAMEиSAGE_ZA_PASSWORD. API использует HTTP Basic аутентификацию с теми же данными для входа, что и веб-приложение, поэтому рекомендуется создать отдельного пользователя с доступом, необходимым ассистенту. Приглашенный пользователь получает доступ только к функциям, разрешенным его ролью (другие вызовы возвращают 405). - Необязательно: укажи ID компании, в которой работает ассистент, в
SAGE_ZA_COMPANY_ID. Найди его с помощьюsage_accounting_za_list_companies. Без него передавайcompany_idв каждом вызове.
С чего начать: sage_accounting_za_list_companies показывает компании для данного логина и их ID. Все остальные инструменты работают внутри одной компании (company_id, или по умолчанию коннектора).
Клиенты, поставщики, товары: sage_accounting_za_list_customers, sage_accounting_za_get_customer, sage_accounting_za_list_suppliers, sage_accounting_za_get_supplier, sage_accounting_za_list_items, sage_accounting_za_get_item. Создавай или изменяй их с помощью sage_accounting_za_save_customer, sage_accounting_za_save_supplier и sage_accounting_za_save_item.
Документы по продажам и покупкам: sage_accounting_za_list_tax_invoices и sage_accounting_za_get_tax_invoice (счета-фактуры), sage_accounting_za_list_quotes и sage_accounting_za_get_quote, sage_accounting_za_list_supplier_invoices и sage_accounting_za_get_supplier_invoice. Инструменты списка возвращают только заголовки, если include_detail не равно true. Создай котировку с помощью sage_accounting_za_save_quote и счет с помощью sage_accounting_za_save_tax_invoice; предварительно просчитай итоги с помощью sage_accounting_za_calculate_quote или sage_accounting_za_calculate_tax_invoice. Строка указывает на товар (LineType 0) или счет главной книги (LineType 1) в SelectionId, с количеством, ценой за единицу и TaxTypeId. Если сохраненный документ возвращает нулевые итоги, передавай строки точно так, как их вернул инструмент расчета.
Главная книга и банковские операции: sage_accounting_za_list_accounts, sage_accounting_za_list_account_categories и sage_accounting_za_list_tax_types описывают план счетов; sage_accounting_za_save_account добавляет или изменяет счет. sage_accounting_za_list_bank_accounts, sage_accounting_za_list_bank_transactions и sage_accounting_za_list_customer_receipts доступны только для чтения: этот коннектор не записывает квитанции или платежи и никогда не перемещает деньги.
Отчеты: sage_accounting_za_get_customer_ageing и sage_accounting_za_get_supplier_ageing (кто кому что должен, по возрасту), sage_accounting_za_list_outstanding_customer_documents, sage_accounting_za_get_profit_and_loss, sage_accounting_za_get_balance_sheet и sage_accounting_za_get_account_balances (движение по счету, как пробный баланс). Это POST-вызовы, которые только читают.
Сохранение: сохранение без id создает запись; с id заменяет эту запись. Sage сохраняет запись такой, какой она отправлена, поэтому поле, пропущенное в обновлении, может быть сброшено: сначала прочитай запись и передай то, что должно остаться в extra_fields. Новые записи активны, если active не равно false. Ничего не удаляется этим коннектором.
Фильтрация и постраничный вывод: инструменты списка принимают подмножество OData. filter и orderby работают только с числами, логическими значениями и датами, никогда с текстом (ищи имена, читая список). Литералы дат записываются как DateTime'2026-01-31'; если Sage отклоняет эту форму, попробуй просто дату в кавычках. Каждый список ограничен 100 строками: ответ обернут как TotalResults, ReturnedResults и Results; увеличивай skip на 100, пока не получишь строки TotalResults.
Ограничения: 100 запросов в минуту на компанию и 5000 в день на пользователя. Превышение лимита по минутам блокирует IP-адрес на час (HTTP 429), поэтому старайся делать около одного вызова в секунду и не повторяй в цикле. 20 неудачных входов за час блокируют пользователя на 24 часа: после 401 остановись и проверь учетные данные.
Поля и форматы: ID — целые числа. Даты — YYYY-MM-DD. Суммы — десятичные значения в валюте компании, если только у клиента или поставщика нет своей валюты (см. Customer_CurrencyId и курс на документе). Exclusive — это сумма до налога, Tax — НДС, а Total — сумма с налогом. Ошибки: 400 содержит сообщения о валидации, 402 означает, что подписка Sage истекла, 404 — что запись отсутствует в этой компании, 409 — что запись используется.
Шаг 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 — Добавь коннектор в Microsoft Copilot
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.
- В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
- Укажи Server name (например,
AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер. - В аутентификации выбери API key, установи Type в Header, укажи имя заголовка
X-API-Keyи нажми Create. - В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
- Проверь в панели Test агента: попроси о том, для чего нужны инструменты
Sage Accounting (Южная Африка). - Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.
Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
sage_accounting_za_list_companies | Список компаний, которые может открыть этот логин Sage: ID, Название, Символ валюты, Налоговый номер, Зарегистрированное имя, ID страны, Активен, Является владельцем… |
sage_accounting_za_list_customers | Список клиентов: ID, Название, Категория, Контактное лицо, Электронная почта, Телефон, Мобильный, Налоговая ссылка, Баланс, Кредитный лимит, почтовый и адрес доставки… |
sage_accounting_za_get_customer | Чтение одного клиента со всеми полями: имя, категория, контакт, налоговая ссылка, баланс, кредитный лимит, адреса, тип налога по умолчанию, прайс-лист… |
sage_accounting_za_list_suppliers | Список поставщиков: ID, Название, Категория, Контактное лицо, Электронная почта, Телефон, Налоговая ссылка, Баланс, Кредитный лимит, адресные строки, Активен и Изменен.… |
sage_accounting_za_get_supplier | Чтение одного поставщика со всеми полями: имя, категория, контактные данные, налоговая ссылка, баланс, адреса, тип налога по умолчанию, валюта и срок… |
sage_accounting_za_list_items | Список товаров (продукты и услуги): ID, Код, Описание, Категория, Цена без налога, Цена с налогом, Последняя стоимость, Единица, Физический (товар на складе… |
sage_accounting_za_get_item | Чтение одного товара со всеми полями: код, описание, категория, цены продажи, последняя стоимость, единица, налоговые типы, группы отчетности и пользовательские… |
sage_accounting_za_list_tax_invoices | Список налоговых счетов (счетов-фактур): ID, Номер документа, Дата, Срок, CustomerId, Имя клиента, Ссылка, Exclusive, Налог, Всего… |
sage_accounting_za_get_tax_invoice | Чтение одного налогового счета с его строками: номер документа, даты, клиент, адреса, скидка, Exclusive, Налог, Всего, Сумма к оплате и по строкам… |
sage_accounting_za_list_quotes | Список котировок: ID, Номер документа, Дата, Срок действия, CustomerId, Имя клиента, Ссылка, Exclusive, Налог, Всего и Статус. Только для чтения, 100… |
sage_accounting_za_get_quote | Чтение одной котировки с ее строками: номер документа, дата, срок действия, клиент, скидка, итоги, статус и по строкам товар или счет… |
sage_accounting_za_list_supplier_invoices | Список счетов поставщиков (счетов на покупку): ID, Номер документа, Дата, Срок, SupplierId, Имя поставщика, Ссылка, Exclusive, Налог, Всего… |
sage_accounting_za_get_supplier_invoice | Чтение одного счета поставщика с его строками: номер документа, даты, поставщик, ссылка, Exclusive, Налог, Всего, Сумма к оплате и по строкам… |
sage_accounting_za_list_accounts | Список счетов главной книги (план счетов без системных счетов): ID, Название, Описание, Категория (ID и Описание), Баланс… |
sage_accounting_za_list_account_categories | Список категорий счетов (Продажи, Себестоимость продаж, Расходы, Оборотные активы и т.д.): ID, Описание и Порядок. ID — это категория… |
sage_accounting_za_list_tax_types | Список типов налогов (НДС) компании: ID, Название, Процент, Является по умолчанию и Активен. ID — это TaxTypeId строк документов, товаров и… |
sage_accounting_za_list_bank_accounts | Список банковских и кредитных счетов: ID, Название, Название банка, Номер счета, Номер отделения, Категория, Баланс, По умолчанию, CurrencyId… |
sage_accounting_za_list_bank_transactions | Список банковских транзакций кассовой книги: ID, BankAccountId, Дата, Тип, Получатель, Описание, Ссылка, Номер документа, Exclusive, Налог… |
sage_accounting_za_list_customer_receipts | Список квитанций клиентов (полученные платежи): ID, CustomerId, Дата, Номер документа, Ссылка, Описание, Всего, Скидка… |
sage_accounting_za_get_customer_ageing | Подробная дебиторская задолженность клиентов: по каждому клиенту непогашенные документы с датой, номером документа, ссылкой и суммой по каждому… |
sage_accounting_za_get_supplier_ageing | Подробная кредиторская задолженность поставщиков: по каждому поставщику непогашенные документы с датой, номером документа, ссылкой и суммой по каждому… |
sage_accounting_za_list_outstanding_customer_documents | Список неоплаченных документов одного клиента (налоговые счета, и с include_paid_invoices также оплаченные): тип документа, номер, дата… |
sage_accounting_za_get_profit_and_loss | Отчет о прибылях и убытках (отчет о доходах) за период: дерево уровней отчетности (Продажи, Себестоимость продаж, Валовая прибыль, Расходы, Чистая прибыль)… |
sage_accounting_za_get_balance_sheet | Баланс на одну дату: дерево уровней отчетности (активы, обязательства, капитал) с Описанием, Номером счета, Категорией, Детьми… |
sage_accounting_za_get_account_balances | Движение по счету главной книги за период, как пробный баланс: ID счета, Описание, CategoryId, CategoryDescription, Дебет… |
sage_accounting_za_save_customer | Создать клиента или обновить его, когда указан id. Возвращает сохраненного клиента с его ID. Сохранение заменяет всю запись: для обновления… |
sage_accounting_za_save_supplier | Создать поставщика или обновить его, когда указан id. Возвращает сохраненного поставщика с его ID. Сохранение заменяет всю запись: для обновления… |
sage_accounting_za_save_item | Создать товар (продукт или услугу) или обновить его, когда указан id. Возвращает сохраненный товар с его ID. Сохранение заменяет всю запись… |
sage_accounting_za_save_account | Создать счет главной книги или обновить его, когда указан id. Возвращает сохраненный счет с его ID. Категория определяет, где счет… |
sage_accounting_za_calculate_quote | Рассчитать итоги котировки без сохранения: возвращает документ с Exclusive, Налогом, Всего и Скидкой по строкам и для всего… |
sage_accounting_za_save_quote | Создать котировку для клиента или обновить ее, когда указан id. Возвращает сохраненную котировку с ее ID, Номером документа и итогами. Проверь… |
sage_accounting_za_calculate_tax_invoice | Рассчитать итоги налогового счета без сохранения: возвращает документ с Exclusive, Налогом, Всего и Скидкой по строкам и для всего… |
sage_accounting_za_save_tax_invoice | Создать налоговый счет (счет-фактуру) для клиента или обновить его, когда указан id. Возвращает сохраненный счет с его ID, Номером документа… |
Примеры подсказок
- "Какие клиенты должны нам деньги более 60 дней?"
- "Покажи отчет о прибылях и убытках за последний финансовый квартал."
- "Предварительный просмотр налогового счета для Acme Trading: 10 часов консультаций по R950, затем сохрани его."
- "Список счетов поставщиков за октябрь, которые все еще неоплачены."
- "Каковы балансы наших банковских счетов и последние транзакции?"
Часто задаваемые вопросы
Что мне нужно для входа? API-ключ от программы разработчиков Sage (запроси его на странице разработчика; это может занять до 2 рабочих дней), сайт, на котором ты входишь, и адрес электронной почты и пароль пользователя Sage Accounting. Рекомендуется создать отдельного пользователя с доступом, необходимым ассистенту: 20 неудачных входов за час блокируют пользователя на 24 часа.
Это глобальный Sage Accounting? Нет. Это южноафриканская версия Sage Business Cloud Accounting, бывший Sage One и Sage Pastel My Business Online, также используемая на других африканских рынках, обслуживаемых с той же платформы. Для Великобритании, Ирландии, Северной Америки и Европы используй коннектор Sage Business Cloud.
Что он может изменить и перемещает ли он деньги? Он создает и обновляет клиентов, поставщиков, товары, счета, котировки и налоговые счета, с инструментами расчета для предварительного просмотра итогов. Банковские счета, банковские транзакции и квитанции клиентов доступны только для чтения: он не записывает квитанции или платежи, никогда не перемещает деньги и ничего не удаляет. Ничего не устанавливается, если выключено.
Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.
Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.
Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
Это руководство помогло?