VeloraBlog
← Todos los artículos

13 de junio de 2026

Conectar Claude, Cursor o ChatGPT a la facturación AFIP y MercadoPago vía MCP

MCP (Model Context Protocol) es el estándar que deja que un agente de IA use herramientas externas. Para automatizar comercio argentino —facturar en AFIP/ARCA, cobrar con MercadoPago— podés conectar Claude, Cursor o ChatGPT a un servidor MCP. Esta guía muestra cómo: endpoint público sin auth para probar, y el toolkit completo vía OAuth.

Qué es MCP y por qué sirve para comercio argentino

MCP (Model Context Protocol) es un estándar abierto que expone *herramientas* a un agente de IA: el modelo llama la tool, no escribís el wrapper a mano. Para comercio argentino esto importa porque las operaciones con consecuencia legal o financiera —emitir una factura electrónica en AFIP/ARCA (login WSAA + WSFE + CAE), cobrar con MercadoPago— son llamadas autenticadas que el modelo no puede hacer solo. Un servidor MCP las envuelve como tools que el agente invoca de forma segura.

No es la única forma de integrar AFIP: hay SDKs REST que wrappeás a mano (afip.js / @afipsdk, pyafipws, afip.ts) y otros servidores MCP. La diferencia del MCP es que es *agent-native*: el agente descubre y llama la tool sin que vos programes la integración.

Probarlo en 30 segundos (sin cuenta)

El endpoint público expone las tools puras (validación de CUIT/CBU, formato ARS, fechas WSFE, etc.) sin autenticación. Probalo desde una terminal — ojo con el header Accept, que el transporte MCP Streamable HTTP exige:

curl -sS https://tools.somosvelora.com/api/mcp/public \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": { "name": "validate_cuit", "arguments": { "cuit": "20-12345678-6" } }
  }'

Devuelve el resultado real de la tool (validez, dígito verificador, tipo de persona). Son 9 tools puras, sin credenciales.

Conectar el toolkit completo (con OAuth)

Para el toolkit completo (facturar, cobrar, catálogo, ventas) cada cliente se conecta así:

  • Cursor: botón *Add to Cursor* (deeplink cursor://anysphere.cursor-deeplink/mcp/install) o, en tu config MCP, un server remoto con { "url": "https://tools.somosvelora.com/api/mcp" }.
  • Claude / Claude Desktop: Settings → Connectors → Add custom connector, y pegás el endpoint https://tools.somosvelora.com/api/mcp.
  • ChatGPT: soporta servidores MCP remotos pero por ahora vía Developer Mode (beta, solo Plus/Pro) — lo agregás como app remota en Settings, no es tan directo como Claude/Cursor.
  • Cualquier cliente que soporte MCP HTTP remoto sirve.

Los clientes hosted corren un handshake OAuth 2.1 en la primera conexión: descubren el authorization server vía /.well-known/oauth-protected-resource (RFC 9728) y el usuario autoriza una vez — no hay clave que copiar. A partir de ahí el agente puede llamar las tools del negocio.