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, los 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://api.tefacturo.pe/doc/integracion/api/mcp/"
    }
  }
}

Descargar configuración MCP

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

Configuración por cliente

Es un MCP remoto sobre Streamable HTTP. La URL es la única fuente de verdad: https://api.tefacturo.pe/doc/integracion/api/mcp/

Cursor · VS Code · genérico

Agrégalo a .cursor/mcp.json (Cursor), .vscode/mcp.json (VS Code) o al mcpServers de tu cliente:

mcp.json

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

Claude Code (CLI)

Ejecuta en tu terminal:

terminal

claude mcp add --transport http tefacturo-docs https://api.tefacturo.pe/doc/integracion/api/mcp/

Claude Desktop (y clientes solo stdio)

Usa el puente mcp-remote en claude_desktop_config.json (requiere Node.js instalado):

claude_desktop_config.json

{
  "mcpServers": {
    "tefacturo-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.tefacturo.pe/doc/integracion/api/mcp/"]
    }
  }
}

Codex CLI

Agrégalo a ~/.codex/config.toml (usa el puente mcp-remote):

~/.codex/config.toml

[mcp_servers.tefacturo-docs]
command = "npx"
args = ["-y", "mcp-remote", "https://api.tefacturo.pe/doc/integracion/api/mcp/"]

Herramientas disponibles

search_docs

Buscar en la documentación (PDFs + JSON internos actualizados)

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 el JSON actualizado para emitir una factura gravada
con pago al contado, moneda soles y precios sin IGV.

IA (usando MCP - search_docs): Busco "Factura gravada JSON actualizado"...
IA: Encontró el documento interno de JSON actualizados. Ahora leo el documento.

IA (usando MCP - read_doc): Extraigo la sección "Factura gravada":

{
  "close2u": {
    "tipoIntegracion": "OFFLINE",
    "tipoPlantilla": "01",
    "tipoRegistro": "PRECIOS_SIN_IGV"
  },
  "datosDocumento": {
    "serie": "FFA6",
    "numero": 1,
    "moneda": "PEN",
    "formaPago": "CONTADO"
  },
  "detalleDocumento": [
    { "descripcion": "PRODUCTO GRAVADO A", "cantidad": "1", "valorVentaUnitarioItem": 100 }
  ]
}

Nota: Usa la sección completa devuelta por read_doc al copiar el payload.

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