Cómo conectar Moss a Gemini vía MCP

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

Moss + Gemini

Moss spend management (Alemania y Europa): gastos de tarjetas, facturas y reembolsos con líneas y recibos, saldos de wallets y transacciones bancarias, proveedores, cuentas de gasto, tipos de IVA y centros de coste. Crea proveedores y elementos de dimensión; no puede pagar ni aprobar nada.

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:

MOSS_KEY_ID, MOSS_SECRET_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas un admin de Moss y la app móvil de Moss para confirmar la nueva clave.

1. Inicia sesión en Moss como admin y abre Settings, Company Settings, API Keys (también aparece como Settings, Platform, API Keys).
2. Haz clic en Generate API Key y confirma en la app móvil de Moss.
3. Copia el Key ID (empieza por kid_) en MOSS_KEY_ID y la Secret Key (empieza por sk_) en MOSS_SECRET_KEY. La clave secreta se muestra una sola vez; si la pierdes, genera una nueva.
4. Instala el conector y ejecuta moss_list_expenses: devuelve tus últimos gastos y confirma la clave.

El conector cambia la clave por un token de una hora en /oauth2/token de Moss (client credentials) y lo renueva por su cuenta. Pide el scope write, que incluye read, porque las herramientas de creación y modificación lo necesitan. Si la IA solo debe leer, desactiva esas herramientas.

Qué lee: los gastos (transacciones con tarjeta, facturas y reembolsos) con sus líneas, importes netos, de IVA y brutos, cuenta de gasto y tipo de IVA por línea, estado, estado de exportación y proveedor; los archivos adjuntos a los gastos (recibos, PDF de facturas), listados con moss_search_files y entregados como adjunto por moss_download_file; las cuentas bancarias de Moss (wallets) con tipo de financiación, moneda y estado, el saldo y el saldo disponible de cada una, y las transacciones bancarias de un rango de fechas de contabilización (compras y devoluciones con tarjeta, pagos, retiradas, recargas, amortizaciones, con fecha de contabilización y de valor, contraparte y comisiones); los proveedores con datos bancarios, NIF-IVA, condición de pago e imputación predeterminada; las cuentas de gasto con sus números; los tipos de IVA; las condiciones de pago con sus reglas de vencimiento y descuento; las dimensiones contables como centros de coste, portadores de coste y proyectos con sus elementos; los usuarios con equipo, responsable y roles; equipos y departamentos.

Filtros: los gastos se filtran por tipo (CARD_TRANSACTION, INVOICE, REIMBURSEMENT), estado (p. ej. SUBMITTED, APPROVED, FLAGGED, REJECTED, REVIEWED, VERIFIED, COMPLETED), estado de exportación (NOT_EXPORTED, READY_FOR_EXPORT, EXPORT_PENDING, EXPORTED, EXPORT_FAILED), fecha de creación, fecha del gasto o última modificación, y se ordenan por estado, hora de creación, importe en moneda de la empresa u hora del gasto. Las transacciones bancarias siempre necesitan un rango de fechas de contabilización. Los archivos de líneas concretas solo se listan si también se pasan los id de las líneas.

Qué escribe: moss_create_supplier, moss_create_dimension, moss_update_dimension, moss_create_dimension_item (p. ej. un centro de coste nuevo) y moss_update_dimension_item cambian datos maestros que se usan para contabilizar. Están activas al instalar; la IA te muestra qué va a crear o cambiar y espera tu sí, y pasa external_user_id (la persona que lo pidió) para que Moss pueda rastrear el cambio. Proveedores y elementos de dimensión pueden ponerse en ACTIVE o DEACTIVATED; no se ofrece borrar. Actualizar un elemento de dimensión siempre requiere nombre y estado, así que la IA envía los valores actuales de lo que debe quedarse igual. Crear más dimensiones que las predeterminadas requiere el módulo Multiple Dimensions de Moss.

Desactivada al instalar: moss_update_supplier, porque puede sustituir el IBAN al que Moss paga las facturas del proveedor. Un administrador la activa de forma deliberada, y la IA muestra entonces los valores antiguos y nuevos antes de llamarla.

Importes y fechas: los importes son objetos con una cadena decimal amount y una currency; homeAmount está en la moneda de la empresa. Las fechas son YYYY-MM-DD y las marcas de tiempo ISO 8601 en UTC. Los id son UUID.

Límites: las listas devuelven hasta 100 elementos por página (50 por defecto); la IA pide la page siguiente mientras meta.pagination.hasMore sea true. Los filtros por id aceptan hasta 100 id. Moss permite 180 lecturas y 20 escrituras por minuto y organización.

Errores comunes: 401 significa que la clave fue revocada o no se pudo emitir el token: revisa MOSS_KEY_ID y MOSS_SECRET_KEY. 402 significa que un módulo de Moss no está contratado, p. ej. Multiple Dimensions. 403 significa que al token le falta el scope. 409 significa que el registro lo gestiona una integración contable activa. 422 significa que un id referenciado (cuenta de gasto, tipo de IVA, condición de pago, equipo) no existe o está inactivo. 429 significa que se agotó el límite de peticiones: espera a Retry-After.

El conector no puede pagar, aprobar, exportar ni borrar nada, y no crea gastos ni sube recibos: la Moss Public API no ofrece ninguna llamada para eso.

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 Gemini

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.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Moss.

Herramientas disponibles

Ejemplos de prompts

• "Lista las transacciones con tarjeta del mes pasado que siguen en NOT_EXPORTED, con importe, proveedor y cuenta de gasto."
• "¿Cuál es ahora el saldo disponible de cada una de nuestras wallets de Moss?"
• "Muéstrame el recibo adjunto al gasto de Moss de 249,90 EUR del 14 de octubre."
• "Suma nuestras facturas del tercer trimestre por proveedor y tipo de IVA."
• "Crea el centro de coste 4300 Marketing Events en nuestra dimensión de centros de coste. Muéstrame antes qué vas a crear."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot