> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/cloud-cost-management/integrations/ai-providers/anthropic.md).

# Anthropic

Connecting Anthropic brings your Claude spend into Harness Cloud & AI Cost Management alongside your cloud costs. The connector uses an Admin API key to pull usage and cost data from your Anthropic account. You can analyze AI spend in Cost Explorer, attribute it with Views and Cost Categories, and govern it with budgets and anomaly detection, the same way you manage cloud costs.

### Before You Begin <a href="#before-you-begin" id="before-you-begin"></a>

**Anthropic Admin API key:** An Admin key with read-only access from your Anthropic account. The key lets Harness ingest billing and usage data. Go to the [Anthropic Admin API documentation](https://platform.claude.com/docs/en/manage-claude/admin-api) to create one.

### Set Up the Anthropic Connector <a href="#set-up-the-anthropic-connector" id="set-up-the-anthropic-connector"></a>

To connect Anthropic, go to **Cloud & AI Cost Management** > **Account Settings** > **AI Providers** and click **AI Provider**, and then select **Anthropic**.

#### Step 1: Name the Connector <a href="#step-1-name-the-connector" id="step-1-name-the-connector"></a>

1. On the **Overview** panel, enter a **Name** for the connector.
2. Optionally, add a **Description** and **Tags** to organize and filter connectors.

<figure><img src="/files/yv64ZmqRjixHthw8EXph" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

3. Click **Continue**.

#### Step 2: Select the Product Type <a href="#step-2-select-the-product-type" id="step-2-select-the-product-type"></a>

On the **Anthropic Product Type** panel, select the Anthropic product your spend comes from:

* **Anthropic (Platform):** The developer API platform, with usage-based billing for API calls to Claude models.
* **Anthropic Enterprise:** The consumer and business chat application, with Team and Enterprise plans on seat-based billing.

Then click **Continue**.

<figure><img src="/files/dxa28GWEkxIs2Gc56sOu" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

#### Step 3: Add the Connector Details <a href="#step-3-add-the-connector-details" id="step-3-add-the-connector-details"></a>

On the **Connector Details** panel, confirm the API endpoint and provide the Anthropic Admin API key as a Harness secret. Do the following:

1. In the **URL** field, do not change the default `https://api.anthropic.com` unless you have a custom endpoint.

   <figure><img src="/files/R2X9qIuWSghA8fcSyoib" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>
2. In the **API Key** field, click **Create or Select a Secret**.
   * To use an existing secret, select it from the list, then click **Apply Selected**.
   * To add a new secret, click **New Secret Text**, enter a **Secret Name**, and provide your Anthropic Admin API key as the **Secret Value**.

     <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>The key must match the product type you selected in Step 2, or the connection test fails with a scope mismatch error. If the connection test fails, refer to <a href="#fix-a-scope-mismatch-error">Fix a scope mismatch error</a>.</p></div>

     <figure><img src="/files/jGaGWymu34sCAdvwfPXu" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

     Go to [Add and reference text secrets](/harness-ai/use-harness-platform/secrets/add-use-text-secrets.md) to review all secret creation options.
3. Click **Continue**.

#### Step 4: Verify the Connection <a href="#step-4-verify-the-connection" id="step-4-verify-the-connection"></a>

On the **Connection Test** panel, Harness validates the API key against your Anthropic account. Once the verification is successful, click **Finish** to create the connector.

<figure><img src="/files/51kO6LPzi3eOTZbNaF4q" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

{% hint style="info" %}
If the test fails with an **HTTP 403 "Missing required scope"** error, your key does not match the product type you selected. Go to [Fix a scope mismatch error](#fix-a-scope-mismatch-error) to resolve it.
{% endhint %}

***

### Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

#### Fix a Scope Mismatch Error <a href="#fix-a-scope-mismatch-error" id="fix-a-scope-mismatch-error"></a>

Each product type needs an Admin key with a specific scope. If the key does not match the product type you selected in Step 2, the connection test fails with an **HTTP 403 "Missing required scope"** error.

| Product type             | Required key scope |
| ------------------------ | ------------------ |
| **Anthropic (Platform)** | `api:admin`        |
| **Anthropic Enterprise** | `read:analytics`   |

If you select **Anthropic Enterprise** but use a Platform key, the test reports that `read:analytics` is missing.

If you select **Anthropic (Platform)** but use an Enterprise key, the test reports that `api:admin` is missing.

To fix it, do one of the following, and then click **Retest**:

* Go back to Step 2 and select the product type that matches your key.
* Create a new Anthropic Admin key with the scope your product type needs, save it as a Harness secret, and then reselect it in the **API Key** field.