Integración · Pagos

Conectar Claude y ChatGPT a BTCPay Server

Pregunte a su IA sobre las facturas, pagos y retiros en su propio servidor BTCPay. Puede buscar una factura por ID de pedido, mostrar lo pagado por método y crear nuevas facturas y solicitudes de pago. También puede leer el saldo y transacciones de su billetera on-chain, ver ventas desde sus aplicaciones de punto de venta y crear devoluciones con su aprobación.

Conecta BTCPay Server gratis

Plan gratuito, sin tarjeta de crédito. Solo lleva un minuto aproximadamente.

Prueba a pedirle

“¿Ha sido pagada la factura para el pedido 1087?”
La IA busca facturas por ID de pedido, lee el estado y muestra los pagos recibidos por método.
“Crear una factura de 250 EUR para [email protected], pedido 1102.”
Crea la factura con monto, moneda e ID de pedido y correo del comprador en los metadatos.
“Hacer una solicitud de pago para el retainer de consultoría de marzo.”
Crea una página de solicitud de pago con título, monto, moneda y una fecha de caducidad opcional.

Qué puede hacer tu IA

Facturas y solicitudes de pago

Buscar, crear y leer facturas, ver pagos por método, actualizar metadatos y crear o actualizar solicitudes de pago.

Devoluciones y retiros

Crear devoluciones para facturas pagadas y listar retiros y pagos con su monto, destino y estado.

Tiendas, billetera y aplicaciones

Leer configuraciones de tienda, métodos de pago, tipos de cambio, saldo y transacciones on-chain, y ventas desde sus aplicaciones.

“¿Qué facturas expiraron la semana pasada?”
Busca facturas con estado Expirado en el rango de fechas y las lista.
“¿Cuál es el saldo de la billetera on-chain y qué ha entrado recientemente?”
Encuentra el método de pago, lee el saldo de la billetera y lista transacciones recientes.
“Devolver factura 7Hk2 al tipo que pagó el cliente.”
Crea una devolución con la opción RateThen. El cliente reclama desde un enlace y el dinero sale de su billetera.

197 herramientas para BTCPay Server

Estas herramientas se activan al conectar la aplicación. Puedes desactivar cualquiera de ellas o exigir tu aprobación antes de que se ejecute.

approve_userVisible para otros
archive_a_pull_paymentElimina datos
archive_invoiceElimina datosArchiva una factura mediante `invoice_id` para que esté oculta de la lista de facturas.
create_a_new_pull_paymentModifica datos
create_api_keyModifica datos
create_app_imageModifica datos
create_broadcastVisible para otros
create_crowdfundModifica datos
create_delivery_redeliverElimina datos
create_documentModifica datos
create_generateModifica datos
create_invoiceModifica datosCrea una factura para que un cliente pague, con `amount` y `currency` (por defecto de la tienda si está vacío). Pon detalles como orderId o buyerEmail en `metadata`. Deja `amount` vacío para una factura de recarga.
create_lightning_addressModifica datos
create_lightning_channelModifica datos
create_lightning_channel_store_lightning_node_api_open_channelModifica datos
create_lightning_connectModifica datos
create_lightning_connect_store_lightning_node_api_connect_to_nodModifica datos
create_lightning_invoiceModifica datos
create_lightning_invoice_store_lightning_node_api_create_invoiceModifica datos
create_messageModifica datos
create_message_logoModifica datos
create_message_offeringModifica datos
create_message_payoutMueve dinero
create_message_userModifica datos
create_message_webhookElimina datos
create_objectModifica datos
create_object_linkModifica datos
create_offering_planModifica datos
create_paymentModifica datos
create_payment_boltcardModifica datos
create_payment_payoutMueve dinero
create_payment_requestModifica datosCrea una página de solicitud de pago con `title`, `amount`, `currency`, opcional `description`, `email`, `expiry_date` y `reference_id`.
create_payout_markMueve dinero
create_plan_checkoutModifica datos
create_poModifica datos
create_subscriber_portalModifica datos
create_subscriber_suspendModifica datos
create_subscriber_unsuspendModifica datos
create_userModifica datos
create_user_api_keyVisible para otros
create_user_invitationVisible para otros
create_user_users_create_userModifica datos
delete_addressesMueve dinero
delete_api_keyElimina datos
delete_appElimina datos
delete_app_imageElimina datos
delete_currentsMueve dinero
delete_documentElimina datos
delete_linkElimina datos
delete_messageElimina datos
delete_message_addressElimina datos
delete_message_logosMueve dinero
delete_message_paymentElimina datos
delete_message_payout_processorMueve dinero
delete_message_userElimina datos
delete_notificationElimina datos
delete_objectElimina datos
delete_offering_subscriberElimina datos
delete_paymentElimina datos
delete_payoutMueve dinero
delete_userElimina datos
delete_user_api_keyElimina datos
delete_user_invitationsMueve dinero
delete_usersMueve dinero
delete_users_users_delete_current_user_profile_pictureMueve dinero
delete_webhookElimina datos
get_all_users
get_appObtén una aplicación mediante `app_id`.
get_app_salesObtén estadísticas de ventas para una aplicación mediante `app_id` durante el último `number_of_days`.
get_app_top_itemsObtén los artículos mejor vendidos de una aplicación mediante `app_id`.
get_channels
get_configuration
get_crowdfund
get_current_userObtenga al usuario BTCPay Server con el que está conectado.
get_deposit_addressModifica datos
get_document
get_exchange_ratesObtenga las tasas de cambio actuales de la tienda, opcionalmente para valores específicos de `currency_pair` como BTC_USD.
get_i
get_invoiceObtén una factura mediante `invoice_id`, con monto, moneda, estado y metadatos.
get_invoice_paymentsObtén los métodos de pago y pagos recibidos para una factura mediante `invoice_id`, incluyendo montos pagados y pendientes por método.
get_invoice_refund
get_invoices
get_lightning_automated_payout_sender_factory
get_lightning_invoice
get_lightning_invoice_store_lightning_node_api_get_invoice
get_lightning_payment
get_message_address
get_message_offering
get_message_payment
get_node_balance
get_node_balance_histogram
get_node_information
get_notification
get_object
get_offering_plan
get_offering_subscriber
get_on_chain_automated_payout_sender_factory
get_payment
get_payment_payout
get_payment_preview
get_payment_requestObtén una solicitud de pago mediante `payment_id`, con su monto, estado y descripción.
get_payments
get_payoutObtén un pago mediante `payout_id`, con monto, destino y estado.
get_plan_checkout
get_po
get_pull_payment
get_storeObtén la configuración de una tienda mediante su ID de tienda (`message_id`).
get_store_email_settingsVisible para otros
get_store_on_chain_wallet_transaction
get_subscriber_credit
get_subscriber_portal
get_user
get_wallet_overviewObtenga el saldo en cadena para una `payment_method_id` (vea list_payment_methods).
get_webhook
get_webhook_shipment
list_addresses
list_appsLista las aplicaciones de la tienda, como páginas de punto de venta o crowdfunding.
list_apps_2
list_currents
list_delivery_requests
list_documents
list_feerates
list_histograms
list_infos
list_invitations
list_langs
list_lightning_automated_payout_sender_factories
list_lightning_balances
list_lightning_channels
list_lightning_histograms
list_lightning_infos
list_lightning_invoices
list_lightning_payments
list_message_addresses
list_message_offerings
list_message_roles
list_message_users
list_message_webhooks
list_notification_settings
list_notificationsListea las notificaciones de BTCPay, opcionalmente solo las no leídas con `seen` = false.
list_objects
list_on_chain_automated_transfer_sender_factories
list_payment_lnurls
list_payment_methodsLista los métodos de pago habilitados en la tienda (por ejemplo BTC o Lightning on-chain) y sus IDs.
list_payment_payouts
list_payment_requestsListea las solicitudes de pago de la tienda (páginas de pago a largo plazo).
list_payoutsListea los pagos de la tienda (incluidos los reembolsos pendientes), opcionalmente con `include_cancelled`.
list_permissions
list_pull_paymentsLista los pagos de retiro de la tienda (enlaces de reembolso y pago), opcionalmente con `include_archived`.
list_rate_sources
list_roles
list_storesListea las tiendas a las que puede acceder, junto con sus IDs y moneda predeterminada.
list_utxos
list_wallet_transactionsListea las transacciones de billetera en cadena para una `payment_method_id`, filtradas por `status_filter` o `label_filter`.
list_webhook_shipments
mark_invoice_statusModifica datosMarca manualmente una factura mediante `invoice_id` como pagada o inválida con `status`. Úsalo solo cuando un pago se maneje fuera de BTCPay.
patch_store_on_chain_wallet_transaction_infoModifica datos
pay_invoiceMueve dinero
pay_invoice_payMueve dinero
pay_message_processorsMueve dinero
pay_paymentMueve dinero
pay_processorMueve dinero
refund_invoiceMueve dineroCree un reembolso para una factura pagada por `invoice_id`. `refund_variant` establece la cantidad: RateThen (cripto a la tasa pagada), CurrentRate, Fiat, OverpaidAmount o Custom (con `custom_amount` y `custom_currency`). El cliente reclama el reembolso desde un enlace; esto mueve dinero.
restore_invoiceModifica datos
search_invoicesBusque las facturas de la tienda por `text_search`, `status` (Nueva, En proceso, Resuelta, Expirada, Inválida), `order_id` o rango de fechas (`start_date`/`end_date` como timestamps Unix). Use esto para encontrar un ID de factura.
send_an_email_for_a_storeVisible para otros
send_messageVisible para otros
submit_configurationVisible para otros
submit_invoiceVisible para otros
submit_paymentVisible para otros
submit_payoutMueve dinero
submit_userVisible para otros
update_configurationModifica datos
update_crowdfundModifica datos
update_invoice_metadataModifica datosReemplace el `metadata` de una factura por `invoice_id`, ej. ID de pedido o detalles del comprador.
update_lightning_automated_payout_sender_factoryMueve dinero
update_messageModifica datos
update_message_addressModifica datos
update_message_offeringModifica datos
update_message_paymentModifica datos
update_message_userVisible para otros
update_message_usersVisible para otros
update_notificationModifica datos
update_notification_settingsVisible para otros
update_offering_planModifica datos
update_on_chain_automated_payout_sender_factoryMueve dinero
update_on_chain_automated_transfer_sender_factoriesMueve dinero
update_payment_requestModifica datosActualice una solicitud de pago por `payment_id`, ej. `title`, `amount`, `description` o `expiry_date`.
update_payoutMueve dinero
update_plan_checkoutModifica datos
update_poModifica datos
update_server_email_settingsElimina datos
update_store_email_settingsVisible para otros
update_subscriber_creditModifica datos
update_subscriber_datesVisible para otros
update_usersVisible para otros
update_webhookElimina datos

Configúralo en tres pasos

1
Elige la aplicación
Crea una cuenta gratuita de PipMCP y elige BTCPay Server en la lista de aplicaciones.
2
Pega tu clave
Pegue su dirección BTCPay Server (por ejemplo https://btcpay.example.com), una clave API e ID de Tienda. En BTCPay Server, vaya a Cuenta > Administrar cuenta > Claves API, haga clic en Generar clave, marque solo las permisos necesarios (por ejemplo ver y crear facturas, ver tiendas) y copie la clave.
3
Añade el enlace a tu IA
Recibirás un enlace MCP personal. Añádelo a Claude, ChatGPT o Cursor:
1. Haz clic en tu nombre y luego en Configuración › Conectores › Añadir conector personalizado.
2. Pega tu enlace como URL del servidor MCP remoto.
3. Actívalo desde el menú + de un chat.

Preguntas frecuentes

¿Qué puede hacer la IA en BTCPay Server?

Puede buscar y leer facturas y sus pagos, solicitudes de pago, retiros, pagos automáticos, tiendas, métodos de pago, tipos de cambio, aplicaciones y sus ventas, notificaciones y transacciones on-chain. Puede crear facturas y solicitudes de pago, actualizar metadatos de factura y solicitudes de pago, marcar o archivar facturas y crear devoluciones.

¿Vé la clave API de mi servidor BTCPay?

No. Introduces tu clave API de BTCPay Server en PipMCP una sola vez. Se cifra en reposo, nunca se muestra a la IA ni vuelve a mostrarse después de guardarla, ni siquiera para ti. La IA solo ve los resultados de las herramientas que invoca.

¿Puedo controlar qué puede hacer la IA?

Sí. Tú eliges qué herramientas están activas, por lo que puedes empezar en modo solo lectura. Crear un reembolso mueve dinero y marcar una factura como pagada o inválida cambia su estado manualmente. Ambas pueden requerir tu aprobación antes de ejecutarse. Cada llamada a herramienta se registra.

¿Funciona con ChatGPT?

Sí. En ChatGPT, abre Configuración › Aplicaciones y conectores › Avanzado, activa Modo desarrollador y añade tu enlace PipMCP. Modo desarrollador requiere un plan de pago de ChatGPT: Plus, Pro, Business o Enterprise. El mismo enlace también funciona en Claude (Configuración › Conectores › Añadir conector personalizado), Cursor y otros clientes MCP.

¿Cuánto cuesta?

PipMCP tiene un plan gratuito y no necesitas tarjeta de crédito para empezar. Los planes de pago se facturan por tarea completada. Conectas tu propia cuenta de BTCPay Server en tu propio servidor, y PipMCP se conecta a él con la clave API que le das.

¿Funciona con mi propio BTCPay Server?

Sí. Introduces la dirección de tu propio servidor junto con la clave API e ID de tienda, y PipMCP llama a ese servidor. Las permisos que marcas al generar la clave limitan lo que la clave puede hacer, además de las herramientas que activas en PipMCP.