Conecte o MCP usando um conector personalizado

O servidor MCP do Document360 pode ser conectado a assistentes de IA usando URL do servidor MCP ou um arquivo de configuração JSON. Os leitores podem se conectar ao Claude de forma suportada e acessar o conteúdo do artigo por meio do arquivo de configuração.

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

Use a URL do servidor MCP quando sua plataforma de IA aceitar uma URL direta para a configuração do conector (por exemplo, Claude AI e Copilot). Use a configuração JSON quando sua plataforma de IA exigir um arquivo de configuração estruturado (por exemplo, IDE do Cursor).

Antes de começar

Antes de configurar o MCP, certifique-se do seguinte:

• Você tem um cargo de Proprietário do Projeto ou Administrador . Somente esses papéis podem ativar ou desativar o MCP para um projeto.
• Você tem acesso a um assistente de IA suportado: ChatGPT, Claude AI, Cursor IDE, Copilot ou qualquer plataforma que suporte MCP ou conectores personalizados.

Ativar o MCP

Para viabilizar o MCP,

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

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

3. Clique em Ativar MCP.

   Uma mensagem de confirmação aparece perguntando se você quer permitir que assistentes externos de IA acessem sua base de conhecimento. Apenas os Proprietários e Administradores do Projeto podem ativar ou desativar o MCP para um projeto.

4. Clique em Permitir Acesso para prosseguir.

Uma vez ativada, a configuração MCP fica disponível em Conectores Personalizados.

NOTA

Ativar o MCP permite acesso estruturado à sua base de conhecimento. O acesso ao conteúdo continua seguindo a versão existente do seu projeto, idioma e configurações de visibilidade.

Obtenha a configuração JSON

Após ativar o MCP,

1. Em Conectores Personalizados, clique em Obter detalhes.

   

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

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

Conecte o MCP ao seu assistente de IA

Após ativar o MCP no Document360, você pode conectar sua base de conhecimento a um assistente de IA usando a configuração JSON do MCP fornecida. Dependendo da plataforma de IA, talvez você precise usar a URL do servidor MCP ou a configuração JSON. Os passos de configuração variam um pouco entre as plataformas.

As seções a seguir descrevem o processo de conexão para assistentes de IA comumente usados, como ChatGPT, Claude e Copilot.

ChatGPT

Para conectar MCP no ChatGPT:

1. Abra o ChatGPT.
2. Vá em Configurações.
3. Navegue até Apps > Configurações avançadas.
4. Ative o modo Desenvolvedor.
5. Clique em Criar app.

Forneça os seguintes detalhes:

1. Nome - Insira uma etiqueta para a conexão (por exemplo, Document360 MCP).
2. Descrição - (Opcional) Adicione uma descrição para referência.
3. URL do servidor MCP - Cole a URL do servidor MCP fornecida no Document360.
4. Método de autenticação - Selecione OAuth.
5. Clique em Configurações avançadas.
6. No painel lateral que aparece, role até o final.
7. Desmarque a opção ativada pelo OIDC .
8. Selecione a caixa de confirmação (entendi...).
9. Clique em Criar.

Após criar o app, você será redirecionado para o Document360. Revise a solicitação de conexão e escolha o projeto necessário.

1. Selecione a caixa de confirmação (eu entendo e confio nessa URL).
2. Clique em continuar. Você será redirecionado para o ChatGPT.

Para começar a usar o conector MCP no ChatGPT:

• Na caixa de mensagens do ChatGPT, digite / para abrir uma lista de opções disponíveis.
• Desça para localizar os conectores adicionados, então selecione o conector Document360 clicando no nome fornecido.

O ChatGPT agora pode interagir com sua base de conhecimento usando as capacidades MCP habilitadas no seu projeto.

Claude AI

Para conectar MCP no Claude AI:

1. Abra Claude AI.

2. Clique no seu perfil e navegue até Configurações.

   

3. Vá para Conectores.

4. Clique em Adicionar.

5. Escolha Personalizado entre as opções disponíveis.

6. Selecione Web ou Desktop conforme sua necessidade.

Se sua organização permitir adicionar conectores personalizados, você pode prosseguir com a configuração.

Se não, talvez seja necessário entrar em contato com o administrador da organização para habilitar ou conceder permissão para adicionar conectores personalizados.

Forneça os detalhes exigidos:

1. Nome - Insira um rótulo (por exemplo, Document360 MCP).
2. Configuração - Cole a URL do servidor MCP a partir da configuração MCP fornecida no Document360.
3. Clique em Adicionar.
4. Navegue até Configurações Pessoais e localize o conector personalizado com o nome que você forneceu.
5. Clique em Conectar para estabelecer a conexão MCP.

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. A Claude AI pode interagir com sua base de conhecimento usando as capacidades MCP habilitadas no seu projeto.

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. Retorne às Configurações do Cursor 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.

NOTA

O suporte ao MCP pode variar dependendo do assistente de IA ou cliente utilizado (como assistentes baseados em IDE ou ferramentas experimentais). Algumas plataformas podem ter suporte limitado ou em evolução para capacidades MCP. Os campos e a interface disponíveis podem variar ligeiramente dependendo da plataforma de IA. Consulte a documentação do seu assistente de IA para detalhes de compatibilidade.

Após a conexão

Após uma conexão bem-sucedida, você pode usar recursos suportados pelo MCP através do seu assistente de IA, incluindo:

• Pesquisando documentação entre versões e linguagens do projeto
• Recuperando o conteúdo completo do artigo por ID ou URL
• Criação de novos artigos e categorias (se as permissões de escrita estiverem configuradas)
• Atualizando artigos existentes preservando a estrutura e a formatação

Todas as interações respeitam sua configuração existente, incluindo versões do projeto, linguagens e regras de visibilidade. Para uma explicação detalhada das capacidades MCP disponíveis e como elas funcionam no Document360, consulte o artigo Ferramentas MCP Suportadas .

Verifique a conexão MCP

Depois de configurar o MCP no seu assistente de IA, você pode verificar a conexão.

1. Abra seu assistente de IA.
2. Comece uma nova conversa.
3. Faça uma consulta relacionada à sua documentação.

Por exemplo:

• Peça detalhes sobre uma característica específica.
• Pesquise e recupere conteúdo de uma versão ou linguagem específica do projeto.
• Peça para ele escrever um artigo em qualquer categoria específica no Document360.

Se a conexão for bem-sucedida, o assistente de IA retornará os resultados obtidos da sua base de conhecimento Document360.
Se nenhum resultado for retornado ou aparecer um erro, verifique:

• O MCP está ativado no Document360.
• A configuração JSON 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.

NOTA

O assistente de IA só pode acessar conteúdos permitidos pela versão, idioma e configurações de visibilidade do seu projeto.

Desative o MCP

Para desativar o MCP:

1. Navegue até Configurações () na barra de navegação da esquerda.
2. Vá para Configurações de IA > MCP.
3. Clique em Desativar MCP.
4. Confirme a ação no diálogo que aparece.

Uma vez desativadas, todas as conexões MCP ativas param de funcionar e quaisquer sessões existentes são encerradas. Tokens de acesso também são revogados. Se você reativar o MCP, os assistentes de IA conectados precisarão se reconectar.

FAQ