隆重推出 Mastra 内置 MCP Server

使用 MCP 将 Claude Code、Cursor 或 VS Code 连接到你的 Mastra 服务器。

Paul Scanlon·

2026年11月17日

·

阅读时长 3 分钟

现在,你可以使用全新的 内置 MCP Server将你的智能体、工作流和工具暴露给 MCP。安装 @mastra/mcp、配置鉴权,你的整个 Mastra 服务器便可在 /api/mcp.

提供以下工具: call_agent, start_workflow,以及 get_trace随后,已配置的编码智能体或已连接的 MCP 客户端便可使用 Studio UI 来处理你通常自己完成的任务。

本次发布基于我们现有的 MCP 2.0 支持,并加入 MCP 任务 以及 MCP 事件 ,作为 Mastra MCP 服务器与客户端能力的最新成员。

请求通常需要 bearer token,并由你的鉴权提供方进行验证。每次 MCP 工具调用都使用与标准 HTTP 请求相同的服务器路由,并经过相同的 RBAC 以及 FGA 校验(如果已配置)。你还可以选择 MCP 服务器要暴露哪些智能体、工作流和工具。

开始使用

以下软件包,本示例使用 Mastra 平台鉴权。任何受支持的 鉴权提供方 也可使用:

终端
npm install @mastra/core@latest @mastra/mcp@latest @mastra/auth-studio@latest
需要 @mastra/core@1.83.0 或更高版本,添加于 PR #29929.

配置鉴权

在你的主 Mastra 实例上配置一个鉴权提供方,以在以下地址暴露 MCP 服务器: <server-url>/api/mcp:

src/mastra/index.ts
import { MastraAuthStudio } from "@mastra/auth-studio";
 
export const mastra = new Mastra({
  // ...
  server: {
    auth: new MastraAuthStudio({
      organizationId: process.env.MASTRA_ORGANIZATION_ID
    })
  }
});

在生产环境中,如果未配置鉴权提供方,Mastra 将不会暴露 MCP 服务器,但你可以使用以下方式覆盖此行为: enabled: true:

src/mastra/index.ts
export const mastra = new Mastra({
  // ...
  server: {
    mcp: {
      enabled: true
    }
  }
});

选择要暴露的内容

若想更严格地控制要暴露的内容,请使用 toolsets, include,以及 exclude 选择特定的智能体、工作流或工具:

src/mastra/index.ts
export const mastra = new Mastra({
  // ...
  server: {
    mcp: {
      toolsets: ["agents", "tools"],
      include: { agents: ["support-agent", "billing-agent"] },
      exclude: { tools: ["delete-account"] }
    }
  }
});

连接 Claude Code

,然后加上服务器 URL 和授权令牌:终端与你的 Mastra 服务器对话在你将 MCP 服务器添加到 Claude Code 的配置后,你可以调用你的智能体、运行工作流和工具,并读取记忆或追踪:更多信息及完整配置选项,请参阅:内置 MCP 服务器内置 MCP 工具参考连接客户端选择要暴露的内容鉴权与权限OAuth 发现分享到 X 或 LinkedInPaul Scanlon技术产品营销经理Paul Scanlon 常驻 mcp add,然后加上服务器 URL 和授权令牌:

终端
claude mcp add --transport http sit-rep <server-url>/api/mcp --header "Authorization: Bearer <token>"

与你的 Mastra 服务器对话

将 MCP 服务器添加到 Claude Code 的配置后,你可以调用智能体、运行工作流和工具,并读取记忆或追踪:

Run the docs-sync-workflow

更多信息及完整配置选项,请参阅:

分享到 或 LinkedInPaul Scanlon技术产品营销经理Paul Scanlon 常驻于 Mastra 的开发者和产品营销之间。此前,他曾担任 Neon 的技术产品营销经理,并在 Gatsby 从事开发者关系工作,负责创建教育内容和开发者体验。Paul Scanlon 的所有文章 →更多关于 MCP所有文章博客2026年11月11日在 Mastra 中推出 MCP Tasks在长时间运行的 MCP 工具调用期间解除智能体的阻塞。博客2026年10月23日推出 MCP Event 或 LinkedInPaul ScanlonPaul Scanlon技术产品营销经理

Paul Scanlon 在 Mastra 担任开发者教育与产品营销之间的职务。此前,他曾担任 Neon 的技术产品营销经理,并在 Gatsby 从事开发者关系工作,负责创建教育内容和开发者体验。

Paul Scanlon 的所有文章 →

更多关于 MCP

所有文章博客 2026年11月11日

在 Mastra 中推出 MCP Tasks

在长时间运行的 MCP 工具调用期间解除智能体的阻塞。

博客 2026年10月23日

在 Mastra 中推出 MCP Events

将实时事件从 MCP 服务器发送到智能体、工作流和应用。

博客 2026年10月21日

在 Mastra 中推出 MCP 2.0 支持

升级了对 MCP 2026-07-28 的支持。