Conecta tu asistente de IA.

Tu servidor. Una URL MCP.

Incluido en merchant 5.0.0+. Sin daemon adicional, entorno Node.js ni relay alojado. Usa el dominio API configurado de la instalación, por ejemplo https://api.example.com/mcp.

1. Abre Ajustes → Acceso API. Crea una credencial dedicada y asigna los proyectos que necesita tu asistente. Empieza con solo lectura.
2. En Conexiones de IA · MCP, activa MCP. Selecciona tu credencial, elige Solo lectura y guarda.
3. Añade la URL mostrada a los ajustes HTTP/MCP remotos de tu asistente.
4. Para OAuth, accede a tu consola de comercio. Revisa el nombre del cliente, la dirección de retorno y los permisos de la credencial, y después aprueba. Siguen aplicándose tu Basic Auth y TOTP existentes.

{
  "mcpServers": {
    "whollycrypto": {
      "url": "https://api.example.com/mcp"
    }
  }
}

Sustituye el dominio de ejemplo. Los formatos de configuración varían por cliente; elige Streamable HTTP, no un comando local ni una URL SSE antigua.

Pregunta por tus pagos.

• «Muéstrame las últimas facturas sin pagar de mi tienda».
• «¿Qué activos puede aceptar esta tienda?».
• «Consulta los saldos de wallets y las entregas de webhooks fallidas».
• «Crea una factura de 25 EUR para el pedido 1042». Requiere permiso para crear facturas.

Ocho herramientas de lectura cubren proyectos, tiendas, métodos de pago, wallets, facturas, historial de entregas y conversiones en caché. Una novena herramienta opcional crea facturas con las reglas API existentes.

Los resultados incluyen IDs de proyecto y tienda. Los importes siguen siendo cadenas decimales. Los tipos de cambio y saldos en caché conservan sus datos de actualización; una conversión no es una cotización de factura garantizada.

Elige a qué puede acceder el asistente.

MCP está desactivado por defecto, también tras una actualización. Las claves API existentes no obtienen acceso automáticamente. El asistente solo ve los proyectos aprobados; las restricciones de IP y el límite REST de la credencial también se aplican a MCP.

Para crear facturas, selecciona una credencial de lectura/escritura y Leer y crear facturas. Los clientes OAuth deben solicitar mcp:invoice:create, y debes marcar Permitir también crear facturas durante la aprobación.

Reutiliza el mismo idempotency_key y el cuerpo de la factura tras agotar el tiempo de espera. Una clave nueva crea una factura nueva. Siguen aplicándose las reglas normales de margen, tolerancia, pago y crédito.

Sin exportación de claves ni herramientas de envío de dinero. MCP no puede revelar frases de recuperación, enviar fondos, hacer envíos automáticos, reembolsar, reenviar notificaciones ni cambiar cuentas, dominios o facturación.

Aprueba solo clientes que reconozcas. Los nombres de clientes no se verifican. Tu proveedor de IA recibe la información que autorizas a leer, incluidos datos de clientes devueltos por las herramientas de facturas.

Si falla una conexión.

• 404: activa MCP y usa el host API, no el de consola o pago.
• 401: vuelve a conectar con OAuth o comprueba que tu credencial bearer sea válida.
• 403: comprueba el acceso de la credencial, proyectos aprobados, origen y restricciones de IP de origen.
• 405 en GET: es lo esperado. Este endpoint sin estado usa POST y respuestas JSON finitas, sin un flujo SSE independiente.
• 429: espera lo indicado en Retry-After. MCP y REST comparten la cuota de la credencial.
• No puedes crear facturas: comprueba todos los permisos de escritura, el estado del proyecto y tienda, la disponibilidad para pagar y la verificación de la cuenta de créditos.

Mantén desactivados la caché y los desafíos interactivos de Cloudflare para /mcp, /mcp/oauth/* y las rutas de descubrimiento OAuth. Las listas de IP permitidas deben incluir las direcciones de salida documentadas del servicio del asistente.

Revisiones del protocolo compatibles: 2025-11-25, 2025-06-18 y 2025-03-26. El cliente debe admitir una de ellas. Consulta la Referencia de la API para ver cada herramienta, endpoint y formato de error.

Elige métodos de pago por factura.

Usa invoice.payment_methods con chain_slug: "ethereum" y asset_tickers: ["USDC", "USDT"]. Busca slugs y símbolos en Métodos de pago de la tienda o con list_payment_methods.

Merchant 5.4.0+ ignora las opciones inactivas o no aceptadas. Si ninguna coincide, se usan los valores de la tienda. Filtrar solo por red incluye todos los activos aceptados activos. Los símbolos compartidos requieren valores exactos de asset_ids. Siguen aplicándose las comprobaciones de disponibilidad y tipos de cambio, con errores específicos por red. Lightning va por separado; un array de selección vacío no es válido. Formato de solicitud →