Server

Mastra は、src/mastra/ 直下の server.ts ファイルから HTTP サーバーを設定します。サーバーは Agent、Workflow、その他の登録済みプリミティブを REST エンドポイントとして公開します。このファイルは、new Mastra() に渡すものと同じ形式の ServerConfig をデフォルトエクスポートします。

ファイルベースの規約については、このページを参照してください。サーバー機能、middleware、カスタムルート、生成される API ドキュメント、デプロイ時の動作については、Server の概要を参照してください。

クイックスタート

src/mastra/server.ts を作成し、ServerConfig オブジェクトをデフォルトエクスポートします。

src/mastra/server.ts

import type { ServerConfig } from '@mastra/core/server'

export default {
  port: 4111,
  host: '0.0.0.0',
} satisfies ServerConfig

一般的な設定

server.ts では、コードによる登録と同じサーバーオプションを設定できます。

目的	使用する設定
デプロイプラットフォームのアドレスにバインドする	host と port
ブラウザーからのアクセスを制限する	cors
Webhook やヘルスチェックを追加する	apiRoutes
API ドキュメントの生成を有効にする	build.openAPIDocs と build.swaggerUI

例については、Mastra server、middleware、カスタム API ルートを参照してください。

コードとの優先順位

コードで登録したサーバー設定は、server.ts より優先されます。ファイルベースのサーバー設定を適用しても、Channel の Webhook など、起動時に追加されたルートは保持されます。