MCP Server para IA

TeFacturo ofrece un servidor MCP (Model Context Protocol) que permite a asistentes de IA como Claude, ChatGPT y otros acceder a la documentación de la API de forma estructurada.

¿Qué es MCP?

MCP (Model Context Protocol) es un protocolo abierto que permite a los asistentes de IA acceder a fuentes de datos externas y herramientas de manera estandarizada. En lugar de copiar y pegar documentación manualmente, la IA puede consultar directamente los datos que necesita.

Con el servidor MCP de TeFacturo, los asistentes de IA pueden obtener la estructura exacta de los endpoints, ejemplos JSON actualizados y catálogos completos, todo de forma automática y en tiempo real.

Configuración

Para producción, usa el MCP remoto (Streamable HTTP) apuntando a tu deploy:

MCP remoto (Streamable HTTP)

{
  "mcpServers": {
    "tefacturo-docs": {
      "url": "https://tefacturo.pe/doc/integracion/api/mcp"
    }
  }
}

Descargar configuración MCP

Este archivo genera la URL correcta automáticamente: /api/mcp

Herramientas disponibles

search_docs

Buscar en la documentación (PDFs + docs internas)

Retorna coincidencias relevantes para endpoints, parámetros, tokens, ejemplos JSON y guías.

read_doc

Leer un documento (por id)

Devuelve el contenido del documento (o una sección) para que la IA responda con precisión.

list_docs

Listar documentos disponibles

Lista los documentos indexados (por ejemplo, los textos extraídos de tus PDFs).

Ejemplo de uso con IA

A continuación, un ejemplo de cómo un desarrollador puede interactuar con un asistente de IA que tiene acceso al MCP de TeFacturo:

Conversación con IA

Usuario: Necesito generar el JSON para emitir una factura
con 2 items, IGV incluido, pago al contado, moneda soles.

IA (usando MCP - search_docs): Busco "factura ejemplo json PRECIOS_CON_IGV"...
IA: Encontró un documento relevante. Ahora leo el documento.

IA (usando MCP - read_doc): Extraigo la sección con el ejemplo JSON y la adapto:

{
  "tipoRegistro": "PRECIOS_CON_IGV",
  "tipoOperacion": "VENTA_INTERNA",
  "moneda": "PEN",
  "formaPago": "CONTADO",
  "detalleDocumento": [
    { "descripcion": "Item 1", "cantidad": "1", "valorVentaUnitarioItem": 500 },
    { "descripcion": "Item 2", "cantidad": "2", "valorVentaUnitarioItem": 250 }
  ]
}

Nota: El JSON real depende del endpoint (factura/boleta/guía) y de los catálogos permitidos.

Beneficios

Integración más rápida

Los desarrolladores que usan IA pueden integrar más rápido al tener acceso directo a la documentación estructurada.

Documentación siempre actualizada

La IA siempre tiene acceso a la documentación actualizada, evitando errores por información desactualizada.

Menos errores

Reduce errores en la integración al generar JSONs válidos basados en la documentación oficial.

Ver ejemplos JSON Consultar catálogos