Xero

Interaja com a API do software de contabilidade Xero.

GitHub
21
Experimente este MCPPatrocinado

Documentação

Servidor MCP Xero

smithery badge

Este servidor MCP permite que Clientes interajam com o Software de Contabilidade Xero.

Começando

  1. Certifique-se de que o node esteja instalado.

  2. Crie um aplicativo OAuth 2.0 no Xero para obter um CLIENT_ID e CLIENT_SECRET.

    • Crie uma conta de usuário gratuita no Xero (se você não tiver uma)

    • Faça login no centro de desenvolvedores do Xero https://developer.xero.com/app/manage/

    • Clique em Novo aplicativo

    • Digite um nome para o seu aplicativo

    • Selecione Aplicativo web

    • Forneça uma URL válida (pode ser qualquer coisa válida, ex.: https://www.myapp.com)

    • Digite o URI de redirecionamento: http://localhost:5000/callback

      Nota: O URI de redirecionamento pode ser personalizado, mas deve usar localhost e incluir tanto uma porta explícita quanto um caminho (ex.: http://localhost:5050/my-path). Defina o mesmo valor que XERO_REDIRECT_URI na configuração do seu cliente MCP abaixo.

    • Marque para Aceitar os Termos e Condições e clique em Criar aplicativo

    • No lado esquerdo da tela, selecione Configuração

    • Clique em Gerar um segredo

  3. Configure seu cliente MCP:

    Claude Desktop

    Vá para Configurações -> Desenvolvedores -> Servidores MCP Locais -> Editar Configuração e adicione o seguinte a claude_desktop_config.json:

    {
  "mcpServers": {
    "xero-mcp": {
      "command": "npx",
      "args": ["-y", "xero-mcp@latest"],
      "env": {
        "XERO_CLIENT_ID": "YOUR_CLIENT_ID",
        "XERO_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "XERO_REDIRECT_URI": "http://localhost:5000/callback"
      }
    }
  }
}

    Reinicie o Claude Desktop, ou recarregue via Desenvolvedor -> Recarregar Configuração MCP.

    Claude Code

    Execute o seguinte comando para adicionar o servidor MCP:

    claude mcp add xero-mcp \
  -e XERO_CLIENT_ID=YOUR_CLIENT_ID \
  -e XERO_CLIENT_SECRET=YOUR_CLIENT_SECRET \
  -e XERO_REDIRECT_URI=http://localhost:5000/callback \
  -- npx -y xero-mcp@latest

    O servidor estará disponível na sua próxima sessão do Claude Code. Para disponibilizá-lo em todos os projetos, adicione --scope user ao comando acima.

  4. Ao acessar uma ferramenta do Xero pela primeira vez, uma página de login do Xero aparecerá para solicitar seu consentimento. Conclua o fluxo de autenticação e feche manualmente a página da web (pois a página do Xero não fechará automaticamente nesta versão)

    Alerta de privacidade: após concluir o fluxo OAuth2 do Xero, seus dados do Xero podem passar pelo LLM que você usa. Se você estiver fazendo testes, deve autorizar sua Empresa de Demonstração do Xero.

Ferramentas

  • authenticate

    Autentique-se com o Xero usando OAuth2

  • create_bank_transactions

    Cria uma ou mais transações de dinheiro gasto ou recebido

  • create_contacts

    Cria um ou vários contatos em uma organização Xero

  • get_balance_sheet

    Recupera o relatório de balanço patrimonial

  • get_bank_transaction

    Recupera uma única transação de dinheiro gasto ou recebido pelo ID da transação bancária Xero

  • get_invoice

    Recupera uma única fatura de venda ou conta de compra pelo ID da fatura Xero

  • list_accounts

    Recupera o plano de contas completo

  • list_bank_transactions

    Recupera quaisquer transações de dinheiro gasto ou recebido

  • list_contacts

    Recupera todos os contatos em uma organização Xero

  • list_invoices

    Recupera faturas de venda ou contas de compra

  • list_organisations

    Recupera detalhes da organização Xero

  • list_payments

    Recupera pagamentos para faturas e notas de crédito

  • list_quotes

    Recupera cotações de venda

  • update_bank_transaction

    Atualiza uma transação existente de dinheiro gasto ou recebido (ex.: itens de linha, contato, conta bancária) pelo ID da transação bancária

  • update_invoice

    Atualiza uma fatura de venda ou conta de compra existente (normalmente um rascunho), incluindo itens de linha e códigos de conta

Exemplos

  • "Visualize minha posição financeira no último mês"

  • "Acompanhe meus gastos na última semana"

  • "Adicione todas as transações do extrato mensal à minha conta de receita (código de conta 201) como dinheiro recebido"

Licença

MIT