Conectar un asistente de IA (MCP)

Tupana tiene un servidor MCP (Model Context Protocol) para que un asistente de IA consulte y opere sobre tus empresas en tu nombre: buscar documentos, emitir facturas, revisar libros del SII, conciliar el banco o armar reportes, todo desde la conversación.

Datos de conexión

Dato	Valor
URL del servidor	`https://mcp.tupana.ai/mcp`
Transporte	Streamable HTTP (MCP remoto)
Autenticación	OAuth 2.1 con PKCE y registro dinámico de clientes
API key o client ID	No se necesitan
Inicio de sesión	Tu cuenta Tupana: email y clave, o Google
Configuración adicional	Ninguna

No tienes que generar una API key ni registrar una aplicación. Al conectar, el cliente abre el inicio de sesión de Tupana en el navegador; después guarda el token y lo renueva solo.

Cómo conectarse

Claude
Claude Code
Cursor
ChatGPT y otros

En claude.ai o Claude Desktop:

Abre Configuración → Conectores.
Elige Agregar conector personalizado.
Pega la URL https://mcp.tupana.ai/mcp y guarda.
Al conectar, inicia sesión con tu cuenta Tupana.

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

Luego, dentro de Claude Code, ejecuta /mcp y elige tupana para iniciar sesión.

Agrega el servidor en mcp.json (global en ~/.cursor/mcp.json o por proyecto en .cursor/mcp.json):

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

Cursor pedirá iniciar sesión con tu cuenta Tupana la primera vez que use el servidor.

Sirve cualquier cliente que soporte servidores MCP remotos con OAuth:

Busca en la configuración del cliente la opción para agregar un servidor MCP remoto (a veces se llama conector o integración).
Indica la URL https://mcp.tupana.ai/mcp.
Si pregunta por el tipo de autenticación, elige OAuth. No hay client ID ni secreto que ingresar: el registro es automático.
Inicia sesión con tu cuenta Tupana cuando el cliente lo pida.

Los nombres de los menús cambian según el cliente y su versión; revisa su documentación si no encuentras la opción.

Permisos y seguridad

El asistente actúa con tus permisos: sólo ve y opera sobre las empresas a las que perteneces en Tupana.
Las acciones que emiten documentos al SII o envían correos piden confirmación explícita en la conversación antes de ejecutarse. Sin confirmación, el documento queda como borrador.
Para revocar el acceso, desconecta el servidor en el cliente.

Qué puedes hacer

Las herramientas se describen solas al conectarse, así que la lista siempre está al día. Pídele al asistente que use:

list_capabilities: lo que el servidor puede hacer, por categoría.
how_to: el paso a paso de una tarea (por ejemplo, emitir una factura o una nota de crédito).

Categoría	Ejemplos
Documentos	Consultar y buscar emitidos y recibidos; emitir facturas afectas (33) y exentas (34), notas de crédito (61), facturas de compra (46) y facturas de exportación (110); crear facturas programadas; obtener el PDF
Clientes y proveedores	Datos de una empresa por RUT; cuentas por cobrar y por pagar
Libros del SII y F29	Libros de compra y venta; resumen de IVA y del F29
Banco y conciliación	Movimientos bancarios; sugerencias de conciliación; conciliar movimientos
Contabilidad	Asientos, libro mayor, balance y estado de resultados
Gráficos	Reportes y gráficos de ventas, compras y otros indicadores

Qué no hace

No emite guías de despacho (DTE 52). Puede consultarlas, pero para emitirlas usa la plataforma o la API de emisión masiva.
No reemplaza tareas que sólo existen en pantalla, como cargas masivas o configurar credenciales del SII: en esos casos el asistente te entrega el link a la plataforma.
No es una integración de sistema a sistema: necesita un usuario que inicie sesión y confirme las acciones.

¿MCP o API REST?

Usa el MCP si…	Usa la API REST si…
Trabajas desde un asistente de IA, con una persona en la conversación	Integras un sistema (ERP, e-commerce, backoffice) que emite sin intervención humana
Quieres consultar, analizar o emitir documentos puntuales	Emites en volumen (hasta 200 documentos por llamada) y recibes el resultado por webhook
Te basta con iniciar sesión con tu cuenta	Necesitas tipos o campos que el MCP no cubre, como la guía de despacho con transporte y Aduana

La API usa API key (Authorization: Api-Key TU_API_KEY), no la sesión del usuario:

API de Facturación v2 (por defecto)
API de Facturación v1
Especificaciones OpenAPI, la fuente legible por máquina para agentes de código que integran la API: openapi-v2.json y openapi-combined.json (v1).

mcp.tupana.ai es el servidor de Tupana: da acceso a los datos y operaciones de tus empresas, con inicio de sesión. No es el buscador de documentación que Mintlify puede exponer en el dominio de esta documentación, que sólo lee páginas públicas.

Guía para asistentes

Si eres un asistente de IA, la misma información está en texto plano en /llms.txt (índice) y /llms-full.txt (guía completa).

Primeros Pasos

Referencia

Conectar un asistente de IA (MCP)

Conectar un asistente de IA (MCP)

Datos de conexión

Cómo conectarse

Permisos y seguridad

Qué puedes hacer

Qué no hace

¿MCP o API REST?

Guía para asistentes

​Conectar un asistente de IA (MCP)

​Datos de conexión

​Cómo conectarse

​Permisos y seguridad

​Qué puedes hacer

​Qué no hace

​¿MCP o API REST?

​Guía para asistentes

Conectar un asistente de IA (MCP)

Datos de conexión

Cómo conectarse

Permisos y seguridad

Qué puedes hacer

Qué no hace

¿MCP o API REST?

Guía para asistentes