Copy-paste · funciona hoy

Timbra desde tu herramienta

Reemplaza TU_API_KEY por la que generaste arriba. Estos ejemplos funcionan hoy mismo.

cURL

n8n

Claude / Cursor

ChatGPT

Gemini CLI

Timbra un CFDI de prueba con una línea:

curl -X POST https://mcp.factumatico.com/api/mcp/trial/invoice \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"total": 116.00}'

# Respuesta: { "ok": true, "uuid": "...", "timbres_left": 1 }

En un nodo HTTP Request de n8n:

Method: POST
URL:    https://mcp.factumatico.com/api/mcp/trial/invoice
Headers:
  Authorization: Bearer TU_API_KEY
  Content-Type:  application/json
Body (JSON): { "total": 116.00 }

Conecta Claude Desktop o Cursor a Factumático. Tu agente podrá timbrar CFDI de prueba solo. Agrega esto a tu config MCP (reemplaza TU_API_KEY):

// claude_desktop_config.json  ·  o  ~/.cursor/mcp.json
{
  "mcpServers": {
    "factumatico": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.factumatico.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": { "AUTH_HEADER": "Bearer TU_API_KEY" }
    }
  }
}

¿"Server disconnected" en Windows? Es un bug conocido de mcp-remote: los headers con espacios se corrompen. Por eso el token va en la variable AUTH_HEADER y el header se escribe sin espacio tras Authorization: (el espacio vive dentro de la variable). Esta config funciona igual en Windows, macOS y Linux.

Reinicia Claude/Cursor y pídele: "timbra una factura de prueba de $116". Verás las tools factumatico_stamp_test_invoice, factumatico_trial_status y factumatico_help. Todo en sandbox, sin validez fiscal — para probar la integración.

¿Quieres el conector MCP para timbrar de verdad (producción)? Déjanos tu correo:

Conecta Factumático como conector remoto (MCP) en ChatGPT. Requiere Developer Mode y una cuenta de pago (Plus, Pro, Business, Enterprise o Edu).

En ChatGPT: Settings → Connectors → Advanced → Developer Mode (actívalo).
Create / Add custom connector e ingresa la URL del servidor MCP:

Server URL: https://mcp.factumatico.com/mcp
Auth:       Header  →  Authorization: Bearer TU_API_KEY

Guarda el conector y actívalo en un chat. Pídele: "timbra una factura de prueba de $116" — verás las tools factumatico_stamp_test_invoice, factumatico_trial_status, factumatico_help.

ℹ️ Los pasos de ChatGPT siguen la documentación oficial de OpenAI (Developer Mode / conectores MCP). La interfaz de OpenAI cambia seguido: si algún paso no coincide, escríbenos a kioscomatico@gmail.com y lo actualizamos.

Gemini CLI soporta servidores MCP remotos vía httpUrl. Agrega este bloque a tu settings.json (~/.gemini/settings.json global, o .gemini/settings.json del proyecto):

{
  "mcpServers": {
    "factumatico": {
      "httpUrl": "https://mcp.factumatico.com/mcp",
      "headers": {
        "Authorization": "Bearer TU_API_KEY"
      },
      "timeout": 10000
    }
  }
}

Reinicia Gemini CLI y verifica con /mcp list. Luego pídele: "timbra una factura de prueba de $116". Todo en sandbox, sin validez fiscal — para probar la integración.

✅ Endpoint verificado: POST /mcp responde el handshake MCP (protocolo 2025-06-18) con auth Bearer. Esta config usa el transporte HTTP nativo de Gemini CLI.

Timbra CFDI 4.0 directo desde tu Agente de IA

De cero a timbrando en tu agente

Pide tu API key

Conecta tu agente

Tu agente factura

Tu API key de prueba, ahora

Timbra desde tu herramienta

Empieza gratis, escala cuando factures

Prueba

Agente

Empresa

Procesando tu pago…