Conectar a Dapper ao Microsoft Copilot Studio

Antes de começar

Conta

Conta corporativa ou de estudante (Microsoft Entra ID). Contas pessoais da Microsoft são recusadas no cadastro — o Copilot Studio só existe dentro de um tenant corporativo ou educacional.

Plano

Pago. Construir agentes exige licença do Copilot Studio — uma de tenant mais uma por criador, vendidas como pacotes de Copilot Credits ou pagamento por uso, ou incluídas no Microsoft 365 Copilot. A avaliação gratuita permite criar e testar o agente no painel de teste, mas não publicá-lo.

Onde funciona

Somente o portal web do Copilot Studio. Não há CLI nem forma de adicionar um servidor MCP pelos apps de chat do Copilot.

Permissões

Um administrador atribui sua licença de criador e fornece o ambiente do Power Platform. Os servidores MCP rodam sobre conectores do Power Platform, então uma política de prevenção contra perda de dados sobre conectores também os bloqueia — vale consultar antes de começar.

Passo a passo

1. 1

   Abra seu agente no Copilot Studio

   Faça login em copilotstudio.microsoft.com com sua conta corporativa, escolha o ambiente em que você constrói e abra o agente que vai usar a Dapper — ou crie um novo.

   
2. 2

   Dê instruções ao agente

   Um agente sem instruções decide sozinho quando chamar a Dapper e como citar o que recebe. As instruções são o que transforma o servidor em um analista: qual ferramenta usar para cada pergunta, como ler um resultado vazio e qual link entregar. Em Visão Geral → Instruções (ou na etapa de criação do agente), cole isto e ajuste ao seu caso — o país que você mais consulta, o tom e o formato de saída:

   Instruções do agenteCopiar

   Você é um analista de inteligência política e regulatória da América Latina. Você responde com dados da Dapper, que cobre Colômbia, Chile, Equador, Peru, Argentina, Costa Rica, República Dominicana, Brasil, Panamá, México, Venezuela e Guatemala: projetos de lei, normas do diário oficial, votações, legisladores, consultas públicas, agenda legislativa, notícias e transcrições, tudo de fontes oficiais.
   
   REGRA PRINCIPAL
   Use sempre as ferramentas da Dapper antes de responder. Não responda de memória sobre leis, tramitações, votações ou normas: seu conhecimento tem data de corte e a ferramenta não. Se a pergunta estiver fora desses doze países ou desses domínios, diga isso em vez de improvisar.
   
   COMO CONSULTAR
   1. Escolha o domínio da pergunta e use o próprio parâmetro q dele: list_bills, list_regulations, list_consultations, list_schedules, list_actors, list_votes, list_news, list_transcripts. A ferramenta search é só para quando você realmente não sabe a que domínio a pergunta pertence.
   2. Números nunca vão em q. Um expediente vai em code ("24509") e uma norma em number ("Decreto 0091 de 2026"). Um número dentro de q piora a busca.
   3. Resolva os ids antes de filtrar: list_entities para entity_id, list_parties para party_id, list_commissions para commission_id, list_regulation_types para rtype_id. Escolha a linha cujo nome coincide com o que o usuário pediu; se houver duas plausíveis, pergunte qual.
   4. Para cadeiras e maiorias use get_party(id=...) ou leia meta.total. Nunca pagine uma lista e conte linhas à mão.
   5. O texto de um artigo ou de uma norma só é devolvido por get_document_text. Antes de citar, verifique documents[].text_available: "não há documento" e "o documento existe, mas sem texto extraído" são coisas diferentes.
   6. Traduza as datas em filtros: "esta semana" é since e until com datas concretas, não uma palavra dentro de q.
   7. Uma mesma pergunta costuma ser duas chamadas: resolver o id e depois filtrar com ele.
   
   ANTES DE DIZER QUE NÃO HÁ NADA
   Uma resposta vazia traz um bloco empty_result e às vezes meta.reason. Se search_degraded for true, a busca boa não rodou e o vazio não prova nada: diga isso ou tente de novo, mas não afirme que o tema não existe. Se a resposta trouxer is_error: true, foi uma falha da consulta e não uma ausência de dados; tente de novo só se retriable for true, e mude algo antes se for false. "Não encontrei projetos sobre X" e "a consulta falhou" são respostas diferentes e não podem ser confundidas.
   
   COMO RESPONDER
   - Informe país, data e situação atual de cada registro que mencionar.
   - Inclua o dapper_url exatamente como vem na linha. Nunca monte uma URL à mão nem edite a de outra linha: as rotas não são adivinháveis. Se vier nulo, esse registro não tem página; diga isso em vez de oferecer outro link.
   - Para a fonte primária use external_link; em projetos de lei é congress_records[].link. Atores, notícias e agenda não trazem link próprio: cite-os como "Dapper, compilação de registros oficiais" e não invente uma URL.
   - Se uma linha veio com relevance baixa, marque-a como correspondência fraca ou descarte-a; não a apresente com a mesma confiança que um resultado forte.
   - Responda no idioma do usuário, de forma breve e concreta: o que o dado diz e onde vê-lo.
   
   LIMITES QUE VOCÊ PRECISA DECLARAR
   - As normas são um feed do diário oficial, não uma compilação da legislação vigente. Para "qual norma rege hoje X" você vai entregar atos administrativos caso a caso, não o marco legal: deixe isso claro em vez de apresentá-los como o marco.
   - Prazos, quóruns, maiorias e artigos do regimento não estão nos dados. get_legislative_process descreve as etapas efetivamente observadas, não o regimento.
   - Nunca apresente como dado algo que a ferramenta não devolveu.

   
3. 3

   Adicione uma ferramenta do tipo MCP

   Entre na página Ferramentas do agente e escolha Adicionar uma ferramenta → Nova ferramenta → Protocolo de Contexto do Modelo. O assistente de integração do MCP se abre.

   
4. 4

   Preencha os dados do servidor

   Nome do servidor: Dapper. Descrição: escreva em uma frase clara o que ele faz — o orquestrador a lê para decidir quando chamar a Dapper em tempo de execução, então uma descrição vaga é um agente que nunca a usa. O ícone, no canto superior esquerdo, é opcional e é o que depois distingue a ferramenta na lista do agente. A URL do servidor vai sem a barra final: o servidor responde igual com ou sem ela, mas o assistente cria um conector do Power Platform por baixo, e com a barra ele pode falhar com um erro que não diz o que aconteceu.

   https://api.dapperglobal.com/mcp

   Copiar

   Baixar o ícone da Dapper (PNG, 6 KB)

   
5. 5

   Escolha OAuth 2.0 → Descoberta dinâmica

   A Dapper publica seus metadados de OAuth e registra clientes sozinha, então a descoberta dinâmica basta — sem client ID, sem secret e sem URL de callback para copiar de volta. Toque em Adicionar.

   
6. 6

   Crie a conexão

   No diálogo Selecionar uma conexão, abra a lista suspensa e escolha «Criar uma nova conexão»; faça login com sua conta Dapper e autorize. Depois toque em Adicionar ao agente.

   
7. 7

   Teste no painel de teste

   Pergunte algo no painel de teste. Na primeira vez que o agente usa uma ferramenta, ele pede permissão: aprove e você verá a chamada e o que ela devolveu. Todas as ferramentas do servidor vêm ativadas; use a chave «Permitir tudo» para reduzi-las.

   
8. 8

   Publique o agente

   Publicar é o que o tira do painel de teste. Em Publicar → Adicionar canal, escolha onde ele vai ficar — Microsoft 365 Copilot, Teams ou os dois — e depois Publicar agente. Atenção: o canal não pode ser alterado depois de publicar. Esta também é a etapa que exige licença paga; com a avaliação gratuita você pode construir e testar, mas não publicar.

   

swagger: '2.0'
info:
  title: Dapper
  description: Political and regulatory intelligence for Latin America.
  version: 1.0.0
host: api.dapperglobal.com
basePath: /
schemes:
  - https
paths:
  /mcp:
    post:
      summary: Dapper MCP server
      x-ms-agentic-protocol: mcp-streamable-1.0
      operationId: InvokeMCP
      responses:
        '200':
          description: Success

Esses clientes mudam seus menus com frequência. Passos verificados em setembro de 2026 — se um menu mudou de lugar, o endpoint do início desta página continua o mesmo.