# Conectar um assistente pelo MCP

> Conecte um assistente compatível pelo Conector MCP, confira o pedido de acesso, escolha OAuth ou chave e saiba como desconectar.

- Artigo: https://maisgestao.com.br/base-de-conhecimento/conectar-assistente-pelo-mcp
- Categoria: Migração e integrações
- Atualizado em: 2026-10-31
- Verificado em: 2026-10-31
- Disponível em: O Conector MCP faz parte do Assistente de IA, incluído no plano Corporativo.
- Antes de usar: Entre com um usuário ativo da empresa; usuários internos de suporte ou de sistema não podem criar a conexão. O Conector MCP não exige uma permissão própria de cargo. As operações disponíveis ao aplicativo dependem das permissões do seu usuário e das capacidades do plano. Use um assistente compatível com MCP. A sessão do painel precisa cumprir o segundo fator quando ele estiver configurado.
- Fonte: base de conhecimento do Mais Gestão, sistema de gestão financeira para empresas de serviço.

Para conectar um assistente pelo MCP, abra o menu do seu perfil, clique em **Conector MCP** e depois em **Conectar**. Escolha **OAuth (recomendado)** e cole a **URL do servidor MCP** no assistente.

## O que conferir antes de conectar o assistente pelo MCP

MCP é o padrão que deixa um assistente de IA, como Claude, ChatGPT ou Cursor, usar o Mais Gestão. A conexão pertence ao seu usuário e age com as permissões dele.

- O Conector MCP faz parte do Assistente de IA, incluído no plano **Corporativo**. Sem ele, o item não aparece no menu do perfil.
- Entre com um usuário ativo da empresa. Usuários internos de suporte ou de sistema não criam conexão.
- Use um assistente compatível com MCP. As [chaves da API REST](https://maisgestao.com.br/base-de-conhecimento/criar-e-consultar-chaves-de-acesso-da-api) são outro fluxo e não servem aqui.

## Como conectar um assistente pelo MCP com OAuth

1. No menu do seu perfil, clique em **Conector MCP** e depois em **Conectar**.
2. Na janela **Conectar um assistente de IA**, escolha **OAuth (recomendado)** e clique em **Continuar**.
3. Clique em **Copiar URL**, ao lado de **URL do servidor MCP**.
4. No assistente, adicione um conector personalizado e cole a URL. Se houver opção de autenticação, escolha OAuth com registro automático do cliente.
5. Inicie a conexão no assistente. Entre com sua conta do Mais Gestão e conclua o segundo fator, se pedido.
6. Na tela **Autorizar acesso ao MCP**, confira o pedido e clique em **Autorizar**.
7. Volte ao Mais Gestão e clique em **Concluir** na janela.

![Janela Conectar um assistente de IA com os métodos OAuth e Chave de acesso, além de Cancelar e Continuar.](https://maisgestao.com.br/base-de-conhecimento/images/2026-10-30/mcp-escolher-metodo.jpg)

*Escolha do método de conexão: OAuth, recomendado, ou Chave de acesso, para ferramentas sem OAuth.*

1. OAuth é a opção recomendada: você entra com sua conta e confere o pedido de autorização, sem copiar chave.
2. Chave de acesso serve para ferramentas sem OAuth. Escolher a opção ainda não gera uma chave.

## Tour desta tela

Os passos abaixo seguem os tours destas telas no Mais Gestão, na mesma ordem. Alguns passos só aparecem conforme a aba, a etapa ou as permissões do seu acesso.

### Autorizar acesso ao MCP

1. **Confira o pedido de conexão**: Aguarde o carregamento do pedido. Se aparecer um aviso de pedido inválido, expirado ou indisponível no plano, leia a mensagem antes de continuar. Abrir esta tela não aprova o pedido.
2. **Reconheça o aplicativo e o endereço de retorno**: Confira o nome do aplicativo e Retorno para. Ao autorizar, ele poderá usar o assistente com as suas permissões. Algumas ações têm execução direta; outras apresentam uma confirmação antes de executar. Autorize somente o aplicativo que você pretende conectar e confira os pedidos e resultados no assistente.
3. **Decida se deseja conceder o acesso**: Autorizar concede o acesso solicitado. Recusar rejeita o pedido. Use a opção correspondente à sua decisão; encerrar a orientação não aciona nenhuma delas. Depois, você pode desconectar o aplicativo na tela MCP do menu do seu perfil.

### Conector MCP

1. **Confira as conexões do seu usuário**: O Conector MCP reúne aplicativos autorizados por OAuth e chaves de acesso do seu usuário. Se a tela informar que seu plano não inclui o conector, confira a disponibilidade antes de tentar conectar.
2. **Escolha como conectar o assistente**: Conectar abre a escolha entre OAuth e Chave de acesso. Siga o método compatível com sua ferramenta. A chave é exibida uma única vez e usa o cabeçalho X-MCP-Key; guarde-a em local seguro. Abrir esta tela não gera chave nem autoriza um aplicativo.
3. **Separe aplicativos de chaves de acesso**: No filtro Tipo, escolha Todos, OAuth ou Chave de acesso. A ficha do filtro mostra o recorte aplicado e permite removê-lo.
4. **Acompanhe o uso e encerre acessos quando necessário**: Confira Nome, Tipo, Criado em, Último uso e Situação. Conexões ativas oferecem Desconectar aplicativo ou Revogar chave de acesso conforme o tipo. Essas ações exigem confirmação e interrompem aquele acesso; consultar a lista não exige encerrá-lo.

## O que conferir na tela Autorizar acesso ao MCP

A tela mostra o nome do aplicativo e o destino em **Retorno para**. Ao autorizar, o aplicativo usa o assistente com IA com as suas permissões. Não há uma seleção separada de permissões: para limitar o acesso, revise os [cargos e permissões](https://maisgestao.com.br/base-de-conhecimento/criar-cargo-e-permissoes) com o administrador.

Se não reconhece o aplicativo ou não iniciou a conexão, clique em **Recusar**. Autorizar ou recusar devolve o navegador ao aplicativo.

## Como usar uma chave quando a ferramenta não usa OAuth

1. Na janela de conexão, escolha **Chave de acesso** e clique em **Continuar**.
2. Informe o **Nome da chave** e, se quiser, a **Validade**. Sem data, a chave vale até ser revogada.
3. Clique em **Gerar chave** e depois em **Copiar chave**. Ela aparece uma única vez.
4. Na ferramenta, envie a chave no cabeçalho **X-MCP-Key**, sem o prefixo Bearer, e clique em **Já guardei a chave**.

Não cole a chave na conversa com o assistente nem em chamados de suporte.

## Depois de conectar o assistente pelo MCP

A conexão aparece na lista **Conector MCP**, com **Nome**, **Tipo**, **Criado em**, **Último uso** e **Situação**. O filtro **Tipo** separa OAuth e Chave de acesso.

Algumas ações do assistente são diretas; outras pedem confirmação antes. Confira os pedidos e os resultados no assistente. Se ele pedir um arquivo, siga [enviar um arquivo solicitado pelo assistente](https://maisgestao.com.br/base-de-conhecimento/enviar-arquivo-ao-assistente).

As ferramentas disponíveis estão na [documentação MCP do Mais Gestão](https://maisgestao.com.br/docs/mcp).

## Como encerrar uma conexão do Conector MCP

Nas conexões ativas, use **Desconectar aplicativo** para OAuth ou **Revogar chave de acesso** para uma chave. Confira o nome e confirme: a ferramenta perde o acesso na hora.

## Se algo der errado ao conectar pelo MCP

- [**Esta tela não faz parte do plano contratado.**](https://maisgestao.com.br/base-de-conhecimento/erro-tela-nao-faz-parte-do-plano), **Seu plano não inclui o Conector MCP.** ou o item não aparece no menu: o plano da empresa não inclui o Assistente de IA.
- **Este pedido expirou ou já foi usado. Volte ao aplicativo e conecte novamente.**: inicie a conexão de novo pelo assistente.
- **Não foi possível concluir a autorização. Tente novamente pelo aplicativo.**: repita a conexão pelo assistente.
- A chave foi perdida: ela não é exibida de novo. Revogue a chave antiga e gere outra.

## Perguntas frequentes

### Quais assistentes de IA funcionam com o Conector MCP?

Assistentes compatíveis com MCP, como Claude, ChatGPT ou Cursor, que aceitam conector personalizado.

### OAuth ou chave de acesso: qual usar?

OAuth, sempre que o assistente aceitar. Você entra com sua conta e confere o pedido. A chave serve para ferramentas sem OAuth.

### O assistente pode fazer tudo no sistema?

Não. Ele age com as permissões do seu usuário e com os recursos do plano. Algumas ações pedem confirmação antes.

## Artigos relacionados

- [Enviar um arquivo solicitado pelo assistente](https://maisgestao.com.br/base-de-conhecimento/enviar-arquivo-ao-assistente)
- [Criar um cargo e definir permissões](https://maisgestao.com.br/base-de-conhecimento/criar-cargo-e-permissoes)
- [Criar e consultar chaves de acesso da API](https://maisgestao.com.br/base-de-conhecimento/criar-e-consultar-chaves-de-acesso-da-api)