Passar para o conteúdo principal

Como conectar um assistente de IA ao Monde pelo MCP

Veja como conectar o Claude, o ChatGPT ou outro assistente de IA ao Monde pelo MCP.

Dúvidas respondidas

  • Como conecto o Claude ou o ChatGPT ao Monde?

  • Qual é o endereço do MCP do Monde?

  • Onde informo o endereço da agência ao conectar o assistente?

  • O que o assistente de IA consegue fazer no Monde?

  • Como desconecto o assistente de IA do Monde?

O que você vai resolver

Neste artigo, você vai aprender a conectar um assistente de inteligência artificial (IA) ao Monde pelo MCP, a liberar o acesso para cada usuário e a desconectar o assistente quando não quiser mais usá-lo.

  • Público-alvo: usuários da agência que querem consultar e cadastrar dados do Monde conversando com um assistente de IA, e o administrador que libera esse acesso.

  • Requisitos: licença de API ativa na agência, a permissão Acesso ao MCP (assistentes de IA) no grupo do usuário e um assistente de IA que aceite conector MCP personalizado.

Contexto ou termos-chave

Alguns termos aparecem ao longo do artigo:

  • Assistente de IA: o programa de inteligência artificial com que você conversa, como o Claude ou o ChatGPT.

  • MCP: sigla de Model Context Protocol, o padrão que o assistente usa para se conectar ao Monde e trabalhar com os dados da agência.

  • Conector: a ligação entre o assistente e o Monde. Cada usuário conecta o seu, com o próprio usuário e senha do Monde.

  • Endereço de Servidor: o endereço exclusivo da sua agência no Monde. Veja como descobrir o Endereço de Servidor.

Como liberar o acesso ao MCP para um usuário

O assistente trabalha com o usuário do Monde de quem o conectou, e só conecta quem tem a permissão Acesso ao MCP (assistentes de IA). Os usuários com Acesso Total já têm essa permissão.

Para liberar o acesso a um grupo de usuários:

  1. No Monde Web, acesse Funcionários > Permissões de Acesso

  2. Clique no grupo do usuário

  3. Na seção Direitos, na aba Gerais, clique na aba Cadastros

  4. No módulo Integrações, marque Acesso ao MCP (assistentes de IA)

  5. Clique em Salvar

Ao marcar Acesso ao MCP (assistentes de IA), o Monde Web marca também o Acessar do módulo Integrações, e o grupo passa a abrir a tela de Integrações.

No Monde Desktop, a mesma permissão fica em Funcionários > Permissões de Acesso, no grupo do usuário, dentro de Integrações. Veja como configurar as permissões de acesso.

Como conectar o assistente de IA

A conexão é feita no próprio assistente, com o endereço do MCP do Monde, que é o mesmo para todas as agências:

https://web.monde.com.br/mcp

Para conectar:

  1. No assistente de IA, abra as configurações de conectores e adicione um conector personalizado. No Claude, por exemplo, acesse Configurações > Conectores > Adicionar conector personalizado

  2. Dê um nome ao conector, como Monde, e informe o endereço https://web.monde.com.br/mcp

  3. Clique para conectar. O assistente abre o Monde no navegador

  4. Na tela Entrar, selecione o endereço de acesso da agência e entre com o seu usuário e a sua senha do Monde. Se o navegador já está conectado ao Monde Web de uma agência só, o Monde vai direto para o passo seguinte

  5. Na tela Autorização necessária, clique em Autorizar

A conexão fica ativa: você não precisa autorizar de novo a cada conversa.

Quando o endereço da agência não aparece

A tela Entrar lista os endereços de acesso já usados naquele navegador. Se o navegador ainda não usou nenhum, o Monde abre a tela Acesso ao sistema, que pede o endereço. Se o da sua agência não está na lista, clique em Endereço de acesso não está listado? para abrir a mesma tela.

Na tela Acesso ao sistema, para informar o endereço da agência:

  1. Em Endereço de acesso, depois de web.monde.com.br/, informe o Endereço de Servidor da agência, que é a parte do endereço do Monde Web que vem depois da barra. Exemplo: se o Monde Web da agência abre em web.monde.com.br/agencia, informe agencia

  2. Clique em Continuar

  3. Entre com o seu usuário e a sua senha do Monde

Se você não sabe o endereço:

  1. Na mesma tela, informe o e-mail do seu usuário no Monde e clique em Receber endereços de acesso

  2. No e-mail, clique no link da sua agência, no mesmo navegador em que a conexão começou

  3. Entre com o seu usuário e a sua senha do Monde

Depois do login, o Monde mostra a tela Autorização necessária, e a conexão continua do passo 5.

Conectar mais de uma agência

O conector fica ligado à agência escolhida no login. Para usar o assistente também com outra agência, adicione mais um conector com o endereço do MCP daquela agência:

https://web.monde.com.br/[seuservidor]/mcp

Troque [seuservidor] pelo Endereço de Servidor da agência. Exemplo: se o Monde Web da agência abre em web.monde.com.br/agencia, o endereço é https://web.monde.com.br/agencia/mcp. Os conectores que já usam esse endereço continuam funcionando.

O que o assistente de IA faz no Monde

Conectado, o assistente atende pedidos escritos em linguagem natural, como "cadastre uma conta a pagar de R$ 500 para o fornecedor X com vencimento dia 10". Ele consegue:

  • Pessoas: buscar, consultar, cadastrar e alterar clientes e fornecedores;

  • Contas a Pagar/Receber: buscar, cadastrar, alterar, excluir e liquidar lançamentos, dividir o valor entre categorias ou entre contas e anexar arquivos;

  • Orçamentos: buscar, criar e alterar;

  • Consultas: vendas, movimentações, saldos das contas, tarefas, viagens, notas fiscais, reembolsos e os principais relatórios do Monde Web, como vendas por vendedor, ranking de clientes e lançamentos por categoria;

  • Indicadores e dashboards: montar totais, comparações e gráficos com os dados da agência e salvar o dashboard no Monde. Veja como abrir os dashboards salvos pelo assistente de IA.

O assistente respeita as permissões do seu usuário: o que você não pode ver ou alterar no Monde, ele também não pode. Tudo o que ele grava aparece no log com o seu usuário.

Como desconectar o assistente de IA

Para parar de usar o assistente com o Monde, remova o conector nas configurações de conectores do assistente.

Para cortar o acesso de um usuário pelo Monde, tire do grupo dele a permissão Acesso ao MCP (assistentes de IA), em Funcionários > Permissões de Acesso. A partir do próximo pedido, o assistente desse usuário deixa de acessar o Monde. O usuário com Acesso Total continua com a permissão enquanto tiver o Acesso Total.

Mensagens de erro conhecidas

As três primeiras mensagens abaixo aparecem no navegador, na tela que o assistente abre ao conectar com o Monde. As outras duas aparecem na conversa, quando você pede ao assistente para cadastrar, alterar ou excluir algo.

Endereço de acesso não encontrado. Confira o endereço ou receba seus endereços por e-mail.

Causa: o endereço informado na tela Acesso ao sistema não é o de nenhuma agência do Monde.

Como resolver: confira o endereço e informe-o de novo. Se não souber o endereço, informe o e-mail do seu usuário no Monde para receber os endereços de acesso, como mostra a seção Quando o endereço da agência não aparece.

Acesso à API não habilitado

Causa: a agência não tem licença de API ativa.

Como resolver: fale com a Monde para contratar a licença da API. Veja como solicitar a API do Monde.

Acesso ao MCP não liberado para o seu usuário

Causa: o grupo do seu usuário não tem a permissão Acesso ao MCP (assistentes de IA).

Como resolver: peça ao administrador da agência para marcar essa permissão no seu grupo, no Monde Web, em Funcionários > Permissões de Acesso, como mostra a seção Como liberar o acesso ao MCP para um usuário.

A licença de API atual é somente leitura.

Causa: a licença de API da agência é somente leitura. Com ela, o assistente consulta os dados, mas não grava nada no Monde.

Como resolver: faça o cadastro ou a alteração pelo Monde Web ou pelo Monde Desktop, ou fale com a Monde para mudar a licença da API.

A empresa [nome da empresa] está disponível somente para leitura.

Causa: o registro é de uma empresa com licença somente leitura, que segue aberta para consulta mas não recebe cadastro nem alteração.

Como resolver: o registro que já é dessa empresa não pode ser alterado pelo assistente. Para um cadastro novo, peça ao assistente para gravar numa empresa da agência que não esteja somente para leitura.

Limitações conhecidas

  • Com a licença de API somente leitura, o assistente consulta os dados, mas não cadastra, não altera e não exclui nada, nem salva dashboards. Não há contorno pelo assistente: faça a gravação pelo Monde Web ou pelo Monde Desktop.

  • O assistente não envia imagens para os orçamentos. Imagens de orçamento são enviadas pelo Monde Web.

  • Alguns planos dos assistentes de IA não oferecem conector personalizado. Confira no assistente se o seu plano permite.

Validação e próximos passos

Para garantir que a conexão deu certo, peça ao assistente para buscar no Monde um cliente que você sabe que está cadastrado, como "busque o cliente Maria Silva no Monde". Se ele responder com os dados do cliente, o assistente está conectado.

Respondeu à sua pergunta?