Skip to content
    netQuery.ai MCP

    Set up netQuery.ai MCP on Windows

    Connect your NetSuite session to an AI app on your Windows PC. Verify the connection with a read-only query and troubleshoot missing tools or permissions.

    What you need

    Use 64-bit Windows, Google Chrome, and an MCP-compatible AI app installed on the same PC. Your AI app supplies the model and receives the results it requests.

    Sign in to the portal as a member of an organization with a standalone MCP plan or a netQuery.ai desktop plan. Your NetSuite account needs REST Web Services enabled, and your role needs REST and SuiteQL access.

    Install and activate the Windows app

    1. Add netQuery.ai Connect from the Chrome Web Store. Use this Chrome profile for both portal activation and NetSuite.
    2. Sign in to the portal and open Get Started. Download and run the netQuery.ai MCP installer. If the full netQuery.ai desktop app is running, quit it before activating the standalone app.
    3. Open netQuery.ai MCP from the Start menu or its icon beside the Windows clock. Under License, select Sign in. Open the activation page in the Chrome profile with the extension, choose your organization, and select Activate netQuery.ai MCP.
    4. Check that License shows your email and organization. In the same Chrome profile, sign in to the intended NetSuite account and role. In the MCP window, confirm the account and look for Ready, read only.

    Connect your AI app and run a first query

    1. Open your AI app once. In the MCP window, find it under AI clients and select Connect. When the row shows Connected, restart your AI app and look for the server named netquery-mcp.
    2. Start a new chat with “Use SuiteQL to count the purchase orders dated in the last 30 days that my role can see. Show the count and the query.” Leave Allow writes off. This check works without the optional Bridge or Runner.
    3. Look for a successful tool call and a count. Zero is a valid result. If NetSuite reports a permission error, try a record type your role can already view.

    If the connection is missing

    If activation times out, check License in the MCP window first. If it still shows Not activated, verify the Chrome profile and organization. Ask the owner to check the plan and available seats if activation is refused.

    For NO_SESSION or SESSION_EXPIRED, open or reload NetSuite in Chrome with the extension enabled and sign in again if prompted. Confirm that the MCP window shows the expected account.

    If no tools appear, keep netQuery.ai MCP running, open Show all clients, and check your app’s row. If it asks you to Connect again, do so and restart the AI app. A browser-only chat cannot launch the local server.

    For REST_NOT_ENABLED, ask your NetSuite administrator to check the account’s REST Web Services feature and your role’s permissions. After a change, sign out of NetSuite and back in.