Cómo conectar Xero a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Xero, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Xero + Cursor

Deja que tu IA lea tu contabilidad de Xero: facturas de venta y facturas de proveedores, contactos de clientes y proveedores, el plan de cuentas, el balance de comprobación (Trial Balance) y la cuenta de pérdidas y ganancias con comparación de periodos, por devengo o por caja. Solo lectura, con tu propia app OAuth2 de Xero y el acceso mediante Authorize with Provider.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

XERO_CLIENT_ID, XERO_CLIENT_SECRET

Paso 1 — Obtener credenciales

1. Inicia sesión en developer.xero.com/app/manage (My Apps) y crea una app OAuth2 de tipo Web app (flujo de código de autorización).
2. Como redirect URI, introduce https://cloud.anythingmcp.com/api/mcp-oauth/callback para AnythingMCP Cloud, o <tu URL de AnythingMCP>/api/mcp-oauth/callback si alojas AnythingMCP tú mismo. Debe coincidir exactamente.
3. En la página Configuration de la app, copia el Client ID en XERO_CLIENT_ID, luego genera un client secret y pégalo en XERO_CLIENT_SECRET.
4. Deja vacíos XERO_TENANT_ID y XERO_REFRESH_TOKEN e instala el conector. En la página del conector, haz clic en Authorize with Provider, inicia sesión en Xero y conecta la organización que la IA debe leer.
5. Ejecuta xero_list_connections. Elige la entrada con el tenantName correcto y el tenantType ORGANISATION, y copia su tenantId en XERO_TENANT_ID. No uses el id ni el authEventId de la conexión: son valores distintos. Mientras falte XERO_TENANT_ID, las demás herramientas se detienen antes de llamar a Xero e indican la variable que falta.
6. Ejecuta xero_get_organisation y comprueba el nombre de la organización antes de que la IA lea ninguna cifra. Un conector lee una sola organización; para una segunda, vuelve a instalarlo.

Mantener la sesión iniciada: los access tokens duran 30 minutos y se renuevan automáticamente, y AnythingMCP guarda cada nuevo refresh token que entrega Xero. Un refresh token que no se renueva en 60 días caduca; entonces vuelve a hacer clic en Authorize with Provider. Rellena XERO_REFRESH_TOKEN solo si ya tienes un refresh token válido para la misma app con el mismo consentimiento de solo lectura, y no compartas un refresh token con otra integración: Xero lo sustituye en cada renovación y una de las dos se quedaría con uno no válido.

Solo lectura por diseño: las diez herramientas solo leen (GET); ninguna crea, modifica ni elimina datos contables. El conector pide los scopes de solo lectura openid offline_access accounting.invoices.read accounting.contacts.read accounting.settings.read accounting.reports.trialbalance.read accounting.reports.profitandloss.read. Xero suma consentimientos en lugar de reemplazarlos: si la app se autorizó antes con permisos de escritura, el token los conserva. Para reducirlos, revoca la conexión anterior en Xero y vuelve a hacer clic en Authorize with Provider. Además, la IA solo ve lo que puede ver el usuario de Xero que inicia sesión; para los informes, ese usuario necesita acceso a los informes.

Facturas, contactos y cuentas: xero_list_invoices devuelve juntas las facturas de venta (ACCREC) y las facturas de proveedores (ACCPAY). Filtra con where, por ejemplo Type=="ACCREC", y ordena con order, por ejemplo InvoiceNumber ASC. Facturas y contactos llegan en páginas de hasta 100 registros; la IA sigue pidiendo páginas hasta que una vuelve vacía o incompleta. xero_list_contacts busca en nombres, números de contacto y correos electrónicos, e incluye los contactos archivados si se pide. El plan de cuentas llega de una sola vez. xero_get_invoice, xero_get_contact y xero_get_account necesitan el UUID de la lista correspondiente, no un número de factura, un nombre de contacto ni un código de cuenta.

Informes: xero_get_trial_balance recibe una date, xero_get_profit_and_loss un fromDate y un toDate (formato YYYY-MM-DD). Ambos usan el criterio de devengo, salvo que pidas el criterio de caja (paymentsOnly). La cuenta de pérdidas y ganancias puede comparar de 1 a 12 periodos por mes, trimestre o año (periods y timeframe).

Errores frecuentes: 401 o 403 significa que falta el consentimiento, que la autorización caducó, que el usuario de Xero no tiene los permisos necesarios o que la organización no está conectada a esta app: compara XERO_TENANT_ID con xero_list_connections y vuelve a hacer clic en Authorize with Provider. 429 significa que se alcanzó el límite de solicitudes de Xero para la organización: la IA espera los segundos que indica Retry-After antes de reintentar, y la cabecera X-Rate-Limit-Problem indica qué límite se superó. Los límites dependen del nivel de tu app, consulta los límites de la API de Xero.

El conector no crea, modifica ni elimina nada en Xero, y no lee movimientos bancarios, el balance general, nóminas, archivos ni adjuntos.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Xero.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué facturas de venta siguen sin cobrar, y cuánto nos debe en total cada cliente?"
• "Muéstrame la cuenta de pérdidas y ganancias del último trimestre comparada con los tres trimestres anteriores."
• "¿Qué facturas de proveedores vencen en los próximos 14 días, y por qué importes?"
• "Busca a Acme S.L. en nuestros contactos y muéstrame su correo electrónico, su dirección de facturación y su saldo pendiente."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse