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:
https://integrador.fiscalcloud.mx/docs/api/openapi.yaml
https://integrador.fiscalcloud.mx/llms.txt
https://integrador.fiscalcloud.mx/llms-full.txt
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>:
- Pruebas:
https://sandbox-mcp.fiscalcloud.mx - Producción:
https://mcp.fiscalcloud.mx
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.
- Claude (claude.ai y su app): Configuración › Conectores › agregar un conector personalizado con la dirección del MCP.
- ChatGPT: activa el modo desarrollador y crea un conector con la dirección del MCP y autenticación OAuth.
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
- timbrar — Timbrar un CFDI (relay o sellar)
- validar — Validar sin timbrar (sandbox)
- saldo — Timbres disponibles
- comprobantes_listar — Listar timbrados
- comprobante_obtener — Consultar por UUID
- comprobante_estatus_sat — Estatus ante el SAT
- cancelar — Cancelar ante el SAT (con el CSD registrado en tu cuenta)
- buscar_en_docs — Buscar en la documentación
3. Sandbox y API key
- Sandbox (
sandbox-api.fiscalcloud.mx/v1): timbra sin valor fiscal y sin consumir timbres. Perfecto para que la IA pruebe. - API key: genérala en tu portal → API keys (arranca en sandbox; producción se habilita al certificar).
- Seguridad: guarda la key en variables de entorno, nunca en el código ni en prompts que compartas.