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

# Airtable 連携

> Base44 アプリを Airtable に接続して、ライブデータをダッシュボード、ツール、ワークフローに取り込みます。

<Info>
  <u>注意</u>: Airtable 連携は Builder ティア以上で利用できます。Free ティアをご利用の場合、バックエンド関数や支払い機能を使用するにはアプリのアップグレードが必要です。
</Info>

# ステップごとのセットアップ:

## パート 1: Airtable 側

すでに Airtable API トークンと Base ID をお持ちの場合は、[**パート 2: Base44 側**](https://docs.base44.com/Integrations/Airtable-integration#part-2%3A-the-base44-side) に進んでください。

<Steps>
  <Step title="Personal Access Token を作成">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/AirtableBuilderHub.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=76937cf25bdd1fd4c0c868b440a75a8d" alt="Airtable Builder Hub Pn" width="1901" height="944" data-path="images/AirtableBuilderHub.png" />

    * [<u>Airtable のトークン作成ページ</u>](https://airtable.com/create/tokens/new) にアクセスします。
    * "Scopes" で、少なくとも以下の権限を持つトークンを正しいワークスペース/ベースに対して作成します:
      * `data.records:read`
      * `schema.bases:read`  *(任意ですがテストに役立ちます)*
    * トークンに名前を付け、使用する場合はクレジット上限を設定し、安全な場所にトークンをコピーしておきます。
  </Step>

  <Step title="Base ID を確認">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/HRTable.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=b08891d38f2972511b423d5bf467a005" alt="HR Table Pn" width="1891" height="944" data-path="images/HRTable.png" />

    1. ブラウザで Airtable ベースを開きます。
    2. URL を確認し、"**app**" で始まる文字列をコピーします。これが Base ID です。

       例: `https://airtable.com/app123XYZ/...`
  </Step>
</Steps>

***

## パート 2: Base44 側

API トークンと Base ID を取得したら、2 つの方法で Base44 に接続できます:

<CardGroup cols={2}>
  <Card icon="sparkle" href="https://docs.base44.com/Integrations/Airtable-integration#option-a%3A-ready-made-integration-create-a-new-app" title="オプション A: Ready-made 連携 (推奨)">
    * ゼロから新しいアプリを始める場合は、こちらの方法を選択してください。
  </Card>

  <Card icon="bolt" href="https://docs.base44.com/Integrations/Airtable-integration#option-b%3A-add-airtable-as-an-instant-integration" title="オプション B: Instant 連携">
    * すでにアプリを構築中で、既存のアプリに Airtable を統合したい場合は、こちらの方法を選択してください。
  </Card>
</CardGroup>

### オプション A: Ready-made 連携 (新しいアプリを作成)

<Steps>
  <Step title="Integrations カタログから Airtable を追加">
    <img src="https://mintcdn.com/base44/oUaRpzSyJvMVshj9/images/Integrations.png?fit=max&auto=format&n=oUaRpzSyJvMVshj9&q=85&s=16ac71b185167177ef260be7c92b0339" alt="Integrations Pn" width="1570" height="652" data-path="images/Integrations.png" />

    * Integrations カタログで Airtable を選択
    * 続いて "Use this integration" をクリック

          <img src="https://mintcdn.com/base44/-Vklow6W-uVvNnvR/images/image7.png?fit=max&auto=format&n=-Vklow6W-uVvNnvR&q=85&s=041a8013c65236fe5f17e3d7303461ab" alt="Image7 Pn" width="1877" height="878" data-path="images/image7.png" />
  </Step>

  <Step title="シークレットを貼り付け">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/B44AirtableIntegration.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=591c4433e5721fab7cbb0b82c6d847a9" alt="B44airtable Integration Pn" width="1877" height="867" data-path="images/B44AirtableIntegration.png" />

    * プロンプトが表示されたら、次を貼り付けます:
      * `AIRTABLE_API_KEY`
      * `AIRTABLE_BASE_ID`
  </Step>

  <Step title="アプリを構築">
    * 利用できるサンプルプロンプト:

      `"Build an internal dashboard. We will connect to my Airtable base and show real records. Include a Sync Status page and start by letting me choose a table before building visuals."`
    * アプリが Airtable へのテスト呼び出しを実行し、テーブル一覧を表示します
    * 1 つを選択します
    * 実際のレコードを取得し、スキーマが明確になるように生データテーブルを表示します
  </Step>

  <Step title="Sync Status ページ">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/HRDashboardSync.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=b381c4548b5efb2c3135ad1df01d02e3" alt="HR Dashboard Sync Pn" width="1873" height="869" data-path="images/HRDashboardSync.png" />

    以下を含むページが用意されます:

    * テストを再実行する **Check Connection** ボタン
    * テーブル一覧
    * 最終チェック時刻
    * 接続ステータス
  </Step>
</Steps>

***

### **オプション B: Airtable を Instant 連携として追加**

進行中のアプリがある場合は、こちらの方法を選択してください。

<Steps>
  <Step title="既存のアプリにアクセス">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/HRDashboard.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=8409b5ee99da7d9ff4dc41c36adbfff4" alt="HR Dashboard Pn" width="1876" height="871" data-path="images/HRDashboard.png" />

    * サンプルアプリを構築するために AI チャットに入力したプロンプト:

      `"Build an internal dashboard. Let me pick a data source later."`
  </Step>

  <Step stepNumber={2} title="AI チャット経由で Airtable に接続">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/ConnectAirtableApp.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=124a38233bf1d5dba4f7df5365c14142" alt="Connect Airtable App Pn" width="1874" height="868" data-path="images/ConnectAirtableApp.png" />

    * AI チャットに貼り付けたサンプルプロンプト:

      `Connect this app to Airtable. Ask me for AIRTABLE_API_KEY and AIRTABLE_BASE_ID and save them as Secrets. Add a backend function that can test the connection and fetch records. Create a Sync Status page with a Check Connection button.`
    * AI チャットで "**Set secrets**" をクリックします
    * プロンプトが表示されたら **API Key** と **Base ID** を貼り付けます
  </Step>

  <Step stepNumber={3} title="テーブルを取得してデータを表示">
    * AI チャットにデータを表示するよう促します
    * 使用したサンプルプロンプト:

      `Run the connection test to list my tables, let me pick one, then fetch records and show a raw table view before any visuals.`
  </Step>

  <Step stepNumber={4} title="アプリをテスト">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/HRDashboardSync.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=b381c4548b5efb2c3135ad1df01d02e3" alt="HR Dashboard Sync Pn" width="1873" height="869" data-path="images/HRDashboardSync.png" />

    * **Sync Status** を開き、**Check Connection** をクリック
    * テーブルを選択し、ライブの行が表示されることを確認
  </Step>
</Steps>

***

## **トラブルシューティング**

* **403 または接続失敗** – トークンのスコープが間違っています。data.records:read が有効になっていることを確認してください。テーブル一覧が失敗する場合は schema.bases:read を追加します。
* **Base ID が間違っている** – URL からの app… 文字列を正しくコピーしたか再確認してください。
* **データが表示されない** – ベースに実際にレコードが存在し、トークンにアクセス権限があることを確認してください。
* **公開プレビューとビルダーセッション** – Sync Status のテスト中はビルダーにログインしたままにしてください。

***

## **よくあるユースケース**

チームが Base44 と Airtable をよく利用する方法をいくつかご紹介します:

* **ダッシュボード** – Airtable のデータを取り込み、リアルタイムで可視化。
* **データ管理** – Airtable レコードを表示・確認するための使いやすい UI をチームメイトに提供。
* **同期モニター** – 接続をすばやくテストし、更新を確認するための Sync Status ページを作成。
* **社内ツール** – カスタムコードなしで、Airtable 上に軽量アプリ (CRM ビューやコンテンツトラッカーなど) を構築。

<Note>このページは AI を使用して翻訳されました。最も正確で最新の情報については、[英語版](/) を参照してください。 </Note>
