Conecte o MCP usando conectores personalizados

Conectores personalizados permitem estabelecer uma conexão segura entre sua base de conhecimento e assistentes de IA compatíveis com MCP, como Cursor IDE e Copilot. Uma vez conectado, o assistente de IA pode interagir com o conteúdo da documentação do seu projeto Document360 via MCP.

Dependendo do seu assistente de IA, use um dos seguintes dispositivos:

• URL do servidor MCP - Use isso quando seu assistente de IA aceitar uma URL direta para a configuração do conector (por exemplo, Copilot).
• Configuração em JSON - Use isso quando seu assistente de IA precisar de um arquivo de configuração estruturado (por exemplo, IDE do cursor).

Antes de começar

• Garanta que o MCP esteja ativado no seu projeto Document360. Para os passos para habilitar o MCP, consulte a página Connect MCP ao seu assistente de IA .
• Você tem acesso a um assistente de IA que suporta configurações MCP ou conectores personalizados.

Obtenha a configuração JSON

Para obter os detalhes da configuração,

1. Navegue até Configurações () na barra de navegação da esquerda.

2. Vá para Configurações de IA > MCP.

3. Em Conectores Personalizados, clique em Obter detalhes.

   

4. A configuração do MCP será exibida.

5. Você pode copiar a configuração completa do JSON ou usar a URL fornecida nela, dependendo das necessidades do seu assistente de IA.

   Essa configuração é necessária para estabelecer a conexão MCP no seu assistente de IA.

URLs dos servidores MCP

Use as seguintes URLs de servidores MCP ao configurar conectores no seu assistente de IA. Selecione a URL apropriada com base na região ou ambiente do seu projeto. Cole a URL no campo de configuração do conector personalizado MCP no seu assistente de IA.

Cursor IDE

Para conectar o MCP no IDE do cursor:

1. Abra o cursor IDE.
2. Navegue até Configurações.
3. Vá para Ferramentas e MCP.
4. Clique em Adicionar novo servidor MCP.

Você será redirecionado para a tela de configuração do MCP.

1. Cole a configuração JSON do MCP copiada do Document360.
2. Guarde isso.

Após salvar:

1. Volte para as Configurações do Cursor do IDE, > Ferramentas e MCP.
2. Localize o servidor MCP configurado.
3. Assim que a autenticação estiver ativada, clique em Conectar.

Após criar a conexão:

1. Você será redirecionado para o Document360.
2. Revise a solicitação de conexão e escolha o projeto necessário.
3. Selecione a caixa de confirmação (eu entendo e confio nessa URL).
4. Clique em continuar.

A conexão agora está estabelecida. Você pode usar as capacidades do MCP diretamente dentro do IDE Cursor para buscar, recuperar e atualizar documentação enquanto codifica.

Copilot

Para conectar MCP em agentes Copilot:

Crie um novo agente

1. Faça login no ambiente do seu Copilot.
2. Navegue até Agentes.
3. Clique em Criar agente em branco.
4. Digite o nome do agente.
5. Clique em Criar.

Você será redirecionado para o agente recém-criado.

Adicionar MCP como ferramenta

1. Na página do agente, navegue até a aba Ferramentas na barra de navegação superior.
2. Clique em Adicionar uma ferramenta.
3. Selecione Protocolo de Contexto do Modelo.

Configurar configurações do MCP

1. Insira os seguintes detalhes:
   • Nome – Forneça um nome para o conector MCP
   • Descrição – Insira uma descrição (mínimo 30 caracteres)
   • URL – Cole a URL apropriada do servidor MCP
2. Em Método de Autenticação, selecione OAuth 2.0.
3. Garanta que a descoberta dinâmica esteja selecionada por padrão.
4. Clique em Criar.

Estabelecer conexão

1. Após criar a ferramenta, uma tela de Conexão aparecerá mostrando Não conectado.
2. Clique em Não conectado.
3. Selecionar Criar nova conexão.
4. Clique em Criar.

Após criar a conexão:

1. Você será redirecionado para o Document360.
2. Revise a solicitação de conexão e escolha o projeto necessário.
3. Selecione a caixa de confirmação (eu entendo e confio nessa URL).
4. Clique em continuar.

A conexão agora está estabelecida. O agente do Copilot pode interagir com sua base de conhecimento usando as capacidades MCP habilitadas no seu projeto.

Outras plataformas compatíveis com MCP

Você pode conectar qualquer outro assistente de IA que suporte MCP ou conectores personalizados usando os mesmos detalhes de configuração:

1. No seu assistente de IA, localize a opção de adicionar um servidor MCP ou conector personalizado.
2. Forneça a URL do servidor MCP ou a configuração JSON do Document360, dependendo do que a plataforma exige.
3. Complete a autenticação OAuth ao redirecionar para o Document360: escolha o projeto necessário, selecione a caixa de seleção Eu entendo e confio nesta URL , e clique em Continuar.

Verifique a conexão

Para confirmar que seu assistente de IA pode acessar sua base de conhecimento:

1. Comece uma nova conversa no seu assistente de IA.
2. Digite um prompt pedindo para buscar ou pesquisar sua documentação. Por exemplo, peça para ele encontrar um artigo pelo título ou atualize uma seção dele e depois publique na sua base de conhecimento.
   Se a conexão for bem-sucedida, o assistente de IA retorna resultados obtidos da sua base de conhecimento do Document360. Para mais prompts que você pode tentar, consulte o artigo sobre casos de uso do MCP .

Se nenhum resultado for retornado ou aparecer um erro, verifique:

• O MCP está ativado no Document360.
• A configuração JSON ou a URL do servidor foi copiada corretamente.
• O conector está ativo no seu assistente de IA.
  Se o problema persistir, autentique novamente desconectando e reconectando o conector MCP, ou entre em contato com o suporte do Document360.