Comparações
Copilotz vs Mastra
Os dois são frameworks de código aberto em TypeScript para construir com agentes. O Mastra é o maior e o mais maduro. O Copilotz começa pelo app, não pelo agente. Veja onde cada um se encaixa, com uma fonte para cada afirmação.
Verificado em 12 de novembro de 2026.
Em resumo
O Mastra é um framework em TypeScript para construir agentes e aplicações de IA: agentes, ferramentas, fluxos (workflows), memória, avaliações e observabilidade, com um roteador de modelos e o Studio, uma interface local. Chegou ao 1.0 em janeiro de 2026, lança versões toda semana e tem uma comunidade grande e uma empresa com investimento por trás.
O Copilotz é um runtime para apps que pessoas e IA usam do mesmo jeito. Você escreve uma vez os dados, as Actions e as regras do app. As pessoas usam numa página web, os agentes do próprio app chamam as mesmas Actions por ferramentas, e assistentes de fora chamam por MCP. Toda chamada diz quem age, para quem e onde, as regras são checadadado, e toda escrita entra num só registro. Tem licença MIT e ainda é um release candidate do 1.0.
Resumindo: para um projeto centrado em agentes que quer um ecossistema maduro hoje, o Mastra é a escolha mais forte. O Copilotz faz sentido quando o seu agente é só um dos que usam um app que pessoas também usam, e você quer quem pode fazer o quê garantido num lugar só.
Escolha o Mastra se…
- Você quer uma versão 1.x estável, atualizações toda semana e uma comunidade grande: cerca de 29.500 estrelas no GitHub e 3,2 milhões de downloads semanais do @mastra/core no npm.
- Você precisa de muitas integrações prontas: um roteador de modelos com 223 provedores, adaptadores de armazenamento do PostgreSQL ao DynamoDB, exportadores de traces e deploy pronto para Vercel, Netlify e Cloudflare.
- Você quer ferramentas em volta do código: o Studio, fluxos que pausam e retomam, e avaliações com scorers e integração com o Vitest.
- Você quer usar servidores MCP de fora como ferramentas, ou falar com pessoas no Slack, no Teams, no Discord ou no Telegram.
- Você quer uma plataforma hospedada para deploy e observabilidade, da mesma empresa.
Escolha o Copilotz se…
- Pessoas, os seus agentes e assistentes de fora usam o mesmo app, e cada mudança deve ser uma Action, chamada de todas as portas.
- Você quer regras de acesso embutidas no runtime de código aberto e checadas no dado para todo mundo que chama, com um agente nunca alcançando mais do que a pessoa para quem trabalha.
- Você quer um só registro que diga quem fez o quê, para quem e onde, em toda escrita.
- Você quer página web, terminal, REST, MCP com widgets no ChatGPT e no Claude, WhatsApp e voz a partir dos mesmos plugins.
- Você quer testar o app inteiro offline, com um modelo roteirizado e sem chave de API, e um release candidate serve para você.
Lado a lado
Cada afirmação aponta para a sua fonte. Os números mudam: estes foram lidos em 12 de novembro de 2026.
| Aspecto | Copilotz | Mastra |
|---|---|---|
| O que é | Copilotz:Um runtime para apps que pessoas e IA usam do mesmo jeito. Você escreve o app uma vez, em plugins: os dados, as Actions, quem pode chamá-las e como ele aparece.[1] | Mastra:Um framework em TypeScript para construir agentes e aplicações de IA: agentes, ferramentas, fluxos, memória, RAG, avaliações e observabilidade.[2] |
| Onde roda | Copilotz:Node 24 ou mais novo, Deno e Bun. Feito sobre padrões da web, também para Cloudflare Workers e o navegador.[1][3] | Mastra:Node.js 22.13 ou mais novo, Bun, Deno e Cloudflare Workers.[4][5] |
| Agentes, ferramentas e fluxos | Copilotz:Agentes são configuração: instruções, um modelo e ferramentas. Uma ferramenta só chama uma Action, a mesma que a página web e o MCP chamam. Processors reagem a eventos; agendamentos e rotinas rodam trabalho no horário.[1][3] | Mastra:Agent e createTool, com schemas em Zod e outros. Fluxos (createStep, createWorkflow) ramificam, rodam passos em paralelo, pausam e retomam.[6][7] |
| Memória | Copilotz:O plugin history resume conversas longas; o plugin memory lembra entre elas, por significado com um modelo de embeddings, ou por palavras sem ele.[3][8] | Mastra:Histórico de mensagens, memória de trabalho sobre os usuários entre conversas, e busca semântica nas mensagens passadas.[9][10] |
| MCP (cliente e servidor) | Copilotz:Servidor: o plugin mcp oferece as ferramentas do app ao ChatGPT, ao Claude e a qualquer cliente MCP, e desenha as Views web dentro deles como widgets. Ainda sem login no MCP: cada conversa entra como um contato. Cliente: não oferece; a documentação não usa servidores MCP de fora como ferramentas.[3][11][12] | Mastra:Cliente e servidor. O MCPClient usa as ferramentas de servidores MCP de fora; o MCPServer expõe agentes, ferramentas e fluxos; o servidor do Mastra também responde MCP em /api/mcp.[13][14] |
| Autenticação e regras de acesso | Copilotz:Embutido, sob MIT. Toda chamada diz quem age, para quem e onde. Cada Action diz quem pode chamá-la (allow), e isso vale para o agente e para quem ele trabalha. Regras no dado filtram toda leitura e checam toda escrita, seja qual for a porta.[1][3] | Mastra:Autenticação opcional e desligada por padrão, com provedores próprios e de terceiros. Controle de acesso por papéis e autorização refinada exigem uma licença Enterprise paga em produção (grátis em desenvolvimento). Ferramentas podem exigir aprovação.[15][16][17] |
| Persistência | Copilotz:Um só armazenamento para tudo: em memória, SQLite ou PostgreSQL, os três sob a mesma suíte de conformidade. Trocar de um para outro muda uma linha.[18] | Mastra:Adaptadores de armazenamento para libSQL, PostgreSQL, MongoDB, DynamoDB, Cloudflare D1, Redis e muitos outros.[19] |
| Observabilidade | Copilotz:Toda escrita e toda chamada de Action é um evento que diz quem agiu, para quem e onde. As métricas seguem o modelo do OpTelemetry, exportadas por OTLP ou em texto do Prometheus.[3][20] | Mastra:Traces de agentes, fluxos, ferramentas e chamadas de modelo; exportadores para Langfuse, Datadog e qualquer plataforma OpenTelemetry; e o Studio, uma interface para construir e testar.[21][22] |
| Testes | Copilotz:O app inteiro testado offline, com um modelo roteirizado e um relógio manual, sem chave de API. copilotz/testing é uma só API de testes para Node, Deno e Bun.[1][3] | Mastra:Avaliações: scorers (avaliados por modelo, por regras ou estatísticos), com uma integração com o Vitest que roda as avaliações como testes.[23][24] |
| Deploy | Copilotz:Você hospeda: um servidor web m Node e o armazenamento que o ambiente define, SQLite ou PostgreSQL, com um lease para que cada deploy passe a vez sem dois processos escrevendo.[25] | Mastra:Deploy pronto para Vercel, Netlify e Cloudflare, no seu próprio servidor, ou na plataforma hospedada do Mastra.[4][26] |
| Canais | Copilotz:Página web, terminal, API REST e cliente, MCP com widgets, WhatsApp (Cloud API da Meta), ligações de voz (Twilio) e um chat no seu site.[3] | Mastra:Canais para Slack, Microsoft Teams, Discord, Telegram, WhatsApp, GitHub e Linear; voz com fala para texto, texto para fala e fala em tempo real.[27][28] |
| Licença | Copilotz:MIT.[3] | Mastra:Apache 2.0 na maior parte do código. Os recursos Enterprise (em ee/) têm o código disponível para leitura, sob uma licença comercial.[16][29] |
| Maturidade | Copilotz:Release candidate: 1.0.0-rc.45, de 12 de novembro de 2026. O 1.0 ainda não saiu. Um projeto jovem, com uma comunidade pequena.[30] | Mastra:Estável: 1.0 em 20 de janeiro de 2026; @mastra/core 1.83.0 em 12 de novembro de 2026. Cerca de 29.500 estrelas no GitHub e 3,2 milhões de downloads por semana no npm.[31][32][33][34] |
| Ecossistema | Copilotz:Provedores de modelo por quatro protocolos (OpenAI, compatível com OpenAI, Anthropic e Gemini). Plugins próprios para login, espaços, memória, skills, rotinas, quadros, documentos e cobrança. Poucas integrações de terceiros por enquanto.[3][35] | Mastra:Um roteador com 8.285 modelos de 223 provedores, 30 templates e uma empresa que já captou US$ 35 milhões.[36][37][38] |
Uma ferramenta, em cada um
Os dois definem uma ferramenta com um schema e a entregam a um agente. No Mastra, o execute da ferramenta é o trabalho. No Copilotz, a ferramenta chama uma Action, a mesma que a página web e o MCP chamam, com o allow dela e as regras no dado.
import { createTool } from '@mastra/core/tools'import { Agent } from '@mastra/core/agent'import { z } from 'zod' export const weatherTool = createTool({ id: 'weather-tool', description: 'Fetches weather for a location', inputSchema: z.object({ location: z.string() }), outputSchema: z.object({ location: z.string(), temperatureCelsius: z.number(), conditions: z.string(), }), execute: async ({ location }) => { return { location, temperatureCelsius: 21, conditions: 'sunny' } },}) export const weatherAgent = new Agent({ id: 'weather-agent', name: 'Weather Agent', instructions: 'You are a helpful weather assistant. Use the weatherTool to fetch current weather data.', model: 'openai/gpt-6.1-sol', tools: { weatherTool },})
Fonte: mastra.ai: Tools
// From the README's salon.ts: one Action, three callers (excerpt).actions: { "booking.make": defineAction({ input: booking, // Asked of every caller, tools included: people, agents working for them, and contacts. allow: peopleOrContacts, run: (ctx, input) => ctx.db.collection("booking").insertOne(input), }),},views: { // What a model reads after it books, the app's own or one over MCP. "tool:book": (_, ctx) => ctx.show("bookings", {}),},resources: { // The rules: a booking lives in a space, and belongs to the chat it was made in. shared: { booking: { part: "thread" } }, tools: { book: tool({ description: "Books a slot, like 'Wed 15:00'.", input: { type: "object", properties: { slot: { type: "string" } }, required: ["slot"] }, run: ({ slot }, ctx) => ctx.call("booking.make", { slot, in: ctx.in, thread: ctx.thread }), }), }, agents: { concierge: { instructions: "Book slots.", model: "openai/gpt-5.4-mini", tools: ["book"] }, }, // An MCP server at /mcp/salon. No sign-in: each conversation is a contact, in its own chat. mcp: { salon: { in: "desk", tools: { book: {} } } },},
Fontes
O que dizemos sobre Mastra vem da documentação, do repositório, do npm e dos anúncios do próprio projeto; o que dizemos sobre o Copilotz, da documentação e do repositório dele. Achou algo errado ou desatualizado? Escreva para hello@copilotz.com e a gente corrige.
- [1]copilotz.com: AGENTS.md
- [2]mastra.ai: Docs
- [3]GitHub: copilotzhq/copilotz (README)
- [4]mastra.ai: Deployment overview
- [5]mastra.ai: Deploy to Cloudflare
- [6]mastra.ai: Tools
- [7]mastra.ai: Workflows
- [8]copilotz.com: the memory plugin
- [9]mastra.ai: Working memory
- [10]mastra.ai: Semantic recall
- [11]copilotz.com: the mcp plugin
- [12]copilotz.com: Getting Started
- [13]mastra.ai: MCP
- [14]mastra.ai: The server's MCP endpoint
- [15]mastra.ai: Auth
- [16]mastra.ai: License
- [17]mastra.ai: Human in the loop
- [18]copilotz.com: Stores
- [19]mastra.ai: Storage
- [20]copilotz.com: Metrics
- [21]mastra.ai: Observability
- [22]mastra.ai: Studio
- [23]mastra.ai: Evals
- [24]mastra.ai: Evals in Vitest
- [25]copilotz.com: Shipping the salon
- [26]mastra.ai: Mastra platform
- [27]mastra.ai: Channels
- [28]mastra.ai: Voice
- [29]GitHub: Mastra Enterprise License
- [30]GitHub: Copilotz releases
- [31]mastra.ai: Announcing Mastra 1.0
- [32]npm: @mastra/core
- [33]GitHub: mastra-ai/mastra
- [34]npm: @mastra/core downloads, 5–11 Nov 2026
- [35]copilotz.com: the models plugin
- [36]mastra.ai: Models
- [37]mastra.ai: Templates
- [38]mastra.ai: About
Veja por conta própria.
O guia constrói um app, para pessoas e para IA, em dez capítulos, e os testes rodam offline.
Ler o guia