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

Clientes, proveedores y empresas

Reportes, libros e impuestos

Cobranza y conciliación bancaria

Cesión de facturas (factoring)

Base pública de empresas del SII

Construir facturación en tu SaaS

Conexión de empresas y navegación

La lista refleja el servidor al momento de publicar este repositorio. La fuente de verdad es tools/list del propio servidor.

Directorios

• MCP Registry oficial: server.json (io.github.tupana-ai/tupana). Para publicarlo o actualizarlo, ejecuta el workflow Publicar en el MCP Registry (Actions → Run workflow), que se autentica con GitHub OIDC; o desde tu máquina:

  brew install mcp-publisher
  mcp-publisher login github   # con una cuenta miembro de la organización tupana-ai
  mcp-publisher publish
  

• Glama: glama.json declara a los mantenedores. Glama indexa el repositorio como servidor (glama.ai/mcp/servers/tupana-ai/tupana-mcp) y el endpoint remoto como conector (glama.ai/mcp/connectors/io.github.tupana-ai/tupana).

• Smithery: se publica por URL en smithery.ai/new (o smithery mcp publish "https://mcp.tupana.ai/mcp" -n @tupana/tupana); no requiere archivo de configuración en el repositorio.

Recursos

• Documentación: docs.tupana.ai
• Portal de desarrolladores: developers.tupana.ai
• SDKs oficiales: Node.js npm install tupana (npm · GitHub) · Python pip install tupana (PyPI · GitHub)
• Ejemplos: tupana-ai/tupana-examples
• Soporte: contacto@tupana.ai

Licencia

La documentación y los archivos de este repositorio están bajo licencia MIT. El servidor MCP es un servicio alojado por Tupana.

---

English summary

Remote MCP server for Tupana: Chilean electronic invoicing (SII), collections, bank reconciliation, sales reports and invoice cession, at https://mcp.tupana.ai/mcp (Streamable HTTP, OAuth 2.1 with PKCE and dynamic client registration; scopes tupana:read / tupana:write). Add it as a custom connector in Claude, with claude mcp add --transport http tupana https://mcp.tupana.ai/mcp in Claude Code, via mcp.json in Cursor or VS Code, or as a developer-mode connector in ChatGPT. Irreversible actions (issuing to the SII, sending email, reconciling) are designed to require confirmation: the agent creates a draft, shows a PDF preview and only issues with emit_document after you approve. Registry metadata lives in server.json (io.github.tupana-ai/tupana).