FiscalCloud ← Documentación de la API
Para integradores

Integra con IA

¿Usas una IA (Claude, ChatGPT, Cursor, Copilot…) para construir tu integración de timbrado CFDI 4.0? Aquí están los recursos listos para darle contexto y para que tu agente llame nuestra API. Empieza siempre en sandbox.

1. Dale la documentación a tu IA

Pega estas URLs en tu herramienta de IA para que genere código correcto contra el contrato real:

OpenAPI (contrato para máquina)
https://integrador.fiscalcloud.mx/docs/api/openapi.yaml
llms.txt (índice para LLMs)
https://integrador.fiscalcloud.mx/llms.txt
llms-full.txt (documentación completa para LLMs)
https://integrador.fiscalcloud.mx/llms-full.txt
Colección Postman
https://integrador.fiscalcloud.mx/docs/api/fiscalcloud-integradores.postman_collection.json

2. Servidor MCP (agentes de IA)

Nuestro servidor MCP expone la API como herramientas (timbrar, validar, cancelar, saldo, comprobantes) para que tu agente de IA opere directamente. Usa tu API key y timbra en sandbox por defecto.

Claude Desktop / Cursor / VS Code (config MCP)

{
  "mcpServers": {
    "fiscalcloud": {
      "command": "npx",
      "args": ["-y", "@fiscalcloud/mcp"],
      "env": {
        "FISCALCLOUD_API_KEY": "tu_api_key_de_sandbox",
        "FISCALCLOUD_API_BASE": "https://sandbox-api.fiscalcloud.mx/v1"
      }
    }
  }
}

Para producción (ya certificado): usa tu API key de producción y FISCALCLOUD_API_BASE=https://api.fiscalcloud.mx/v1. El código del servidor está en el repositorio (integrations/mcp-fiscalcloud/).

MCP remoto (sin instalar nada)

Si tu herramienta se conecta a un servidor MCP por internet (Streamable HTTP), usa la dirección del ambiente de tu API key, con la llave en Authorization: Bearer <tu API key>:

Antes de timbrar en producción o cancelar, el servidor pide confirmación: no se puede deshacer.

Claude y ChatGPT, sin llave (OAuth)

Los conectores web entran con OAuth 2.1: no pegas ninguna llave. Agrega la dirección del ambiente y la herramienta te trae a FiscalCloud a iniciar sesión, elegir la cuenta y decidir si puede timbrar o cancelar (apagado por omisión). Disponible según tu plan de Claude o de ChatGPT; los nombres del menú pueden cambiar.

Para otros clientes MCP: el 401 anuncia /.well-known/oauth-protected-resource; el servidor de autorización es https://mcp.fiscalcloud.mx (registro dinámico o Client ID Metadata Document, PKCE S256 y resource). Permisos: timbrado:leer, timbrado:emitir y timbrado:cancelar. La conexión se desconecta en Configuración › API e IA (o API keys en el portal del integrador).

Herramientas que expone

3. Sandbox y API key

¿Aún no eres integrador?

Crea tu cuenta y solicita el alta de integrador.

Crear cuenta