Oracle NetSuite в MCP: управляйте Oracle NetSuite из любого AI-агента

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

Oracle NetSuite

Дайте ИИ работать с Oracle NetSuite: выполнять SuiteQL-запросы только на чтение по клиентам, поставщикам, номенклатуре, операциям и главной книге, читать клиентов, поставщиков, сотрудников, номенклатуру, заказы клиентов, счета, заказы поставщикам, счета поставщиков и бухгалтерские проводки вместе со строками, просматривать типы записей и поля, а также создавать клиентов и заказы клиентов. Вход через NetSuite OAuth 2.0, рабочий или тестовый (sandbox) аккаунт.

Настройка

Администратор настраивает это один раз, примерно за 20 минут.

1. Включите нужные функции: Setup → Company → Enable Features. На вкладке SuiteCloud отметьте REST Web Services и в разделе Manage Authentication OAuth 2.0. На вкладке Analytics отметьте SuiteAnalytics Workbook: из него читает SuiteQL. Сохраните.
2. Создайте роль для ИИ: Setup → Users/Roles → Manage Roles → New. Добавьте разрешения REST Web Services (Full) и Log in using OAuth 2.0 Access Tokens (Full), View для списков и операций, которые ИИ может читать (клиенты, поставщики, номенклатура, сотрудники, счета учёта, заказы клиентов, счета, заказы поставщикам, счета поставщиков, проводки и Find Transaction), и Create там, где он может записывать (клиенты, заказы клиентов). Назначьте роль пользователю, который будет входить в систему. Отдельная роль безопаснее, чем Administrator: ИИ видит только то, что разрешает роль.
3. Создайте запись интеграции: Setup → Integration → Manage Integrations → New. Установите состояние Enabled, снимите отметки Token-Based Authentication и TBA: Authorization Flow, отметьте Authorization Code Grant в разделе OAuth 2.0, оставьте Public Client неотмеченным, укажите redirect URI https://cloud.anythingmcp.com/api/mcp-oauth/callback (если вы размещаете AnythingMCP сами: <your AnythingMCP URL>/api/mcp-oauth/callback) и отметьте scope REST Web Services. При сохранении NetSuite один раз показывает Client ID и Client Secret внизу страницы. Вставьте их в NETSUITE_CLIENT_ID и NETSUITE_CLIENT_SECRET.
4. ID аккаунта: Setup → Company → Company Information. В NETSUITE_ACCOUNT_ID его нужно указать так, как он выглядит в веб-адресе NetSuite: строчными буквами и с дефисом вместо подчёркивания, то есть 1234567_SB1 превращается в 1234567-sb1. Для sandbox создайте запись интеграции в самом sandbox.
5. Установите коннектор, нажмите Authorize with Provider, войдите в NetSuite и выберите роль из шага 2.
6. Запустите netsuite_list_record_types, чтобы проверить подключение, а затем первый запрос через netsuite_suiteql_query, например SELECT id, companyname FROM customer.

Авторизуйтесь заново раз в неделю: NetSuite держит refresh-токен такой интеграции действительным семь дней и не продлевает его, поэтому нажимайте Authorize with Provider хотя бы раз в неделю. В промежутке access-токены обновляются автоматически. Отключение записи интеграции, роли или пользователя сразу прекращает доступ.

Основную работу делает SuiteQL: netsuite_suiteql_query выполняет один SQL-запрос только на чтение по аналитическим данным NetSuite: клиентам, поставщикам, номенклатуре, счетам учёта, дочерним компаниям и операциям с их строками и суммами проводок. Так ИИ отвечает на вопросы вроде открытых счетов по клиентам, продаж по номенклатуре или расходов по поставщикам. Результаты приходят страницами до 1 000 строк, а один запрос возвращает не более 100 000 строк в сумме, поэтому на крупные вопросы ИИ отвечает итогами, а не отдельными строками. Строки, которые роли не видны, пропускаются без ошибки, так что пустой ответ может означать нехватку разрешения.

Записи: отдельные инструменты читают клиентов, поставщиков, сотрудников, номенклатуру, заказы клиентов, счета, заказы поставщикам, счета поставщиков и проводки вместе со строками, а netsuite_get_record читает запись любого другого типа. netsuite_describe_record_type перечисляет все поля типа записи, включая пользовательские.

Запись данных только после подтверждения: netsuite_create_customer создаёт клиента после вашего подтверждения. netsuite_create_sales_order (создаёт заказ в статусе Pending Approval, так что ничего не отгружается, пока кто-то его не утвердит) и netsuite_update_record при установке выключены; включайте их по отдельности, если они нужны. Изменения проведённых операций влияют на бухгалтерский учёт.

Частые ошибки: INVALID_LOGIN означает, что истекла еженедельная авторизация или отключены интеграция, роль либо пользователь: авторизуйтесь заново. 403 или INSUFFICIENT_PERMISSION: роли не хватает разрешения. CONCURRENCY_LIMIT_EXCEEDED: слишком много параллельных запросов к аккаунту, подождите и повторите попытку. Неизвестный хост означает, что NETSUITE_ACCOUNT_ID записан не в форме веб-адреса.

Коннектор входит только через OAuth 2.0; Token-Based Authentication (TBA) не поддерживается. Он не удаляет записи, не запускает сохранённые поиски и отчёты, не вызывает RESTlets и не использует файловый кабинет (file cabinet).

Предварительные требования: NETSUITE_ACCOUNT_ID, NETSUITE_CLIENT_ID, NETSUITE_CLIENT_SECRET

Локальная установка коннектора

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

Откройте http://localhost:3000/connectors/store, выберите Oracle NetSuite и введите переменные, перечисленные в Предварительных требованиях.

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

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

• «У каких клиентов есть открытые счета старше 60 дней и сколько должен каждый из них?»
• «Покажите продажи за прошлый квартал по номенклатуре, топ-20 по сумме.»
• «Сколько мы потратили у каждого поставщика в этом году по счетам поставщиков?»
• «Создайте клиента Harbor Supplies Ltd. в британской дочерней компании и покажите мне данные перед сохранением.»

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

• Подключить к Claude
• Подключить к ChatGPT