AI & Agents
O Endpoint MCP Remoto
O servidor MCP é uma ferramenta de desenvolvedor: ele roda na sua máquina e mantém uma chave de
serviço ou uma chave de API. Um backend implantado também pode servir o próprio MCP, em /mcp, para
as pessoas que usam sua aplicação. Um assistente conectado por uma delas lê e
grava no projeto como essa pessoa, e cada chamada é executada sob sua própria
row-level security.
Ele fica desativado a menos que você o ative, e ambas as variáveis são obrigatórias:
REBASE_MCP_ENABLED=trueREBASE_PUBLIC_URL=https://app.example.com # this deployment's real originSem REBASE_PUBLIC_URL, um segredo JWT ou um driver de dados que possa delimitar uma consulta
a um usuário, o endpoint se recusa a montar e informa o motivo no log de inicialização. Nenhum
REBASE_ROLE o ativa.
-
OAuth, com uma tela de consentimento. Um cliente localiza o servidor de autorização por meio de
/.well-known/oauth-protected-resource, registra-se (o registro dinâmico está ativado por padrão;REBASE_MCP_OPEN_REGISTRATION=falseo limita aos clientes que você registrar) e envia a pessoa para uma tela de consentimento que faz o login por meio do seu/auth/loginexistente. Uma conta com um segundo fator é então solicitada pelo seu código do autenticador ou um código de recuperação, por meio das rotas existentes/auth/mfa/challenge. Quando o próprio frontend do seu app mantém uma sessão no mesmo navegador, a tela oferece essa conta, e o botão Permitir consente como ela sem senha; é assim que alguém que faz login apenas com Google, GitHub ou link de e-mail se conecta. Caso contrário, faz login com uma senha, e quem não tiver uma define uma primeiro com/auth/forgot-password(“Esqueci minha senha” do seu app); a tela informa isso. Ela também indica o host para o qual o código de autorização é enviado e informa que esse host não é verificado: qualquer pessoa pode registrar um cliente com qualquer nome, portanto o host é a parte que uma pessoa pode verificar. -
Dezessete ferramentas, três escopos. Os mesmos escopos que todas as credenciais usam.
data:readoferecelist_collections,describe_collection,query_collection,count_documents,aggregate_documents,get_document, as três visualizações,show_collection,show_recordeshow_app,show_app_guide, e as experimentaislist_appseopen_app;data:writeadicionacreate_document,update_documente as experimentaissave_appedelete_app;data:deleteadicionadelete_document. Um cliente que não solicita nada recebedata:read. Cada um se restringe a uma coleção:data:read:postslista, descreve e lêpostse nada mais. Um escopo decide quais ferramentas são oferecidas e quais coleções elas alcançam, não quais linhas: uma lista vazia pode ser o RLS funcionando, edata:writeainda assim não pode gravar uma linha que a pessoa não poderia. -
Três ferramentas colocam seu painel de administração na frente da pessoa. Em um cliente que renderiza MCP Apps, como o Claude, elas abrem as próprias visualizações do painel de administração na conversa, extraídas de suas coleções: seus campos, enums, validação, relações, seções de formulário e configurações de visualização.
-
show_collectionrecebe os argumentos dequery_collection, maisview(table,list,cardsoukanban), e abre a visualização da coleção: a pessoa pode pesquisar, filtrar, ordenar e paginar, abrir o formulário de uma linha e adicionar linhas. -
show_recordabre o formulário de uma linha (id), ou um formulário para uma nova linha que começa a partir dosvaluesque o modelo preencheu, para que a própria pessoa verifique e salve. -
show_appexecuta um app que o modelo escreve para a tarefa em questão: um componente React (code) e ascollectionsque ele lê. Ele importa os próprios pacotes do Rebase, portanto o mesmo código funciona no seu projeto:@rebasepro/app:useRows,useRow,useRowCount,useAggregateeuseRowWritessobre as linhas do projeto;@rebasepro/cms: oCollectionPaneldo painel de administração (comCollectionToolbare suas partes, eonRowClick, que entrega ao app a linha clicada conformeuseRowsa lê),RecordFormeFormField,RecordDetail,FieldValueeuseSidePanel, cada um nomeando sua coleção por caminho, com seus campos, visualizações e ações customizados;@rebasepro/ui, todo o kit de interface,SplitViewe os blocos de KPI e gráficos incluídos.
O servidor o compila primeiro, portanto um erro de sintaxe, um módulo que a visualização não fornece ou um nome que ela não fornece de
@rebasepro/cmsou@rebasepro/appé o erro da chamada, com sua linha. Um erro durante a execução é exibido em seu lugar e informado ao modelo na próxima mensagem da pessoa. Um app pode usar apenas as coleções que listar. Seus estilos são os utilitários padrão do Tailwind, compilados com a visualização antes de qualquer app chegar: um valor arbitrário comoh-[560px]não faz nada ali, portanto um tamanho exato é umstyle.A descrição de
show_apptraz apenas o essencial, porque um cliente pode cortar uma descrição de ferramenta longa demais (o claude.ai faz isso em cerca de 4.000 caracteres). Ela diz ao modelo para chamarshow_app_guideprimeiro, que devolve todos os hooks, componentes e props que um app pode usar, com um exemplo completo.show_app_guideé oferecida onde quer queshow_appseja oferecida.
Cada leitura e salvamento na visualização é uma chamada das ferramentas de leitura e gravação, feita como a pessoa sob sua RLS, portanto um formulário oferece apenas o que foi concedido à conexão dela: sem
data:write, ele é somente leitura, e um campo que suas roles não podem ler não aparece nele. Esse é o limite dentro do qual o código de um app também opera: ele roda na visualização, portanto cada chamada feita é uma daquelas ferramentas, como a pessoa, e ele não pode fazer nada que o modelo não pudesse fazer com as mesmas ferramentas. No conector hospedado, cada gravação também é planejada e confirmada pelo servidor. Dentro disso, ouseRowWritespergunta à pessoa antes de gravar, para que um app não grave sem o clique dela; os próprios controles do admin (o Salvar de um formulário, uma exclusão, uma edição de tabela) se comportam como em uma tela deshow_collection. O modelo é informado sobre o que mudou. Ele lê as linhas retornadas por cada ferramenta, não as configurações de coleção com as quais a visualização é renderizada. Um cliente sem MCP Apps, como o Claude Code ou Cursor, não mostra nada, e o modelo lê as mesmas linhas que leria comquery_collection. -
-
Experimental: apps salvos no projeto.
save_appguarda um app que o modelo construiu comshow_apppara que ele abra de novo: compila o código comoshow_appfaz e o armazena com seutitle, suascollectionse suavisibility, que épersonal(seu dono, o padrão),roles(quem tiver um de seusroles) outeam(todos que fazem login). Salvar para mais alguém além de você exige o papel de admin, pois um app compartilhado é código que uma IA escreveu, rodando para outras pessoas. Só o dono ou um admin substitui (id) ou exclui um app, e uma pessoa mantém no máximo 200.list_appslista os apps que quem chama pode abrir,open_appabre um comoshow_appfaria, edelete_appremove um. Ver um app não é alcançar seus dados: um app aberto lê e escreve pelas ferramentas acima, como quem o abre, sob o RLS dessa pessoa. Os apps ficam emrebase.saved_apps, que o backend cria na primeira vez que uma ferramenta o usa e não concede a nenhum usuário final. O painel de administração abre os mesmos apps: adicionesavedAppsViewde@rebasepro/cmsàs suasviews. Ele roda um app em um iframe isolado semallow-same-origine sem rede própria, e repassa as chamadas de ferramentas paraPOST /api/admin/apps/mcp, as mesmas ferramentas para a sessão do painel de administração, montado com as rotas de administração esteja ou não definidoREBASE_MCP_ENABLED. Os nomes e formatos das ferramentas ainda podem mudar. -
Concessões feitas antes da versão 0.24 mantêm seu alcance.
mcp:readé lido comodata:read, emcp:writecomodata:write data:delete, em concessões armazenadas e em tokens já emitidos. -
Uma chave de API também funciona.
/mcptambém aceitaAuthorization: Bearer rk_…, para um cliente configurado com um cabeçalho em vez de um fluxo OAuth. A chave acessa as ferramentas que seus escoposdata:*cobrem, atuando como quem ela representa: uma chave pessoal como seu proprietário, uma chave de serviço comoapi-key:<id>. -
O vocabulário do SDK, as respostas do REST. As ferramentas aceitam o que o SDK aceita —
where({"status": ["==", "paid"]}),orderBy(["created_at", "desc"]ou"created_at:desc"),limit,offset,searchStringedatapara uma gravação — e leem por meio do caminho deGET /api/data/<collection>, de modo que uma linha retorna como o REST a serve (datas em ISO, umbelongsTocomo sua chave estrangeira, ex.:authorId) e pode ser enviada de volta em uma atualização sem alterações.query_collectionresponde{ data, meta }commeta.totalemeta.hasMore, ecount_documentscom{ count };tools/listdá às duas, aaggregate_documentse aget_documentumoutputSchema, flexível onde uma resposta varia.aggregate_documentséGET /api/data/<collection>/aggregate:selecté uma lista na gramática do REST (["count()", "sum(total)"]),groupByuma lista de campos, e responde{ data }com uma linha por grupo, maismeta.hasMoreem uma chamada agrupada, cujos grupos paginam comlimiteoffsete ordenam comorderBy. Em uma coleção que um callbackafterReadreescreve, ele serve apenascount(), assim como o REST faz. Como no REST, umlimitacima de 1000, um argumento não declarado e uma edição ou exclusão de uma linha na lixeira (404) são recusados; definir o campo de soft-delete comonulla restaura.deleted: "only"(ou"include") emquery_collection,count_documentseaggregate_documentslê a lixeira, assim como o?deleted=do REST faz, para que uma linha movida para a lixeira pordelete_documentpossa ser encontrada novamente para restauração. Sua descrição informa ao modelo que a exclusão é permanente apenas onde a coleção não possui um campo de soft-delete. -
A listagem nomeia as coleções;
describe_collectionfornece o schema de uma delas.list_collectionsresponde com oname,titleedescriptionde cada coleção, edescribe_collection { collection }com os schemas OpenAPI derowecreatedessa coleção, maissoftDeleteFieldonde as linhas vão para uma lixeira. As descrições das ferramentas instruem o modelo a descrever uma coleção antes de gravar nela. A listagem de um projeto com 200 coleções tem cerca de 5k tokens, e cada descrição menos de 1k; com todos os schemas na listagem, eram cerca de 150k. -
Um token apenas para este endpoint. Um token de acesso MCP é recusado por
/api/data,/api/admine pelo WebSocket, portanto conectar um assistente não concede a ele uma sessão.
Toda requisição para /mcp relê a conta da pessoa. Uma conta excluída ou desativada,
ou um “encerrar sessão em todos os lugares” ou alteração de senha após a emissão
do token, interrompe imediatamente um cliente conectado com um 401. Um rebaixamento de permissões se aplica à
sua próxima chamada de ferramenta. Todo refresh faz as mesmas verificações e recusa definitivamente
tal concessão. Uma sessão de convidado não pode dar consentimento de forma alguma.
Um limite. Desconectar um cliente (DELETE /api/oauth/grants/:clientId, com a
própria sessão da pessoa) revoga seus refresh tokens imediatamente, mas um token de acesso
já emitido continua funcionando até expirar, dentro de uma hora.
As rotas estão em Endpoints e as variáveis em Configuração.