Integração · MCP
Use o theo com o Claude e o ChatGPT via MCP
O theo tem um servidor MCP (Model Context Protocol, o padrão aberto que liga assistentes de IA a outros sistemas). Conectado a ele, o Claude — e outros assistentes que falam MCP, como o ChatGPT no modo desenvolvedor — consegue consultar e alterar os dados dos seus apps e buscar, ler e escrever no seu MyNotes, sempre com a sua permissão. O endereço é https://theo.beadev.ai/api/mcp.
O que dá para fazer
- "Quantos pedidos atrasados eu tenho no app de pedidos?" — o assistente olha a estrutura do app e consulta a tabela.
- "Marque o pedido 42 como entregue." — ele altera o dado (o ChatGPT e o Claude pedem confirmação antes).
- "Resuma a página 'Reunião de segunda' do meu MyNotes" ou "crie uma página com este plano na pasta Projetos".
- "Compare as vendas deste mês com as do mês passado e escreva o resumo numa nota."
As 9 ferramentas
| Ferramenta | O que faz |
|---|---|
apps_listar | lista os seus apps |
app_estrutura | mostra as tabelas e colunas de um app |
app_consultar | lê dados (só leitura) |
app_alterar | insere, atualiza ou apaga dados |
notas_buscar | acha páginas do MyNotes pelo título |
notas_ler | devolve uma página em Markdown |
notas_pastas | lista as pastas |
notas_criar | cria uma página |
notas_escrever | acrescenta ou substitui o texto de uma página |
As ferramentas de leitura são marcadas como só-leitura no protocolo, para o assistente saber o que muda dado e o que não muda.
Passo a passo: Claude
No Claude (site e app de computador), planos Free, Pro e Max:
- Abra Personalizar → Conectores e clique em Adicionar conector personalizado (no plano Free cabe um conector personalizado).
- Dê um nome (por exemplo, theo) e cole o endereço:
https://theo.beadev.ai/api/mcp - Clique em Adicionar e depois em Conectar. O Claude abre a tela de login do theo.
- Entre na sua conta do theo. Aparece a tela Permitir, que diz quem está pedindo acesso e para onde o acesso vai. Confira e clique em Permitir.
- Numa conversa, clique em + → Conectores e ligue o theo. Pronto: peça "quais apps eu tenho no theo?".
Planos Team e Enterprise: quem é dono da organização adiciona o conector em Configurações da organização → Conectores; depois cada pessoa conecta a própria conta em Personalizar → Conectores.
Os nomes dos menus são os do Claude em setembro de 2026 e podem mudar.
Passo a passo: Claude Code
No Claude Code (terminal):
claude mcp add --transport http theo https://theo.beadev.ai/api/mcp
Depois, dentro do Claude Code, rode /mcp, escolha o theo e faça o login no navegador (a mesma tela Permitir).
Passo a passo: ChatGPT
No ChatGPT: servidores MCP próprios entram pelo modo desenvolvedor, disponível na versão web para os planos pagos (Plus, Pro, Business, Enterprise e Edu; nos planos de empresa, o administrador precisa liberar antes).
- Ligue o modo desenvolvedor nas configurações do ChatGPT.
- Crie um app (ou plugin) novo com o endereço
https://theo.beadev.ai/api/mcp. - Faça o login no theo e clique em Permitir.
O ChatGPT pede confirmação antes de usar ferramentas que alteram dados. A OpenAI mudou os nomes desses menus mais de uma vez em 2026 — se não achar, procure por "modo desenvolvedor" na ajuda do ChatGPT.
Segurança: o que o assistente alcança
- Nada acontece sem o seu clique. A conexão só nasce na tela Permitir do theo, que mostra quem pede e para onde vai. O login usa OAuth com PKCE; o theo guarda só o hash dos tokens, e a renovação troca o token a cada uso.
- Só os seus apps (e os do negócio de que você faz parte) — nunca o app público de outra pessoa, nem os modelos da vitrine.
- Só as tabelas daquele app. Cada comando é conferido pelo próprio banco antes de rodar: consulta que tente ler outra tabela é recusada. Leitura roda numa transação só-leitura;
UPDATEeDELETEexigemWHERE; um comando por vez. - Página do MyNotes em edição ao vivo (tempo real) não é sobrescrita — o assistente é orientado a criar uma página nova em vez de atropelar quem está escrevendo.
- Desligar é um clique: em Configurações → Conexões você vê quem está conectado e desconecta.
O que ainda não foi testado
O caminho inteiro — registro do cliente, login, Permitir, uso das ferramentas, renovação do token e a detecção de token roubado — foi provado em produção por um cliente automático que segue o mesmo protocolo. Cada assistente (Claude, ChatGPT) tem detalhes próprios na conexão; se a sua falhar, fale com a gente dizendo qual assistente e em que passo parou.
Perguntas frequentes
- O que é MCP?
- É o Model Context Protocol, um padrão aberto para conectar assistentes de IA a outros sistemas. Com ele, o assistente usa ferramentas que o sistema oferece — no caso do theo, consultar os seus apps e mexer no seu MyNotes.
- Qual é o endereço do servidor MCP do theo?
- https://theo.beadev.ai/api/mcp
- Preciso de plano pago no Claude?
- Não. No plano Free do Claude cabe um conector personalizado. No ChatGPT, servidores MCP próprios pedem o modo desenvolvedor, que fica nos planos pagos.
- O assistente consegue ver os dados de outras pessoas?
- Não. Ele só alcança os apps que são seus ou do negócio de que você faz parte, e só as tabelas de cada app. O próprio banco confere cada comando antes de rodar.
- Como desconecto?
- Em Configurações → Conexões, no theo. A conexão cai na hora.
- Quanto custa?
- Nada a mais: o servidor MCP faz parte do theo, que começa grátis e sem cartão.
Conecte o seu assistente
Crie a sua conta grátis no theo e siga o passo a passo acima. Sem cartão.
Grátis, sem cartão · Banco de dados no Brasil