Pular para o conteúdo principal
Data e Schema

Esta página ainda não foi traduzida: mostrando a versão em inglês.

Integração do Backoffice com MCP

Com o MCP, um agente de IA trabalha no seu Project do mesmo jeito que você trabalha no Backoffice. Conecte um agente como o Claude ou o Cursor e ele passa a ler os seus dados, evoluir o Schema, gerenciar Players e o catálogo e fazer o deploy de Functions, tudo por conversa em linguagem natural. Tudo isso fica em AI Access, na seção Engineering da barra lateral.

O Model Context Protocol é um padrão aberto para dar ferramentas a agentes de IA. O servidor MCP do PlayServ oferece ao agente as mesmas operações do Backoffice, com as mesmas permissões da pessoa que faz login.


O que o agente pode fazer

ÁreaPor exemplo
Do briefing ao backendMontar um Project inteiro a partir de um único briefing: Schema, catálogo e Functions.
Schema e migraçõesAdicionar campos, criar Entities, planejar e aplicar migrações seguras.
DadosConsultar, criar e importar Records em massa; gerenciar relações e visualizações salvas. O agente não consegue criar Records de uma Entity que pertence a Players: para isso é preciso um Player logado.
PlayersEncontrar Players, gerenciar sessões, suspender ou banir.
Catálogo e lojasGerenciar itens e integrações, publicar lojas.
FunctionsInspecionar e fazer o deploy de Functions, gerenciar secrets, ler métricas e logs.
AnalyticsObter dashboards, linhas de base e eventos.
Projects e keysCriar Projects, emitir e rotacionar API keys.

Receitas prontas guiam o agente em tarefas de várias etapas, como configurar um Project do zero. O agente também alcança algumas coisas que o Backoffice não mostra, como os campos raw e o envio de um Schema a partir do código.


Níveis de permissão

Cada ferramenta é Read, Write ou Admin, então você pode deixar as leituras rodarem sozinhas e confirmar o resto.

NívelO que fazAprovação sugeridaEndpoint
ReadListagens, leituras, consultas, dashboards, métricas, logs. Nenhuma alteração.Aprovar automaticamente/mcp/read
WriteCria, atualiza, publica, ativa. Alterações reversíveis.Perguntar a cada vez/mcp/write
AdminExclusões, revogação de keys e sessões, banimento de Players, desconexões. Destrutivo.Negar por padrão; aprovar cada chamada/mcp/admin

Quando você se conecta a /mcp, o próprio cliente MCP agrupa as ferramentas por nível. Para tratar os níveis separadamente, adicione cada endpoint como um servidor próprio e defina a aprovação por servidor no cliente.


Conecte o seu cliente

Adicione o servidor ao seu cliente

Abra AI Access → Connect MCP e copie a configuração para o seu cliente: Claude Desktop, Claude Code, Cursor ou qualquer outro cliente MCP.

{
  "mcpServers": {
    "playserv": { "type": "http", "url": "https://platform.playserv.com/mcp" }
  }
}

No claude.ai, adicione-o como conector personalizado: em Settings → Connectors (ou Organization settings → Connectors nos planos Team ou Enterprise), escolha Add custom connector, dê o nome PlayServ e cole a URL.

Faça login

A primeira chamada do agente a uma ferramenta do PlayServ abre uma página de login. Entre com a conta Google ou GitHub que tem acesso ao seu estúdio no PlayServ. A partir daí, o agente age com as permissões dessa conta.

Verifique a conexão

Pergunte ao agente “Quais ferramentas do PlayServ você tem?”. Ele deve listá-las. Para inspecionar o servidor sem um agente, aponte o MCP Inspector para a mesma URL.

Nunca passe uma API key ao agente

O agente faz login como você; ele não precisa das API keys do seu Project, e uma key colada no chat pode ficar guardada junto com a conversa. Mantenha as keys no seu jogo, nos servidores e no CI.


Escolha o Project

Diga ao agente em qual Project trabalhar pelo slug, que aparece nas configurações do Project em Projects. O agente encontra o Project e o usa pelo resto da conversa.


Altere o Schema com segurança

Peça as alterações em linguagem natural; o agente descreve o que vai fazer antes de fazer. Revise o plano antes de confirmar.

U
Liste todas as Entities deste Project e descreva para que serve cada uma.
AI
O Project tem 4 Entities:
  • Ships — as naves que os Players podem pilotar
  • Pilots — uma por Player, pertence ao Player
  • MatchResults — um resultado por piloto por partida
  • ArenaConfig — singleton com as regras da partida
Quer que eu liste os campos de alguma delas?
U
Adicione a Ships um campo booleano IsRetired. Ele deve ser obrigatório, com padrão false.
AI
Vou preparar esta alteração em Ships:
  • Nome: IsRetired
  • Tipo: Primitive — Boolean
  • Obrigatório: sim, Padrão: false
Ships tem Records, então isso passa por uma migração: as naves existentes recebem o valor padrão. Posso planejar?
U
Crie um Enum chamado Difficulty com os valores Easy, Normal, Hard e Extreme.
AI
Criei o Enum Difficulty com 4 valores: Easy, Normal, Hard, Extreme. Agora ele pode ser usado por campos Enum reference.
U
Quais objetos referenciam ou incluem a Part Weapon?
AI
Weapon é usada em 2 lugares, ambos na Part Loadout:
  • Campo de inclusão Primary, 1 para 1
  • Campo de inclusão Secondary, 1 para 1
A própria Loadout está incluída em Pilots.
U
Ships tem três campos sobre dirigibilidade. Mova-os para uma nova Part chamada Handling e inclua-a em Ships.
AI
Este é o plano:
  • Criar a Part Handling com os três campos
  • Adicionar o campo de inclusão Handling em Ships, 1 para 1
  • Remover os três campos de Ships
Remover campos de uma Entity que tem Records é uma migração; vou mostrar o impacto antes de aplicar. Posso seguir?

Alterações pequenas que o agente pode fazer diretamente, como um objeto novo ou um campo opcional, valem na hora. Uma alteração que quebraria Records existentes, como remover um campo ou tornar um campo obrigatório numa Entity que tem Records, é recusada como alteração direta: o agente a planeja como uma migração, mostra o impacto e aplica quando você concordar. Configurações de acesso alteradas pelo agente valem na hora, sem a migração em que o Backoffice as prepara.


Gere um Schema a partir de um documento de game design

Cole um documento de game design, ou qualquer descrição dos dados do seu jogo, e peça ao agente que monte o Schema a partir dele. O agente lê o documento, propõe as Entities, Parts e Enums e os cria quando você aprovar.

Peça o plano primeiro

Antes que algo seja criado, peça ao agente um resumo do que ele encontrou e do que vai criar. Depois confira o resultado em Schema antes de criar dados em cima dele: renomear ou remover campos quando já existem Records exige uma migração.


Próximos passos

Atualizado em 16 de out. de 2026