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

Como 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

só depois do seu Permitir

theo

faz e devolve

MyNotes
Seus apps
  1. 01

    Conecte uma vez

    Um endereço e um clique em Permitir na tela do theo.

  2. 02

    Peça do seu jeito

    Sem comando decorado: escreva como escreveria pra alguém da equipe.

  3. 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.

    usanotas_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.

    usanotas_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.

    usanotas_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.

    usaapp_estruturaapp_consultar

  • Seus apps

    “Marca os pedidos 1042 e 1043 como entregues.”

    Altera só aquelas linhas e mostra o que mudou.

    usaapp_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.

    usanotas_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.

    usanotas_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.

    usanotas_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.

    usanotas_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.

~/projeto

# 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

    1. Personalizar → Conectores → Adicionar conector personalizado
    2. Nome theo e o endereço https://theo.beadev.ai/api/mcp
    3. Conectar → entrar no theo → Permitir
  • Claude Code

    terminal, VS Code e JetBrains

    1. Um comando no terminal (acima)
    2. /mcp para entrar
    3. Ou: já vem junto se você conectou no Claude
  • ChatGPT

    modo desenvolvedor, planos pagos

    1. Configurações → Apps → Avançadas → Modo desenvolvedor
    2. Criar app: nome theo, o endereço e OAuth
    3. Entre no theo → Permitir
  • Outros

    qualquer cliente MCP com OAuth

    1. Endereço: https://theo.beadev.ai/api/mcp
    2. Login pelo navegador
    3. 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.

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

Veja também