AI を活用した開発

Mastra skill と CLI を使った日常的な AI 支援開発については、開発を参照してください。このページでは、コーディング 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 ファイルを提供しています。すべてのドキュメントを1つのファイルにまとめても有用ではないため、llms-full.txt ファイルは提供していません。

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

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

はじめにのページの例：

• /docs/llms.txt
• /docs.md

MCP docs server

警告

MCP docs server は日常的な開発には推奨されません。より新しく、パフォーマンスにも優れるため、代わりに Mastra skill を使用してください。

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

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

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

インストール

create-mastra コマンドでは、MCP docs server は設定されません。移行 Tool など、MCP 固有の Tool が必要な場合は、サーバーを手動で追加してください。

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

mcp.json

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

Claude Code CLI

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

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

プロジェクトスコープの .mcp.json ファイルが存在しない場合は、このコマンドによって作成されます。Claude Code を Visual Studio Code 拡張機能として使用する場合も、同じコマンドを使用できます。

Claude Code で MCP サーバーを使用する方法の詳細

OpenAI Codex CLI

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

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

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

OpenAI Codex で MCP サーバーを使用する方法の詳細

Cursor

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

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

Cursor で MCP サーバーを使用する方法の詳細

Antigravity

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

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

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

   

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

   

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

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

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

   

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

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

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

Antigravity で MCP サーバーを使用する方法の詳細

Visual Studio Code

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

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

   .vscode/mcp.json

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

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

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

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

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

   

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

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

Visual Studio Code で MCP サーバーを使用する方法の詳細

Windsurf

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

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

   ~/.codeium/windsurf/mcp_config.json

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

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

Windsurf で MCP サーバーを使用する方法の詳細

OpenCode

OpenCode の設定にある mcp で MCP サーバーを定義できます。プロジェクトルートに opencode.jsonc ファイルを作成し、次の内容を追加します。

opencode.jsonc

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

OpenCode で MCP サーバーを使用する方法の詳細

Zed

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

~/.config/zed/settings.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 がインストールされ、動作することを確認します。
   • 競合する MCP サーバーがないか確認します。
   • 設定ファイルの構文を確認します。

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

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