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

# AI で Avala を使う

> MCP で Avala を Claude、Cursor、VS Code、ChatGPT に接続しましょう

[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) は、AI アシスタントが外部ツールを呼び出しデータソースにアクセスできるオープンスタンダードです。Avala の MCP サーバーは、データセット、プロジェクト、エクスポートをツールとして公開するため、Claude、Cursor、VS Code、ChatGPT で自然言語を通じてアノテーションワークフローを管理できます。

## クイックセットアップ

互換性のある AI クライアントに MCP サーバーをインストールします。**Node.js 18+** と [Avala API キー](/docs/api-reference/authentication)が必要です。

Claude Desktop の場合、設定ファイル（macOS では `~/Library/Application Support/Claude/claude_desktop_config.json`）に追加します：

<Warning>
  実際の API キーを含む設定ファイルをバージョン管理にコミットしないでください。`AVALA_API_KEY` をシステム環境変数として設定するか、`"your-api-key"` を実際のキーにローカルで置き換えてください。
</Warning>

```json theme={null}
{
  "mcpServers": {
    "avala": {
      "command": "npx",
      "args": ["-y", "@avala-ai/mcp-server"],
      "env": {
        "AVALA_API_KEY": "your-api-key"
      }
    }
  }
}
```

Claude Desktop を再起動します。Avala のツールがツールピッカーに表示されます。

<Info>
  MCP はバンドルされたサーバーではデフォルトで読み取り専用で実行されます。書き込み/削除ツールを有効にするには、MCP サーバーの起動前に `AVALA_MCP_ENABLE_MUTATIONS=true` を設定してください。
</Info>

## できること

接続後、AI アシスタントに自然言語で Avala と対話するよう依頼できます：

```
すべてのデータセットを一覧表示して
```

```
「歩行者検出」プロジェクトのステータスを表示して
```

```
「Lidar QA」で完了したタスクは何件？
```

```
データセット ds_abc123 のエクスポートジョブを表示して
```

```
ワークスペースの統計を表示して
```

アシスタントは適切な Avala MCP ツールを呼び出し、レスポンスを処理して結果を提示します。単一の会話で複数のリクエストをチェーンできます — 例えば、データセットを一覧表示し、1つを選択してからエクスポートをトリガーできます。

## フルセットアップガイド

VS Code、ChatGPT、利用可能な MCP ツールの完全なリストについては、[MCP サーバーセットアップガイド](/docs/integrations/mcp-setup)をご覧ください。

<CardGroup cols={2}>
  <Card title="MCP サーバーセットアップ" icon="plug" href="/docs/integrations/mcp-setup">
    すべてのサポートされる AI クライアントの完全なセットアップ手順とツールリファレンス。
  </Card>

  <Card title="API 認証" icon="key" href="/docs/api-reference/authentication">
    MCP サーバーで使用する API キーの作成と管理。
  </Card>
</CardGroup>