---
title: "Integração com Microsoft Copilot"
canonical: "https://centraldeajuda.projuris.com.br/space/PE/1014595588/Integra%C3%A7%C3%A3o%20com%20Microsoft%20Copilot"
format: markdown
---
### **Contexto**
A integração com Microsoft Copilot está disponível no Hub de Integrações e permite conectar o Projuris Empresas ao Microsoft Copilot Studio e ao Microsoft 365 Copilot por meio do protocolo MCP (Model Context Protocol).
Com essa integração, o administrador do ambiente Microsoft da empresa configura um agente no Copilot Studio e o publica no Microsoft 365 Copilot. A partir daí, os usuários autorizados conseguem consultar processos, contratos, requisições e informações cadastrais do Projuris diretamente no assistente corporativo, sem precisar alternar entre ferramentas.
> ⚠️ A integração com o Copilot no Projuris **será disponibilizada gratuitamente,** sem constituição de vínculo contratual ("Beta Teste"). A participação no Beta Teste não gera direito adquirido nem obrigação de fornecimento futuro do serviço.
### **Objetivo**
Permitir que os usuários autorizados consultem e, em algumas funcionalidades, atualizem dados do Projuris Empresas diretamente no Microsoft 365 Copilot, reduzindo a troca de contexto entre sistemas.
> ℹ️ ### **Pré-requisitos para usar a integração**
> ℹ️
> ℹ️ Para usar a integração, a empresa precisa ter **licenças corporativas** do Microsoft 365 Copilot e do Microsoft Copilot Studio que permitam criar e publicar agentes com ferramentas personalizadas. O Projuris fornece o conector e orienta a configuração na plataforma. Garantir conta, licença e permissões junto ao Copilot é responsabilidade do cliente.
> ℹ️
> ℹ️ Confirme esse pré-requisito antes de solicitar a ativação para alinhar expectativas e evitar bloqueios na configuração.
> ℹ️
> ℹ️ ### **Segurança e permissões**
> ℹ️
> ℹ️ Ao conectar o Projuris a uma ferramenta externa, os dados consultados também são tratados segundo as políticas dessa ferramenta.
> ℹ️
> ℹ️ O acesso aos dados do Projuris respeita as permissões de cada usuário na plataforma, e o agente não age em nome de outro usuário. Ações de escrita, quando disponíveis, exigem confirmação explícita do usuário no Copilot antes de serem executadas.
### **Como funciona a integração**
A integração com Microsoft Copilot permite que você acesse funcionalidades específicas de cada módulo do Projuris:
#### **Processos**
| **Funcionalidade** | **O que você consegue fazer** |
| --- | --- |
| **Próximos eventos do processo** | Consulte os próximos eventos do processo dentro de um período (padrão: 7 dias). |
| **Últimos andamentos do processo** | Acompanhe os últimos andamentos do processo em um período (padrão: 7 dias). |
| **Tempo de tramitação** | Verifique o tempo de tramitação do processo em um intervalo de dados (padrão: últimos 30 dias). |
| **Processos novos e encerrados** | Obtenha a quantidade de processos novos e encerrados dentro de um período (padrão: últimos 30 dias). |
| **Pré-cadastro de processo** | Crie um pré-cadastro de processo informando cliente, adverso, condições, natureza, procedimento, tipo de ação, tipo de processo e unidade organizacional. |
#### **Contratos e Requisições**
| **Funcionalidade** | **O que você consegue fazer** |
| --- | --- |
| **Buscar contratos** | Encontre contratos com filtros avançados. Busque por fornecedor, status, valor, data de vencimento, cliente, tipo de contrato, entre outros. Suporta paginação e ordenação. |
| **Buscar requisições** | Acesse requisições em andamento e filtre por solicitante ou fase. Suporta joins para carregar campos específicos de subtipos como contrato, aditivo, encerramento, procuração, renovação e processo. Inclui paginação e ordenação. |
| **Gerenciar fases de requisição** | Crie novas fases ou consulte fases existentes. Configure assinatura (Projuris Bry ou DocuSign), defina obrigatoriedade de anexo e configure funcionalidades específicas. |
| **Consultar métricas de SLA** | Consulte métricas e dados de Nível de Serviço (SLA) para uma lista de requisições, passando os IDs desejados. |
#### **Cadastros**
| **Funcionalidade** | **O que você consegue fazer** |
| --- | --- |
| **Entidades (pessoa física ou jurídica)** | Crie uma nova entidade na plataforma informando apenas nome e CPF ou CNPJ. O tipo é detectado automaticamente. |
| **Societário (empresa, filial ou consórcio)** | Crie um novo societário (empresa, filial ou consórcio) com dados como razão social, regime (ações ou cotas), data de constituição e unidade organizacional. |
### **Como acessar a integração**
Acesse o caminho **Painel de Controle > Integrações.** Localize o card do **Microsoft Copilot** e clique para acessar a página de detalhes da integração.
### **Conectar o Microsoft Copilot**
Na página de detalhes da integração, clique em **Conectar**.
Ao clicar em **Conectar**, é exibida a tela de **Termos e condições**, com as regras de uso do conector selecionado no Hub de Integrações. Para prosseguir com a ativação, revise o conteúdo apresentado, ative o **Li e aceito o Termo de Aceite do Hub de Integrações** e clique em **Aceitar e continuar.**
> ℹ️ O aceite dos Termos e condições é obrigatório para ativar qualquer conector do Hub de Integrações e complementa, sem substituir, o contrato principal firmado entre sua empresa e a Projuris.
Após concordar, são exibidos os dados de configuração do Projuris para o Microsoft Copilot:
- **Endpoint MCP:** exibe a URL do servidor MCP do Projuris (`https://mcp-v2.projuris.com.br/mcp`) que deve ser informada na configuração do agente no Copilot Studio. O ícone à direita do campo permite copiar o endereço com um clique;
- **Método de autenticação:** indica o protocolo usado para validar o acesso. A integração utiliza **OAuth 2.0**, e o login é realizado com as credenciais da própria organização.
Com os dados de conexão em mãos, o administrador acessa o **Microsoft Copilot Studio** para configurar o agente. Em seguida, faça login na sua conta Microsoft, revise a tela de **Permissões solicitadas** e clique em **Aceitar**.
#### **Criar o agente e adicionar a ferramenta MCP**
Acesse o Copilot Studio através do link: [https://copilotstudio.microsoft.com/](https://copilotstudio.microsoft.com/)
No menu lateral esquerdo, clique em **Agentes **e selecione **Novo Agente. **A orquestração generativa precisa estar habilitada; essa opção já vem ativa por padrão em agentes novos.
No agente, acesse **Ferramentas**, clique em **Adicionar Ferramenta**, depois em **Adicionar** e selecione **MCP (Protocolo do Contexto Modelo)**.
Preencha os dados do servidor:
- **Nome do servidor:** Projuris Empresas;
- **Descrição do Servidor:** uma frase descrevendo o que o MCP do Projuris faz (esse texto é usado pelo orquestrador do Copilot para decidir quando chamar a ferramenta);
- **URL do servidor:** `https://mcp-v2.projuris.com.br/mcp`, o mesmo Endpoint MCP exibido no Projuris.
- **Autenticação:** selecione **OAuth 2.0**
- **Tipo de configuração:** Manual.
- **ID do Cliente:** projuris-mcp-copilot;
- **Segredo do Cliente:** o campo é obrigatório no Copilot Studio, mas o conteúdo não é validado pelo Projuris; **preencha com qualquer valor;**
- **URL de autorização:** `https://empresas-gateway.projuris.com.br/auth-v2/realms/starian/protocol/openid-connect/auth`;
- **URL do token:** `https://empresas-gateway.projuris.com.br/auth-v2/realms/starian/protocol/openid-connect/token`;
- **Atualizar URL token:** `https://empresas-gateway.projuris.com.br/auth-v2/realms/starian/protocol/openid-connect/token`;
- **Escopos:** openid.
Clique em **Adicionar**. O Copilot Studio exibe uma *callback URL*; ela deve começar com `https://global.consent.azure-apim.net/redirect/`. Clique em **Avançar**, depois em **Create a new connection** e faça **login **com um **usuário do Projuris Empresas. **Clique em **Adicionar** para concluir a conexão.
No canto superior direito clique em **Publicar** para disponibilizar o Agente para toda sua organização.
> ⚠️ Para disponibilizá-lo no Microsoft 365 Copilot ou no Teams e liberá-lo para a organização, é necessário publicar o agente, o que exige licença paga do Copilot Studio; os usuários finais também precisam de licença do Microsoft 365 Copilot.
### **Publicar e liberar o agente para os usuários**
Depois de validar a ferramenta, o administrador publica o agente no Copilot Studio, adiciona o canal Microsoft 365 Copilot e compartilha o agente com os usuários autorizados da organização. Dependendo das políticas internas, pode ser necessário submeter o agente para aprovação administrativa da Microsoft antes da liberação.
Depois de publicado e compartilhado, os usuários autorizados conseguem acionar o agente diretamente no Microsoft 365 Copilot para consultar dados do Projuris. O acesso de cada usuário respeita as permissões já configuradas para ele na plataforma, e ações de escrita, quando disponibilizadas pela ferramenta, exigem confirmação explícita do usuário dentro do próprio Copilot antes de serem executadas no Projuris.
> ℹ️ #### **Informações importantes**
> ℹ️
> ℹ️ - a configuração da integração é feita pelo administrador do tenant Microsoft, e não individualmente por cada usuário;
> ℹ️ - o acesso aos dados depende das permissões de cada usuário no Projuris Empresas;
> ℹ️ - a conexão permanece ativa enquanto o conector estiver habilitado no Hub de Integrações;
> ℹ️ - o fornecimento de licenças do Microsoft 365 Copilot e do Copilot Studio não é de responsabilidade da Projuris.
### **Perguntas frequentes**
Quais os requisitos para conectar o Projuris ao Microsoft Copilot?
É necessário que a empresa tenha licenças do Microsoft 365 Copilot e do Microsoft Copilot Studio que permitam adicionar ferramentas personalizadas a um agente e publicá-lo para a organização, além de uma conta corporativa ou de instituição de ensino (Microsoft Entra). A configuração é feita pelo administrador do tenant Microsoft.
Posso usar uma conta de e-mail pessoal para configurar ou testar a integração?
Não. O Microsoft 365 Copilot e o Copilot Studio exigem uma conta corporativa. Contas pessoais, como as de Outlook.com ou Gmail, não são aceitas pela Microsoft.
Quem configura essa integração?
A configuração é feita pelo administrador do ambiente Microsoft da empresa, tanto no Projuris (Hub de Integrações) quanto no Copilot Studio. Os demais usuários apenas utilizam o agente já publicado no Microsoft 365 Copilot, conforme as permissões liberadas pela organização.
Quais dados são usados na configuração do agente?
No Copilot Studio, informe o Endpoint MCP exibido no Projuris (`https://mcp-v2.projuris.com.br/mcp`) como Server URL e configure a autenticação como OAuth 2.0 (tipo Manual), com o Client ID `projuris-mcp-copilot` e os demais campos detalhados na seção **Configurar o agente no Microsoft Copilot Studio** deste artigo.
O card do Microsoft Copilot não aparece no Hub de Integrações. O que fazer?
Verifique o Hub de Integrações com um usuário que tenha perfil de super usuário. As integrações de inteligência artificial estão sendo liberadas de forma gradual.
A conexão retorna erro 503. O que isso significa?
Trata-se de uma instabilidade temporária do serviço. Aguarde alguns minutos e tente novamente; se o erro persistir, abra um chamado na Central de Ajuda com um print da mensagem exibida.
A conexão com o Projuris tem algum custo?
A definição comercial sobre eventual cobrança por essa integração ainda está em avaliação. Consulte seu representante Projuris Empresas para informações atualizadas.