> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ja/llms.txt

# AI を活用した開発

Mastra skill と CLI を使った日常的な AI 支援開発については、[開発](https://mastra.zisheng.pro/ja/docs/getting-started/develop)を参照してください。このページでは、コーディング Agent に Mastra のドキュメントへのアクセスを提供する、そのほかの方法を説明します。

## パッケージ組み込みドキュメント

Mastra パッケージには、`dist/docs` にドキュメントが組み込まれています。Mastra パッケージをインストールすると、AI Agent は `node_modules` からこれらのファイルを直接読み取り、そのパッケージの API とパターンを理解できます。

各 `dist/docs` には次のものが含まれます。

- `SKILL.md`：skills 標準に準拠した skill ファイル
- `references/`：パッケージに関連するドキュメントファイルを格納するフォルダー
- `assets/SOURCE_MAP.json`：公開 export と `node_modules` 内の場所を対応付けるソースマップファイル

## コンテキストファイル

Mastra は、利用可能なすべてのドキュメントページの概要を含むルート [`llms.txt`](https://mastra.ai/llms.txt) ファイルを提供しています。すべてのドキュメントを1つのファイルにまとめても有用ではないため、`llms-full.txt` ファイルは提供していません。

代わりに、各ドキュメントページに専用の `llms.txt` ファイルがあります。これらは簡潔に整理された Markdown ファイルです。各ドキュメントページの末尾には、対応する `llms.txt` ファイルへのリンクがあります。

Mastra ドキュメントの任意の URL に `/llms.txt` を追加するとアクセスできます。URL の末尾に `.md` 拡張子を追加してリクエストすることもできます。

[はじめにのページ](https://mastra.zisheng.pro/ja/docs)の例：

- [`/docs/llms.txt`](https://mastra.ai/docs/llms.txt)
- [`/docs.md`](https://mastra.ai/docs.md)

## MCP docs server

> **警告:** MCP docs server は日常的な開発には推奨されません。より新しく、パフォーマンスにも優れるため、代わりに [Mastra skill](https://mastra.zisheng.pro/ja/docs/getting-started/develop) を使用してください。

`@mastra/mcp-docs-server` パッケージを使用すると、[Model Context Protocol（MCP）](https://modelcontextprotocol.io/docs/getting-started/intro)を介して、Mastra の全ドキュメントにローカルから直接アクセスできます。Cursor、Windsurf、Cline、Claude Code、VS Code、Codex、または MCP をサポートする任意のツールで利用できます。

これらのツールは、Agent への機能追加や新規プロジェクトのひな型作成から、仕組みの調査まで、正確でタスクに固有の情報を Agent が取得できるように設計されています。

ローカル MCP サーバーを使用できず、リモートサーバーへ接続する必要がある場合は、`https://mastra.mcp.kapa.ai` を使用してください。レート制限のため Google アカウントによる認証が必要です（送信されるのは匿名 ID のみです）。可能な場合、Mastra ではパフォーマンスと信頼性に優れるローカル MCP サーバーの使用を推奨しています。

### インストール

[`create-mastra`](https://mastra.zisheng.pro/ja/reference/cli/create-mastra) コマンドでは、MCP docs server は設定されません。移行 Tool など、MCP 固有の Tool が必要な場合は、サーバーを手動で追加してください。

以下に使用するツール固有の手順がない場合は、次の共通 JSON 設定で MCP サーバーを追加できることがあります。

```json
{
  "mcpServers": {
    "mastra": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@mastra/mcp-docs-server@latest"]
    }
  }
}
```

#### Claude Code CLI

次のターミナルコマンドでインストールします。

```bash
claude mcp add --scope project mastra -- npx -y @mastra/mcp-docs-server@latest
```

プロジェクトスコープの `.mcp.json` ファイルが存在しない場合は、このコマンドによって作成されます。Claude Code を [Visual Studio Code 拡張機能](https://code.claude.com/docs/en/vs-code#connect-to-external-tools-with-mcp)として使用する場合も、同じコマンドを使用できます。

[Claude Code で MCP サーバーを使用する方法の詳細](https://docs.claude.com/en/docs/claude-code/mcp)

#### OpenAI Codex CLI

1. ターミナルから登録します。

   ```bash
   codex mcp add mastra-docs -- npx -y @mastra/mcp-docs-server@latest
   ```

2. `codex mcp list` を実行し、サーバーが `enabled` と表示されることを確認します。

[OpenAI Codex で MCP サーバーを使用する方法の詳細](https://developers.openai.com/codex/mcp)

#### Cursor

次のボタンを選択してインストールします。

[![MCP Server をインストール](https://cursor.com/deeplink/mcp-install-light.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=mastra\&config=eyJjb21tYW5kIjoibnB4IC15IEBtYXN0cmEvbWNwLWRvY3Mtc2VydmVyIn0%3D)

自動インストールを行った場合、Cursor を開くと左下にポップアップが表示され、Mastra Docs MCP Server を有効にするよう求められます。

![Cursor 内のポップアップには「New MCP server detected: mastra」と表示され、ユーザーは操作として「Skip」または「Enable」を選択できます。](/ja/assets/images/enable-mastra-docs-cursor-cd5872abdc36c0e10951a59a47f25e12.png)

[Cursor で MCP サーバーを使用する方法の詳細](https://cursor.com/de/docs/context/mcp)

#### Antigravity

Google Antigravity は、外部ドキュメント、API、プロジェクトコンテキストへアクセスするための MCP サーバーをサポートする、Agent ファーストの開発プラットフォームです。

1. Antigravity の MCP 設定ファイルを開きます。

   - エディターのサイドパネル上部で **Agent session** をクリックして **「…」ドロップダウン**を選択し、次に **MCP Servers** を選択して **MCP Store** を開きます。
   - Antigravity の MCP Store インターフェースからアクセスできます。

   ![Antigravity の MCP Store。上部に検索バー、その下に利用可能な MCP サーバーの一覧があり、右上にはドロップダウンメニューがあります。](/ja/assets/images/antigravity_mcp_server-689ea495d9c7139cc431f1f1b9827f9b.png)

2. カスタム MCP サーバーを追加するには、MCP Store 上部の **Manage MCP Servers** を選択し、メインタブで **View raw config** を選択します。

   ![Manage MCP Servers オプションと View raw config ボタンを表示している Antigravity の MCP Store。](/ja/assets/images/antigravity_managed_mcp-b661e8c04b3219000f8d842e5eb26a1a.png)

3. Mastra MCP サーバーの設定を追加します。

   ```json
   {
     "mcpServers": {
       "mastra-docs": {
         "command": "npx",
         "args": ["-y", "@mastra/mcp-docs-server"]
       }
     }
   }
   ```

4. 設定を保存し、Antigravity を再起動します。

   ![MCP サーバーが有効であることを示す UI。個々の Tool を切り替えることもできます。](/ja/assets/images/antigravity_final_interface_mcp-7fa132dbe76cdee9f61136a26d6e6615.png)

設定すると、Mastra MCP サーバーは Antigravity の Agent に次の機能を公開します。

- Mastra のインデックス化されたドキュメントと API スキーマ。コード生成中に関連コンテキストをプログラムから取得できます。
- Mastra Docs に保存されているサンプルコードと使用パターンへのアクセス
- エディター内でのエラー処理とデバッグのリファレンスに使用できる構造化データ
- コードの提案と補完に使用できる、現在の Mastra プロジェクトパターンに関するメタデータ

MCP サーバーは Antigravity の MCP Store に表示され、必要に応じて接続状態と認証を管理できます。

[Antigravity で MCP サーバーを使用する方法の詳細](https://antigravity.google)

#### Visual Studio Code

1. ワークスペースに `.vscode/mcp.json` ファイルを作成します。

2. 次の設定を挿入します。

   ```json
   {
     "servers": {
       "mastra": {
         "type": "stdio",
         "command": "npx",
         "args": ["-y", "@mastra/mcp-docs-server@latest"]
       }
     }
   }
   ```

MCP サーバーをインストールしたら、次のように使用できます。

1. VSCode の設定を開きます。

2. MCP 設定へ移動します。

3. Chat > MCP オプションの「enable」をクリックします。

   ![VSCode の設定ページにある項目。オプション名は「Chat \> MCP: Enabled (Preview)」で、説明には「Enables integration with Model Context Protocol servers to provide additional tools and functionality.」と記載されています。](/ja/assets/images/vscode-mcp-setting-8d1eb4f3df1e33606503f8c5e937e9e3.png)

MCP は VSCode の Agent モードでのみ動作します。Agent モードに切り替えたら、`mcp.json` ファイルを開き、「start」ボタンを選択します。「start」ボタンが表示されるのは、`mcp.json` を含む `.vscode` フォルダーがワークスペースのルート、またはエディター内ファイルエクスプローラーの最上位にある場合だけです。

![エディターに start ボタンが表示された mcp.json ファイルのスクリーンショット](/ja/assets/images/vscode-start-mcp-26480d86080c4907cb497a325de106a4.png)

MCP サーバーを起動したら、Copilot ペインの Tool ボタンを選択して、利用可能な Tool を確認します。

![利用可能な Tool を確認するための VSCode の Tool ページ](/ja/assets/images/vscode-mcp-running-d92d6ed234d1148093dc804b0ead3515.png)

[Visual Studio Code で MCP サーバーを使用する方法の詳細](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)

#### Windsurf

1. エディターで `~/.codeium/windsurf/mcp_config.json` を開きます。

2. 次の設定を挿入します。

   ```json
   {
     "mcpServers": {
       "mastra": {
         "command": "npx",
         "args": ["-y", "@mastra/mcp-docs-server@latest"]
       }
     }
   }
   ```

3. 設定を保存し、Windsurf を再起動します。

[Windsurf で MCP サーバーを使用する方法の詳細](https://docs.windsurf.com/windsurf/cascade/mcp#mcp-config-json)

#### OpenCode

[OpenCode の設定](https://opencode.ai/docs/config/)にある `mcp` で MCP サーバーを定義できます。プロジェクトルートに `opencode.jsonc` ファイルを作成し、次の内容を追加します。

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mastra": {
      "type": "local",
      "command": ["npx", "-y", "@mastra/mcp-docs-server@latest"],
      "enabled": true
    }
  }
}
```

[OpenCode で MCP サーバーを使用する方法の詳細](https://opencode.ai/docs/mcp-servers)

#### Zed

1. エディターで `~/.config/zed/settings.json` を開きます。
2. 次の設定を挿入します。

```json
{
  "context_servers": {
    "Mastra": {
      "command": "npx",
      "args": ["-y", "@mastra/mcp-docs-server@latest"]
    }
  }
}
```

### 使用方法

設定が完了すると、AI ツールに Mastra について質問したり、操作を指示したりできます。これらの手順では、Mastra の MCP サーバーから最新情報を取得します。

**機能を追加する：**

- 「Agent に Evals を追加して、テストを作成してください」
- 「次の処理を行う Workflow を作成してください：`[task]`」
- 「Agent が `[3rd party API]` にアクセスできる新しい Tool を作成してください」

**連携について質問する：**

- 「Mastra は AI SDK と連携できますか？ `[React/Svelte/etc]` プロジェクトで使用するにはどうすればよいですか？」
- 「Mastra は `[provider]` の音声 API をサポートしていますか？コードでの使用例を示してください。」

**既存コードをデバッグまたは更新する：**

- 「Agent Memory でバグが発生しています。最近、関連する変更やバグ修正はありましたか？」
- 「Mastra の Working Memory はどのように動作し、`[task]` にどう使用できますか？期待どおりに動作していないようです。」
- 「Workflow に新機能が追加されたと聞きました。説明したうえで、`[workflow]` をその機能に対応するよう更新してください。」

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

1. **サーバーが起動しない**

   - [npx](https://docs.npmjs.com/cli/v11/commands/npx) がインストールされ、動作することを確認します。
   - 競合する MCP サーバーがないか確認します。
   - 設定ファイルの構文を確認します。

2. **Tool の呼び出しに失敗する**

   - MCP サーバーや IDE を再起動します。
   - IDE を最新バージョンに更新します。