Prepare a conexão e o teste

Confira o caminho disponível e prepare uma consulta de documentos sintéticos com resultado verificável.

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.

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

    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.

    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.

    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.

    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.

    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

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.