# Prepare a conexão e o teste Confira o caminho disponível e prepare uma consulta de documentos sintéticos com resultado verificável. Fonte: https://guides.adapta.org/guias/maestro/recursos-do-maestro/conectores/configurar-testar/ **TL;DR** · Consulte o catálogo, confirme as permissões e prepare uma amostra antes de conectar. O formulário por URL fica vazio até você preenchê-lo. Autenticação e execução permanecem pendentes; o roteiro abaixo não declara conexão concluída. ![Gravação do Maestro: a página Conectores é filtrada pela busca, o catálogo mostra os serviços disponíveis com o botão Conectar, e Adicionar via URL abre o formulário com Nome, Tipo, URL, Headers e Token, com Conectar desabilitado; Cancelar fecha sem criar conexão.](https://guides.adapta.org/media/screenshots/maestro/conectores-configurar-2026-09-19/maestro-conectores-url.lossless.webp) *Consultar o catálogo e abrir o formulário não conecta nada: o botão Conectar só acende com os campos obrigatórios preenchidos.* ## Antes de começar Tenha autorização do responsável pelo serviço e confira [as permissões necessárias](https://guides.adapta.org/guias/maestro/recursos-do-maestro/conectores/permissoes/). Use somente documentos fictícios no primeiro teste. Não aproveite dados reais de uma conexão já existente apenas porque ela aparece como conectada. 1. **Confira o caminho disponível** Abra **Conectores** na lateral e mantenha a aba **Conectores**, ao lado de **Integrações**. A página separa o que já está ligado, em **CONECTADOS**, do catálogo em **DISPONÍVEIS**. Use a busca para chegar ao serviço em vez de rolar o catálogo inteiro. Localize o serviço e confira seu estado. **Conectar**, **Conectar com token/API key** e **Adicionar via URL** são entradas diferentes; escolha somente o fluxo validado para o serviço que pretende usar. Não há um passo universal de consentimento que possa ser reproduzido para todos os serviços: escolha o fluxo correspondente ao serviço antes de prosseguir. ![Página Conectores do Maestro com as abas Conectores e Integrações, a busca filtrando o catálogo e o botão Adicionar via URL, sobre a lista de serviços disponíveis com botão Conectar.](https://guides.adapta.org/media/screenshots/maestro/conectores-configurar-2026-09-19/conectores-catalogo-2026-09-19.png) *Na página: **1** as duas abas, **2** a busca que filtra o catálogo, **3** Adicionar via URL, um caminho diferente de Conectar, e **4** os serviços disponíveis, cada um com a forma de autorização escrita no cartão.* 2. **Revise os dados antes de uma conexão por URL** **Adicionar via URL** abre um formulário com **Nome**, **Tipo** (inicialmente `http`), **URL**, **Headers (opcional)** e **Token (opcional, vira Authorization: Bearer)**. Os campos nascem com exemplos cinzentos, não com valores: `meu-conector`, `https://exemplo.com/mcp` e `Chave: valor (um por linha)` são placeholders. **Conectar** fica desabilitado enquanto os campos obrigatórios estiverem vazios, e **Cancelar** fecha o formulário sem criar conexão. O autopreenchimento do navegador pode completar URL ou Token sozinho: confira e limpe os campos antes de clicar em Conectar, mesmo que o formulário pareça "vazio" à primeira vista. Veja mais em [Confira as permissões](https://guides.adapta.org/guias/maestro/recursos-do-maestro/conectores/permissoes/). As validações exigidas pelo servidor e os outros tipos oferecidos pelo seletor podem variar por serviço. Se sua operação exigir esse caminho, confirme previamente o endereço oficial e a forma de autenticação com o responsável. Não invente endpoints nem use um token de outro serviço. A conexão efetiva deve ser validada em uma etapa autorizada própria. ![Formulário Adicionar via URL com Nome, Tipo http, URL, Headers opcionais, Token opcional e o botão Conectar desabilitado.](https://guides.adapta.org/media/screenshots/maestro/conectores-configurar-2026-09-19/conectores-form-2026-09-19.png) *No formulário: **1** Nome e Tipo, com exemplos cinzentos no lugar de valores, **2** o Token, que vira um cabeçalho Authorization, e **3** Conectar, desabilitado enquanto faltar campo obrigatório.* 3. **Prepare dois documentos sintéticos** O exemplo abaixo não foi criado em um serviço externo nem consultado pelo Maestro. Ele define a amostra para um teste futuro de leitura. O conector escolhido precisa permitir consultar os documentos delimitados; se não permitir, interrompa e registre a limitação. ```` DOCUMENTO A · Plano da semana · versão aprovada 09/09/2026 Cliente fictício;entrega;prazo;horas necessárias Aurora;revisão de proposta;11/09/2026;4 Horizonte;oficina;12/09/2026;6 Capacidade disponível aprovada: 8 horas. DOCUMENTO B · Acompanhamento · versão 09/09/2026 Aurora: dados completos; aguarda revisão. Horizonte: lista de participantes ainda não recebida. Nenhuma prioridade entre os dois trabalhos foi aprovada. ```` Prepare este pedido para a futura consulta autorizada: ```` Consulte somente os documentos sintéticos A e B indicados. Não pesquise outras pastas, contas, e-mails ou registros. Prepare uma pauta de reunião com carga, capacidade, pendências e decisões necessárias. Cite documento e versão para cada fato. Separe cálculo de hipótese. Não invente prioridade, responsável ou prazo novo. Se não conseguir ler uma fonte, informe qual faltou. Não complete seu conteúdo com suposições. Não altere documentos, envie mensagens, crie eventos ou conecte/instale recursos. Entregue somente na conversa. ```` ![Compositor do Maestro com os dois documentos sintéticos digitados: o plano da semana com entregas, prazos e horas, e a nota com a pendência de participantes.](https://guides.adapta.org/media/screenshots/maestro/passos-2026-09-22/cc-docs-2026-09-22.png) *A amostra que o conector vai ler: **1** o documento A com carga e capacidade e **2** o documento B com a pendência. Números pequenos, gabarito fácil de conferir.* 4. **Compare o resultado com o gabarito** O gabarito é **10 horas necessárias**, **8 disponíveis** e **déficit de 2 horas**. A lista de participantes de Horizonte permanece pendente. Sem prioridade aprovada, a resposta deve apresentar uma decisão a tomar, não escolher silenciosamente qual cliente atrasar. Fatos de carga vêm do documento A; a pendência vem do B. Se B não puder ser lido, a resposta deve declarar essa ausência. Confirme também que os documentos não foram modificados e que nenhum envio ocorreu antes de considerar essa consulta validada. O gabarito acima serve para conferir uma execução autorizada com esta amostra. ![Compositor do Maestro com o checklist de conferência digitado: 10 horas necessárias, 8 disponíveis, déficit de 2, pendência de Horizonte, decisão a tomar e confirmação de que nada foi modificado nem enviado.](https://guides.adapta.org/media/screenshots/maestro/passos-2026-09-22/cc-compare-2026-09-22.png) *O gabarito escrito antes: **1** os três números e a pendência e **2** as perguntas sobre decisão, leitura de B e efeitos colaterais. A resposta é conferida contra isso.* ## O catálogo e o formulário **Dica prática:** deixe o formato e o critério de conferência explícitos. Como Criar Assistentes de IA, aula 4, separa insumos e template da saída. Aqui, documento, versão e fórmula permitem conferir a pauta sem presumir que o conector leu tudo. ## Se faltar acesso Não amplie permissões ou reautorize automaticamente. Registre qual fonte e ação falharam, sem copiar credenciais para o diagnóstico, e peça a revisão do responsável. Uma mensagem de erro deve ser verificada antes de atribuí-la ao serviço, ao documento ou à conta. Explore outras rotinas nos [casos de uso do Maestro](https://guides.adapta.org/guias/casos-de-uso/por-plataforma/maestro/).