> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Harvest

## セットアップガイド

以下の手順で、Harvest をConnect AI アカウントに接続します：

**Step 1**

Connect AI のナビゲーションメニューから**Sources** ページを開きます。

**Step 2**

右上の **+ Add Connection** をクリックします。

**Step 3**

検索フィールドに*Harvest* と入力し、データソース名をクリックします。

**Step 4**

新しいコネクションの**Basic Settings** タブで、コネクション名を入力するかデフォルトの名前をそのまま使用します。

**Step 5**

Harvest の**Account Id** を入力します。確認するには、[Harvest ID](https://id.getharvest.com/developers) にログインし、**Developers** ページを開きます。Account ID は、パーソナルアクセストークンや OAuth2 アプリケーションとともに表示されます。

**Step 6**

Auth Scheme を選択し、該当セクションに進んで手順に従います。

## 認証方式

**OAuth**

OAuth 認証を使用するには、Harvest ID でOAuth2 アプリケーションを作成する必要があります：

**Step 1**

管理者の認証情報で [Harvest ID](https://id.getharvest.com/developers) にログインし、**Developers** ページを開きます。

**Step 2**

**OAuth2 Applications** で**Create New OAuth2 Application** をクリックします。

**Step 3**

必須フィールドを入力します：

* **Name**–アプリケーションの名前。
* **Redirect URL**–*[https://oauth.cdata.com/oauth/](https://oauth.cdata.com/oauth/)* に設定します。
* **Products**–**Harvest** を選択します。

**Step 4**

**Create Application** をクリックします。

**Step 5**

アプリケーションページで、**Client ID** と**Client Secret** を確認します。Client Secret は 1 回しか表示されないため、すぐにコピーしてください。Connect AI では、Client ID を**OAuth Client Id** として、Client Secret を**OAuth Client Secret** として入力します。

Connect AI で以下の手順を行います：

**Step 1**

Harvest から取得した**OAuth Client Id** と**OAuth Client Secret** を入力します。

**Step 2**

OAuth でセキュアに接続するには、**Sign in** をクリックします。これにより、Harvest のサインインページが新しいタブで開かれます。

**Step 3**

Harvest アカウントにログインし、リクエストされた権限を設定します（該当する場合）。

**Step 4**

Connect AI **Add Harvest Connection** ページ上部の、**Save & Test** をクリックします。

* 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
* 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
* 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。

**APIKey**

API Key 認証を使用するには、最初にHarvest ID でパーソナルアクセストークンを作成します：

**Step 1**

[Harvest ID](https://id.getharvest.com/developers) にログインし、**Developers** ページを開きます。

**Step 2**

**Personal Access Tokens** で**Create New Personal Access Token** をクリックします。

**Step 3**

トークンの名前を入力し、アクセスするHarvest 製品を選択します。

**Step 4**

**Create Personal Access Token** をクリックします。

**Step 5**

トークンをすぐにコピーし、安全に保管します。パスワードと同様に扱う必要があります。

Connect AI で以下の手順を行います：

**Step 1**

**API Key** を入力します。

**Step 2**

Connect AI **Add Harvest Connection** ページ上部の、**Save & Test** をクリックします。

* 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
* 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
* 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。

> [!NOTE]
>
> このコネクタを試してみませんか？[Connect AI の無料アカウントを作成](https://jp.cdata.com/ai/signup/)して、最初のコネクションを数分でセットアップします。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.