Activate Naia Build access to Claude API in Neptune DXP Portal

Aim: Configure the Bring Your Own Key (BYOK) Claude model API key in the Neptune DXP Portal, establish cost limits at account (personal account or organization account) and user level, and accept the BYOK terms, so that you or users in your organization can access Naia Build with Claude model capabilities from within the Neptune DXP - Open Edition App Designer.

Prerequisites

  • You are running a Neptune DXP - Open Edition instance from version 24.12 MTS or above.

  • You have (administrator) credentials for the Neptune DXP Portal.

  • You have obtained a valid Claude API key from Anthropic before proceeding. Neptune acts as a proxy for requests but does not own or manage this key. You are (in the case of a personal account) or your organization is (in the case of an organization account) solely responsible for the key, its security, and all associated usage costs.

Procedure

Activate Claude API key for a personal account

Activate the Claude API key for the system associated with your personal account.

naia build personal account

  1. Go to Neptune DXP Portal → Your Account → Naia Build.

  2. Toggle the In Use switch to on.

    Result: This activates Naia Build for your account and makes the remaining configuration fields available.

  3. Set daily spend limits for the account when consuming tokens for agents powered using the Claude API by entering a value in Daily spend limit (USD).

  4. In API Key, paste your Anthropic Claude API key. This key is stored at the account level in the Neptune DXP Portal and is used when Naia Build is active. Neptune does not have visibility into your Anthropic billing account. Cost tracking within the platform is handled separately via the Naia Build Dashboard.

  5. Accept the Bring Your Own Key (BYOK) terms by selecting the checkbox confirming: I acknowledge that by using this feature, I agree to the Terms of Service and Data Processing Agreement.

    By selecting this, you acknowledge that any users associated with the account will have access to Naia Build via the configured API key, and that you/your organization is solely responsible for any resulting usage costs.

  6. Select Save.

    Result: Naia Build with Claude model support via the Claude API key is now active for your personal account.

Activate Claude API key for an organization account

Activate the Claude API key for the system associated with your organization account.

naia build company account

  1. Go to Neptune DXP Portal Account Assignment → Naia Build.

  2. Toggle the In Use switch to on.

    Result: This activates Naia Build for your account and makes the remaining configuration fields available.

  3. Set daily spend limits for the account when consuming tokens for agents powered using the Claude API by entering a value in Daily spend limit (USD).

  4. In API Key, paste your Anthropic Claude API key. This key is stored at the account level in the Neptune DXP Portal and is used when Naia Build is active. Neptune does not have visibility into your Anthropic billing account. Cost tracking within the platform is handled separately via the Naia Build Dashboard.

  5. Accept the Bring Your Own Key (BYOK) terms by selecting the checkbox confirming: I acknowledge that by using this feature, I agree to the Terms of Service and Data Processing Agreement.

    By selecting this, you acknowledge that any users associated with the account will have access to Naia Build via the configured API key, and that your organization is solely responsible for any resulting usage costs.

  6. Select Save.

    Result: Users within the system associated with your organization account display in the dialog.

  7. Enable specific users to have access to the Claude model via the Claude API key by turning on the switch. If no users display, select Sync Users.

    Result: Naia Build with Claude model support via the Claude API key is now active for your organization account.

Monitoring usage via Naia Build Dashboard

naia build dashboard

Once Naia Build is in active use, go to Naia Build Dashboard to monitor consumption. The dashboard provides the following views:

Request Logs

Per-request detail including total cost, token breakdown (input, output, cache read, cache write), average cache percentage, duration, iterations, and tool calls, filterable by timeframe.

Analytics

The same metrics as Request Logs presented graphically, with a Claude-specific section, a provider comparison view, and a breakdown by top users.

Users

All developers on the account actively using the API key, with per-user request totals, cost, average cache percentage, average duration, and last active timestamp.

Apps

Usage attributed to specific applications built with Naia Build, showing requests, cost, tokens, duration, and last active per application.

Result

  • You have configured the Claude API key and cost limits in Neptune DXP Portal to enable the Claude AI model for Naia Build either for a personal account or an organization account.

  • Users associated with the respective account can open the Naia Build workspace in the Neptune DXP - Open Edition App Designer and select the Claude model from the Chat tab to begin building.

Next step

Related topics