Studio
Mastra は、src/mastra/ 直下の studio.ts ファイルから Studio を設定します。このファイルは、Studio の認証と認可を設定する StudioConfig オブジェクトをデフォルトエクスポートします。これにより、Studio にアクセスできるユーザーと、認証済みユーザーが実行できる操作を指定します。
ファイルベースの規約については、このページを参照してください。認証 Provider、ロールベースアクセス制御（RBAC）、きめ細かな認可（FGA）については、Studio authを参照してください。
クイックスタートクイックスタートへの直接リンク
ローカル開発では、studio.ts は必要ありません。開発サーバーを起動し、Studio を開きます。
- npm
- pnpm
- Yarn
- Bun
npm run dev
pnpm run dev
yarn dev
bun run dev
ローカル開発では、Studio は認証なしで開きます。共有環境や本番環境のデプロイを保護する準備ができたら、studio.ts を追加してください。
認証を追加する認証を追加するへの直接リンク
ユーザーが Studio にアクセスする前にサインインを必須にするには、認証 Provider を使用します。次の例では WorkOS を使用します。
src/mastra/studio.ts
import { MastraAuthWorkos } from '@mastra/auth-workos'
import type { StudioConfig } from '@mastra/core/server'
export default {
auth: new MastraAuthWorkos(),
} satisfies StudioConfig
認証 Provider は、ユーザーが誰であるかを管理します。サインイン後にユーザーが実行できる操作を設定するには、同じ設定に RBAC または FGA を追加します。完全な例については、Studio authを参照してください。
コードとの優先順位コードとの優先順位への直接リンク
コードで登録した Studio の設定は、studio.ts より優先されます。プロジェクト全体で1つの Studio 設定があれば十分な場合は、studio.ts を使用してください。認証が src/mastra/index.ts のランタイム構成に依存する場合は、コードによる登録を使用してください。