Integração · MCP
Use o theo com o Claude e o ChatGPT via MCP
Conecte o Claude ao theo uma vez e peça em português: ele consulta os dados dos seus apps, escreve e organiza o seu MyNotes, monta bases, mapas e diagramas — no chat, no app ou no terminal. Sempre com a sua permissão.
- Claude
- Claude Code
- ChatGPT
- outros clientes MCP
notas_pastasachou Reuniões/Outubronotas_criar“Reunião com o fornecedor — 5/10”notas_criar_base“Tarefas da reunião” · 4 linhas
Pronto. A página com o resumo está em Reuniões/Outubro, e as 4 tarefas foram para uma base com responsável, prazo e status.
Abrir no theoComo funciona
MCP (Model Context Protocol) é o padrão aberto que liga assistentes de IA a outros sistemas. O theo oferece ferramentas; o Claude escolhe quais usar para cumprir o seu pedido — e mostra cada uma que usou.
Você
pede em português
Claude
escolhe as ferramentas
theo
faz e devolve
- 01
Conecte uma vez
Um endereço e um clique em Permitir na tela do theo.
- 02
Peça do seu jeito
Sem comando decorado: escreva como escreveria pra alguém da equipe.
- 03
Confira o que foi feito
Cada ferramenta usada aparece na conversa, e o resultado já está no theo.
O que dá pra pedir
Alguns pedidos que funcionam hoje. Cada cartão mostra o que o theo faz por trás.
- Escrever
“Resume esta conversa e salva no MyNotes, na pasta Clientes/Acme.”
Cria a página no lugar certo, e a pasta, se ainda não existir.
usa
notas_criar_pastanotas_criar - Editar
“Na proposta da Acme, troca o prazo de 30 para 45 dias e acrescenta uma seção de riscos.”
Troca só aquele trecho e encaixa a seção nova — o resto da página fica intacto.
usa
notas_editarnotas_inserir - Bases
“Cria uma base de leads com nome, status (novo, em conversa, fechado) e próximo contato, e já coloca estes cinco.”
Uma base de verdade, que abre como tabela, Kanban, lista ou calendário.
usa
notas_criar_basenotas_base_adicionar - Seus apps
“No app de Pedidos, quanto vendi esta semana e quais pedidos estão atrasados?”
Lê as tabelas do app e responde com os números, sem mudar nada.
usa
app_estruturaapp_consultar - Seus apps
“Marca os pedidos 1042 e 1043 como entregues.”
Altera só aquelas linhas e mostra o que mudou.
usa
app_alterar - Desenhos
“Transforma este processo de compra num fluxograma, e o planejamento de 2027 num mapa mental.”
Um diagrama e um mapa mental editáveis no MyNotes.
usa
notas_criar_diagramanotas_criar_mapa - Organizar
“Move tudo que é de 2025 para a pasta Arquivo e manda as páginas vazias pra lixeira.”
Arruma as pastas; o que vai pra lixeira dá pra restaurar.
usa
notas_listarnotas_movernotas_apagar - Compartilhar
“Compartilha a página Proposta com ana@empresa.com, só para leitura.”
Dá o acesso e avisa a Ana por e-mail.
usa
notas_convidar - Ligações
“Quais páginas falam do fornecedor Acme mas ainda não têm link pra página dele?”
Percorre as ligações entre as páginas e aponta as que faltam ligar.
usa
notas_grafo
Para quem programa
No terminal também: Claude Code
A especificação mora no MyNotes; o código, no repositório. Com o theo conectado, o Claude Code lê uma ponta e escreve na outra.
Da especificação ao código
“Lê a página Checkout v2 no MyNotes e implementa.”
Registro do que mudou
“No fim, escreve no MyNotes um resumo do que foi feito.”
Dados na mão ao depurar
“Consulta no app de Pedidos o pedido que deu erro.”
Já conectou o theo no Claude?
Entrando no Claude Code com a mesma conta, o theo já aparece lá — digite /mcp e ele está na lista. Não vale se o Claude Code usa chave de API.
# 1. adiciona o theo em todas as suas pastas
claude mcp add --transport http theo --scope user https://theo.beadev.ai/api/mcp
# 2. dentro do Claude Code: escolha o theo e entre (abre a tela Permitir)
/mcp
# 3. confere: o theo aparece com ✔ Connected
claude mcp list
Onde funciona
Claude
site e app de computador
- Personalizar → Conectores → Adicionar conector personalizado
- Nome theo e o endereço https://theo.beadev.ai/api/mcp
- Conectar → entrar no theo → Permitir
Claude Code
terminal, VS Code e JetBrains
- Um comando no terminal (acima)
- /mcp para entrar
- Ou: já vem junto se você conectou no Claude
ChatGPT
modo desenvolvedor, planos pagos
- Configurações → Apps → Avançadas → Modo desenvolvedor
- Criar app: nome theo, o endereço e OAuth
- Entre no theo → Permitir
Outros
qualquer cliente MCP com OAuth
- Endereço: https://theo.beadev.ai/api/mcp
- Login pelo navegador
- Mesma tela Permitir
Você no controle
O Claude trabalha em seu nome, com o seu alcance — e nada mais.
Nada sem o seu clique
A conexão só nasce na tela Permitir do theo, que diz quem pede e para onde o acesso vai.
Só o que é seu
Os seus apps e os do seu negócio; no MyNotes, as suas páginas. O banco confere cada comando antes de rodar.
Consultar não muda nada
Leitura roda em modo só-leitura. Alterar exige dizer quais linhas — “apague tudo” não passa.
Dá pra voltar
Página apagada vai pra lixeira, e o Claude consegue restaurar.
Corte quando quiser
Em Configurações → Conexões; o acesso cai na hora. Sua senha nunca sai do theo.
theo.
Claude quer acessar sua conta do theo
Conectado como voce@empresa.com
Ele vai poder, em seu nome:
- ler, buscar e criar páginas no seu MyNotes, e escrever nas que já existem
- ver os seus apps e consultar, criar, alterar e apagar registros neles
O acesso vai para claude.ai.
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.
Criar conta grátis