Xero

Interactúa con la API del software de contabilidad Xero.

GitHub
21
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Xero

smithery badge

Este servidor MCP permite que los Clientes interactúen con Xero Accounting Software.

Comenzar

  1. Asegúrate de que node esté instalado.

  2. Crea una aplicación OAuth 2.0 en Xero para obtener un CLIENT_ID y un CLIENT_SECRET.

    • Crea una cuenta de usuario gratuita de Xero (si no tienes una)

    • Inicia sesión en el centro de desarrolladores de Xero https://developer.xero.com/app/manage/

    • Haz clic en Nueva aplicación

    • Ingresa un nombre para tu aplicación

    • Selecciona Aplicación web

    • Proporciona una URL válida (puede ser cualquier URL válida, por ejemplo, https://www.myapp.com)

    • Ingresa la URI de redirección: http://localhost:5000/callback

      Nota: La URI de redirección se puede personalizar, pero debe usar localhost e incluir tanto un puerto explícito como una ruta (por ejemplo, http://localhost:5050/my-path). Establece el mismo valor que XERO_REDIRECT_URI en la configuración de tu cliente MCP a continuación.

    • Marca la casilla para Aceptar los Términos y Condiciones y haz clic en Crear aplicación

    • En el lado izquierdo de la pantalla, selecciona Configuración

    • Haz clic en Generar un secreto

  3. Configura tu cliente MCP:

    Claude Desktop

    Ve a Configuración -> Desarrolladores -> Servidores MCP locales -> Editar configuración y agrega lo siguiente 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"
      }
    }
  }
}

    Reinicia Claude Desktop, o recarga mediante Desarrollador -> Recargar configuración de MCP.

    Claude Code

    Ejecuta el siguiente comando para agregar el 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

    El servidor estará disponible en tu próxima sesión de Claude Code. Para que esté disponible en todos los proyectos, agrega --scope user al comando anterior.

  4. Al acceder a una herramienta de Xero por primera vez, aparecerá una página de inicio de sesión de Xero para solicitar tu consentimiento. Completa el flujo de autenticación y cierra manualmente la página web (ya que la página de Xero no se cerrará automáticamente en esta versión)

    Alerta de privacidad: después de completar el flujo OAuth2 de Xero, tus datos de Xero pueden pasar a través del LLM que uses. Si estás realizando pruebas, debes autorizar a tu Xero Demo Company.

Herramientas

  • authenticate

    Autentícate con Xero usando OAuth2

  • create_bank_transactions

    Crea una o más transacciones de dinero gastado o recibido

  • create_contacts

    Crea uno o varios contactos en una organización de Xero

  • get_balance_sheet

    Recupera el informe del balance general

  • get_bank_transaction

    Recupera una única transacción de dinero gastado o recibido por su ID de transacción bancaria de Xero

  • get_invoice

    Recupera una única factura de venta o factura de compra por su ID de factura de Xero

  • list_accounts

    Recupera el catálogo de cuentas completo

  • list_bank_transactions

    Recupera cualquier transacción de dinero gastado o recibido

  • list_contacts

    Recupera todos los contactos en una organización de Xero

  • list_invoices

    Recupera facturas de venta o facturas de compra

  • list_organisations

    Recupera los detalles de la organización de Xero

  • list_payments

    Recupera pagos para facturas y notas de crédito

  • list_quotes

    Recupera cotizaciones de ventas

  • update_bank_transaction

    Actualiza una transacción existente de dinero gastado o recibido (por ejemplo, líneas de detalle, contacto, cuenta bancaria) por ID de transacción bancaria

  • update_invoice

    Actualiza una factura de venta o factura de compra existente (generalmente un borrador), incluyendo líneas de detalle y códigos de cuenta

Ejemplos

  • "Visualiza mi posición financiera durante el último mes"

  • "Rastrea mis gastos durante la última semana"

  • "Agrega todas las transacciones del estado de cuenta mensual a mi cuenta de ingresos (código de cuenta 201) como dinero recibido"

Licencia

MIT