> For the complete documentation index, see [llms.txt](https://developers.bluefleet.com.br/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.bluefleet.com.br/home/blue-link-conexao-com-ia-mcp/copilot-studio.md).

# Integração com o Microsoft Copilot Studio

Conecte o Blue Link ao Microsoft Copilot Studio usando o Login Blue e registro OAuth automático.

Conecte o Blue Link ao seu agente no Microsoft Copilot Studio para consultar dados da locadora usando suas permissões do Blue Fleet. A conexão usa o Login Blue: você entra com sua conta e autoriza o acesso, sem cadastrar chaves ou segredos manualmente.

## Antes de começar

Você precisa de acesso ao Copilot Studio com permissão para adicionar ferramentas no ambiente escolhido, de uma conta ativa no Blue Fleet e do Blue Link habilitado para sua locadora. Seu usuário também precisa da permissão de uso do Blue Link e das permissões dos dados que deseja consultar.

O administrador do ambiente Microsoft pode restringir conectores externos. Se a ferramenta estiver bloqueada por uma política da organização, solicite a liberação ao administrador.

## 1. Adicione o servidor MCP

1. Abra o agente no Copilot Studio e acesse **Ferramentas / Tools**.
2. Selecione **Adicionar ferramenta / Add a tool**, depois **Nova ferramenta / New tool** e **Model Context Protocol (MCP)**.
3. Informe o nome **Blue Link** e a URL do servidor:

   ```
   https://mcp.bluefleet.com.br/mcp
   ```
4. Em autenticação, selecione **OAuth 2.0** e **Dynamic discovery** (descoberta dinâmica).
5. Se a tela solicitar escopos, informe `ai:read offline_access`.
6. Crie a ferramenta e prossiga para criar a conexão.

A URL termina em **`/mcp`**. A descoberta dinâmica identifica o Login Blue e registra a conexão automaticamente. Não é necessário preencher client ID, client secret, callback ou código da locadora. Se esses campos forem obrigatórios, confira se a opção selecionada é **Dynamic discovery**, em vez de configuração manual.

Os nomes e a posição das opções podem variar conforme o idioma e a versão do Copilot Studio. Consulte também o [guia oficial da Microsoft](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent).

## 2. Entre no Blue Fleet e autorize

1. Selecione a opção de criar ou entrar na conexão.
2. Na janela aberta, confira se o endereço é **`login.bluefleet.com.br`**.
3. Entre com seu usuário Blue Fleet e conclua a autenticação solicitada pela sua organização.
4. Na tela **Autorizar acesso ao Blue Link**, confira o usuário, a locadora e o endereço de retorno do conector Microsoft.
5. Clique em **Autorizar conexão** e aguarde o retorno ao Copilot Studio.
6. Conclua a inclusão da ferramenta no agente.

A locadora é identificada pelo usuário que entrou no Blue Fleet. Autorize somente conexões que você iniciou. Se a locadora exibida não for a esperada, cancele e entre com a conta correta.

## 3. Configure as credenciais dos usuários

Na configuração de autenticação da ferramenta, utilize **Credenciais do usuário final / End user credentials**. Assim, cada pessoa entra com sua própria conta Blue Fleet e consulta os dados permitidos para ela. Usar credenciais do criador faz as chamadas com a identidade do criador da conexão.

A autenticação de acesso ao agente Microsoft e a conexão com o Blue Fleet são configurações distintas. Consulte [as opções de autenticação das ferramentas](https://learn.microsoft.com/en-us/microsoft-copilot-studio/add-tools-custom-agent).

## 4. Teste antes de compartilhar

No painel de teste do agente, peça:

> Consulte meu contexto no Blue Link e informe a locadora conectada.

O agente deve utilizar `consultar_contexto`. Confira a locadora retornada. Depois, solicite uma consulta para a qual seu usuário tenha permissão, por exemplo:

> Consulte os veículos da minha locadora no Blue Link.

Antes de disponibilizar o agente, teste também com outro usuário para confirmar que ele utiliza sua própria conexão e permissões.

## Renovar ou trocar a conexão

O acesso pode ser renovado automaticamente por até 30 dias. Depois desse prazo, ou se a sessão for revogada, conecte novamente. A renovação depende de usuário, licença e permissões válidos.

Para trocar de conta ou locadora, crie uma nova conexão autenticada com o usuário correto e selecione-a na ferramenta. Se você tinha uma conexão configurada manualmente, recrie-a usando **Dynamic discovery**.

## Se a conexão não funcionar

| Situação                                       | O que verificar                                                                                                                                                                                      |
| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A ferramenta pede client ID e segredo          | Selecione OAuth 2.0 com Dynamic discovery. Não informe sua senha nesses campos.                                                                                                                      |
| Servidor não encontrado                        | Confira a URL completa, com `/mcp`, e as políticas de conectores do ambiente Microsoft.                                                                                                              |
| Descoberta ou registro automático indisponível | Solicite ao suporte Blue a confirmação de que a versão do Login com registro automático foi publicada.                                                                                               |
| Erro `invalid_redirect_uri`                    | Envie ao suporte a URL de retorno exibida. O fluxo atende os callbacks comerciais do Microsoft Power Platform em `global.consent.azure-apim.net`; nuvens soberanas precisam de avaliação específica. |
| Erro de PKCE                                   | A conexão precisa usar PKCE com S256. Confirme que está usando o fluxo MCP OAuth com descoberta dinâmica e envie o erro ao suporte.                                                                  |
| Erro 429 durante a criação                     | O limite temporário de registros foi atingido. Aguarde e tente novamente mais tarde.                                                                                                                 |
| Usuário sem autorização                        | Confira usuário ativo, locadora, licença Blue Link e permissão de uso com o administrador Blue Fleet.                                                                                                |
| Uma consulta é negada                          | Confira a permissão do usuário para os dados solicitados. A conexão não amplia suas permissões.                                                                                                      |
| Tela de confirmação expirou                    | Reinicie a conexão a partir do Copilot Studio.                                                                                                                                                       |

Ao acionar o suporte, informe a etapa, a mensagem de erro, o horário e o ambiente Microsoft. Não envie senhas, tokens ou client secrets.
