Tupana MCP server

Tupana MCP

Servidor MCP remoto de Tupana: conecta Claude, ChatGPT, Cursor o cualquier agente compatible con tu facturación electrónica chilena (SII), cobranza, conciliación bancaria y reportes de ventas.

https://mcp.tupana.ai/mcp

• Transporte: Streamable HTTP.
• Autenticación: OAuth 2.1 con PKCE y registro dinámico de clientes. Al conectar, el cliente te abre el navegador para que inicies sesión en Tupana y autorices el acceso. No necesitas copiar ninguna API key.
• Scopes: tupana:read y tupana:write.
• Privacidad: cada usuario ve solo las empresas a las que tiene acceso en Tupana; todas las herramientas resuelven documentos y empresas dentro de ese alcance.
• Seguridad: las acciones irreversibles (emitir al SII, enviar correos, conciliar) están diseñadas para pedir confirmación. La emisión es un paso separado: el agente crea un borrador, te muestra la vista previa en PDF y solo emite con emit_document después de tu visto bueno.

¿Aún no tienes cuenta? Créala en developers.tupana.ai.

Qué puedes pedirle

• "¿Cuánto facturé este mes y quiénes son mis 10 mayores clientes?"
• "Hazle una factura a 76.123.456-7 por 3 horas de asesoría a $45.000 + IVA, con referencia a la OC 4500123."
• "¿Qué facturas tengo pendientes de cobro con más de 30 días?"
• "Concilia los movimientos del banco de ayer con las facturas que calcen."
• "Muéstrame el resumen de IVA y el F29 de septiembre."
• "Agrégale facturación electrónica chilena a este SaaS." (el MCP también enseña a construir la integración)

Conectar

Claude (claude.ai y Claude Desktop)

1. Ve a Settings → Connectors → Add custom connector.
2. Nombre: Tupana. URL: https://mcp.tupana.ai/mcp.
3. Haz clic en Connect, inicia sesión en Tupana y autoriza.

En planes Team y Enterprise, un administrador puede agregar el conector para toda la organización.

Claude Code

claude mcp add --transport http tupana https://mcp.tupana.ai/mcp

Luego, dentro de Claude Code, ejecuta /mcp, elige tupana y completa el login en el navegador. Para compartirlo con tu equipo, agrégalo con --scope project (queda en .mcp.json).

Cursor

En ~/.cursor/mcp.json (global) o .cursor/mcp.json (proyecto):

{
  "mcpServers": {
    "tupana": {
      "url": "https://mcp.tupana.ai/mcp"
    }
  }
}

Cursor detecta que el servidor pide OAuth y te muestra el botón para iniciar sesión.

ChatGPT

1. Activa Settings → Apps & Connectors → Advanced settings → Developer mode (disponible según tu plan).
2. En Apps & Connectors, crea un conector nuevo con la URL https://mcp.tupana.ai/mcp y autenticación OAuth.
3. Autoriza con tu cuenta de Tupana y actívalo en el chat.

VS Code (GitHub Copilot)

En .vscode/mcp.json:

{
  "servers": {
    "tupana": {
      "type": "http",
      "url": "https://mcp.tupana.ai/mcp"
    }
  }
}

Otros clientes

Cualquier cliente con soporte de MCP remoto (Streamable HTTP + OAuth 2.1) funciona con la misma URL. El servidor publica sus metadatos en:

• https://mcp.tupana.ai/.well-known/oauth-protected-resource
• https://mcp.tupana.ai/.well-known/oauth-authorization-server

Si tu cliente solo soporta stdio, usa un puente como mcp-remote:

{
  "mcpServers": {
    "tupana": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tupana.ai/mcp"]
    }
  }
}

Desde tu propio agente

En tupana-ai/tupana-examples hay un agente en Python (API de Claude + cliente MCP) que factura pidiéndote confirmación antes de emitir.

Herramientas

Documentos y facturación

Shortened. The full README is on GitHub.