Boxkite
Exportar e fazer backup de dados do Xero
Documentação
1
Descubra
Seu agente encontra o Boxkite via llms.txt e nosso servidor MCP.
2
Conecte e pague
Seu agente faz login no Xero (somente leitura) e paga a taxa única no navegador.
3
Exportação do Boxkite
Empacotamos uma cópia completa somente leitura: um ZIP mais um manifesto legível por máquina.
4
Seu agente analisa
Ele lê o manifesto e trabalha com seus dados: fraudes, gastos excessivos, anomalias.
O que seu agente recebe
Um único arquivo ZIP mais um manifest.json descrevendo cada arquivo, para que seu agente saiba exatamente o que há dentro antes de começar.
·Contatos, Faturas de Clientes e Fornecedores, Transações Bancárias
·Lançamentos Manuais, Demonstrações Financeiras, Ordens de Compra, Cotações
·Alíquotas de Impostos, Categorias de Rastreamento, Pagamentos, Pagamentos em Lote
·Folha de pagamento: funcionários, execuções de pagamento, recibos de pagamento, quadros de horários (AU, NZ, UK)
·Projetos: projetos, tarefas, lançamentos de tempo
·Itens, Contas, Orçamentos, Ativos e arquivos enviados
Seguro por design
✓ Somente leitura. O Boxkite solicita escopos somente leitura do Xero, então a exportação nunca pode alterar, excluir ou criar nada em seus livros.
✓ Pagamento único. US$ 49 por organização, sem assinatura. Um único pagamento concluído no fluxo de exportação.
✓ Temporário. As exportações são criptografadas, ficam disponíveis por 7 dias e depois são excluídas automaticamente.
Conecte seu agente
O Boxkite executa um servidor MCP hospedado via Streamable HTTP, além das mesmas capacidades como API REST. O servidor MCP faz seu login com OAuth, então não há chave para copiar ou colar. Ambos são somente leitura em relação ao Xero.
1. Adicione o conector
No Claude, abra Configurações → Conectores → Adicionar conector personalizado e insira a URL do servidor. Deixe os campos avançados de OAuth em branco:
https://app.getboxkite.com/mcp
Nos planos Team e Enterprise, um Proprietário o adiciona em Configurações de administrador → Conectores; os membros então conectam a partir de suas próprias configurações.
2. Conecte sua conta
O Claude enviará você ao Boxkite para fazer login e aprovar o acesso. Revise o que o agente poderá fazer e escolha Permitir. Essa é toda a configuração.
Aprovar conecta sua própria conta Boxkite, então o agente vê apenas suas organizações. Você pode desconectar um aplicativo a qualquer momento em API keys, o que corta o acesso imediatamente.
3. Scripts e a API REST
Para seus próprios scripts, ou um cliente que não pode usar OAuth, crie uma chave em Configurações → API keys. Ela começa com bk_live_ e é mostrada uma única vez. Envie-a como um cabeçalho:
Authorization: Bearer bk_live_your_key_here
Inclua a palavra Bearer e o espaço. O valor é enviado exatamente como inserido, e uma chave nua é rejeitada. Se seu cliente não puder definir um cabeçalho de autorização, x-api-key com apenas a chave também funciona. O endpoint MCP aceita tanto uma chave de API quanto OAuth.
O que o servidor MCP expõe
| Ferramenta | O que faz |
|---|---|
| list_organisations | Lista as organizações Xero conectadas à sua conta Boxkite, com os ids que as outras ferramentas usam. |
| start_export | ESCRITA · Inicia uma exportação somente leitura de uma organização. US$ 49 por organização: quando o pagamento está pendente, a resposta traz uma URL de checkout do Stripe para concluir no navegador. Chamadas repetidas retornam a exportação existente em vez de cobrar novamente. |
| list_exports | Lista suas exportações, das mais recentes para as mais antigas, opcionalmente filtradas por uma organização. |
| get_export_status | Informa enfileirado / em execução / pronto / falhou, além de registros descobertos e transferidos, quando um limite de taxa do Xero é suspenso e quanto tempo até a mudança de status ser esperada. Exportações geralmente levam horas. |
| get_export_manifest | O que uma exportação em andamento contém: entidades, contagens por entidade e uma soma de verificação por arquivo. Paginado via fileOffset / fileLimit. |
| get_export_mapping | Qual objeto Xero cada arquivo representa ou está anexado, por exemplo, a fatura à qual um PDF de recibo pertence. Também paginado. |
| get_download_url | Uma URL assinada de curta duração para o ZIP da exportação, com seu tamanho em bytes e contagem de arquivos. Válida dentro da janela de retenção de 7 dias. |
Toda ferramenta exceto start_export é somente leitura. Quando uma exportação termina, o manifesto completo e o mapeamento viajam dentro do ZIP (em manifest.json e Info/), então as ferramentas de manifesto e mapeamento servem a estrutura ao vivo enquanto uma exportação está sendo construída e depois apontam para o arquivo. Para os equivalentes REST, use app.getboxkite.com/api/v1 com o mesmo cabeçalho Authorization: Bearer; baixe uma exportação de exemplo para ver a estrutura exata do arquivo.
Perguntas sobre acesso do agente
Não. O Boxkite só solicita acesso somente leitura ao Xero, então qualquer coisa construída sobre ele, incluindo agentes de IA, pode ler seus dados, mas nunca editar, excluir ou criar nada em seus livros.
Um único arquivo ZIP dos seus dados Xero (CSVs, arquivos e PDFs) mais um manifest.json na raiz que lista cada arquivo, seu tipo de entidade, contagem de registros, intervalo de datas e soma de verificação. O manifesto permite que um agente entenda o conteúdo e carregue os arquivos certos sem descompactar tudo primeiro. Baixe uma exportação de exemplo para ver a estrutura exata.
Uma exportação única custa US$ 49 por organização, sem assinatura. Seu agente conclui o checkout do Stripe no navegador como parte da execução da exportação.
Usos comuns: verificar pagamentos duplicados ou suspeita de fraude, encontrar onde você pode cortar gastos, verificações de conciliação, análise de fluxo de caixa e preparação de dados para auditorias ou uma migração para fora do Xero. Como é uma cópia completa, seu agente trabalha em tudo de uma vez em vez de percorrer a API do Xero página por página.
Sim. Uma API REST e um servidor MCP hospedado permitem que seu agente inicie uma exportação e busque o manifesto, o mapeamento e o link de download diretamente. Adicione app.getboxkite.com/mcp como um conector personalizado e faça login com OAuth; não há chave para colar. Para scripts e a API REST, crie uma chave de API em app.getboxkite.com/settings/api-keys (mostrada uma única vez) e envie-a como um cabeçalho Authorization: Bearer. Base REST: app.getboxkite.com/api/v1.