Agentes de IA (MCP)

{
  "mcpServers": {
    "timbrix": {
      "command": "npx",
      "args": ["@timbrix/mcp"],
      "env": {
        "TIMBRIX_API_KEY": "sk_..."
      }
    }
  }
}

npx @timbrix/mcp

npm install -g @timbrix/mcp
TIMBRIX_API_KEY=sk_... timbrix-mcp

{
  "mcpServers": {
    "timbrix": {
      "command": "npx",
      "args": ["@timbrix/mcp"],
      "env": {
        "TIMBRIX_API_KEY": "sk_..."
      }
    }
  }
}

// Pseudocódigo del flujo, usando las herramientas MCP expuestas por
// @timbrix/mcp a través de un cliente MCP (ver ejemplos de LangChain
// más abajo para cómo obtener `tools` en la práctica).

async function onPaymentSucceeded(paymentIntent: Stripe.PaymentIntent) {
  const { customerRfc, customerName, amount, description } =
    extractInvoiceDataFromPaymentIntent(paymentIntent)

  // 1. El agente decide si el cliente ya existe o necesita datos genéricos
  //    de "Público en General" (XAXX010101000) cuando no se capturó RFC.
  const customer = customerRfc
    ? { legalName: customerName, taxId: customerRfc, taxSystem: "601" }
    : {
        legalName: "PUBLICO EN GENERAL",
        taxId: "XAXX010101000",
        taxSystem: "616",
      }

  // 2. Fecha SIEMPRE en hora de Ciudad de México, nunca en UTC.
  const date = new Date()
    .toLocaleString("sv-SE", { timeZone: "America/Mexico_City" })
    .replace(" ", "T")

  // 3. El agente invoca timbrix_crear_cfdi_ingreso vía MCP.
  const result = await mcpTools.timbrix_crear_cfdi_ingreso({
    series: "A",
    folioNumber: String(paymentIntent.id).slice(-8),
    date,
    paymentForm: "04", // tarjeta de crédito
    paymentMethod: "PUE",
    use: customerRfc ? "G03" : "S01",
    customer,
    items: [
      {
        description,
        quantity: 1,
        unitPrice: amount / 100,
        amount: amount / 100,
        productKey: 84111506,
        unitKey: "E48",
      },
    ],
    // Idempotencia atada al ID del evento de Stripe: un reintento del
    // webhook o un timeout de red no genera un CFDI duplicado.
    idempotencyKey: `stripe-${paymentIntent.id}`,
  })

  if (result.isError) {
    // Ver "Manejo de errores" — el texto libre en result.content[0].text
    // trae el código CFDI##### embebido cuando aplica.
    return notifyOpsOfFailedInvoice(paymentIntent, result.content[0].text)
  }

  const invoice = JSON.parse(result.content[0].text)
  return notifyCustomer(invoice.uuid)
}

import { MultiServerMCPClient } from "@langchain/mcp-adapters"
import { ChatAnthropic } from "@langchain/anthropic"
import { createReactAgent } from "@langchain/langgraph/prebuilt"

const client = new MultiServerMCPClient({
  timbrix: {
    transport: "stdio",
    command: "npx",
    args: ["@timbrix/mcp"],
    env: { TIMBRIX_API_KEY: process.env.TIMBRIX_API_KEY! },
  },
})

const tools = await client.getTools()

const agent = createReactAgent({
  llm: new ChatAnthropic({ model: "claude-sonnet-4-5" }),
  tools,
})

const result = await agent.invoke({
  messages: [
    {
      role: "user",
      content:
        "Timbra un CFDI de ingreso a Público en General por $100 MXN, " +
        "forma de pago efectivo, uso G03.",
    },
  ],
})

from langchain_mcp_adapters.client import MultiServerMCPClient
from langchain_anthropic import ChatAnthropic
from langgraph.prebuilt import create_react_agent
import os

client = MultiServerMCPClient(
    {
        "timbrix": {
            "transport": "stdio",
            "command": "npx",
            "args": ["@timbrix/mcp"],
            "env": {"TIMBRIX_API_KEY": os.environ["TIMBRIX_API_KEY"]},
        }
    }
)

tools = await client.get_tools()

agent = create_react_agent(ChatAnthropic(model="claude-sonnet-4-5"), tools)

result = await agent.ainvoke(
    {
        "messages": [
            (
                "user",
                "Timbra un CFDI de ingreso a Público en General por "
                "$100 MXN, forma de pago efectivo, uso G03.",
            )
        ]
    }
)

const result = await mcpTools.timbrix_crear_cfdi_ingreso(payload)

if (result.isError) {
  const message = result.content[0].text // texto libre, puede traer CFDI#####
  // decide reintentar, escalar a un humano, o registrar el fallo
}