Como conectar outros agentes ou um agente próprio

O que preciso para conectar?

Uma conta com e-mail verificado e assinatura ativa Sync, Sync Bank ou Sync Bank Pro, ou teste válido. Sincronize o app antes de consultar dados recentes.

Adicionar a conexão

1. No agente, adicione um servidor MCP remoto ou uma conexão personalizada. Nome: Minhas Finanças. URL: https://mcp.minhasfinancas.app.br/mcp
2. Escolha OAuth com registro automático (DCR). Deixe Client ID e Client Secret sem preenchimento manual; não copie os IDs de outros agentes. Se solicitado, selecione Streamable HTTP.
3. Inicie a conexão e faça login na página do Minhas Finanças aberta pelo agente, mantendo o mesmo navegador.
4. Confira o endereço de retorno e as permissões. Se reconhecer o destino e confiar no responsável, clique em Autorizar conexão.
5. Volte ao agente e teste: ‘Mostre meus saldos por conta’. Confira o perfil consultado antes de pedir alterações.

Leitura, escrita e confirmação

Sem um pedido de escrita pelo agente, o acesso é somente leitura. Para cadastrar ou ajustar registros, ele precisa solicitar escrita e você deve autorizá-la. Uma conexão já concedida apenas para leitura precisa de nova autorização.

Nas integrações não verificadas, Criar registros e Ajustar transações, em Sem confirmação adicional, começam desligadas. Habilitá-las não libera ações não suportadas nem elimina confirmações obrigatórias. O agente pode exigir aprovação própria.

Para desconectar, abra Configurações > Mais > Conexões MCP e Agentes de IA no app e confirme Desconectar. Seus registros são preservados. Apagar uma conversa não revoga a conexão.

Se você configura ou desenvolve o agente

Use OAuth Authorization Code com PKCE S256, DCR e cliente público sem segredo (token_endpoint_auth_method=none). Isso não significa desligar o OAuth.

• Permissões: finances:read para consultar; finances:read finances:write para escrita, com consentimento do usuário.
• Retorno (callback): HTTPS público ou, em cliente local, HTTP em 127.0.0.1 ou [::1], com porta de 1024 a 65535. Mantenha o endereço idêntico no cadastro, na autorização e na conclusão do login, incluindo a porta.
• Não use localhost, IP privado de rede, curingas, parâmetros após ? ou fragmentos após # no retorno. Não reutilize callbacks reservados de outros provedores.

Se a conexão não funcionar

Se precisar de ajuda, envie ao suporte o nome do agente, a mensagem de erro e o horário. Não envie senhas, códigos de autorização ou tokens.

• ID ou segredo obrigatórios, sem DCR: peça a quem mantém o agente para adequar a conexão. Não existe um ID genérico nem um segredo compartilhado.
• Autorização expirada: reinicie a conexão pelo agente. Se houver limite de tentativas, aguarde o prazo informado.