Conecta Chatfuel MCP con Square MCP
Tu clínica lleva la agenda, los cobros con tarjeta y el programa de puntos en Square, y tus clientes escriben por WhatsApp e Instagram. El asistente agenda sus pedidos en Square Appointments, devuelve un cobro duplicado y lo avisa en el chat, y le enseña al Agente de IA las reglas de reserva y las promociones de puntos de Square.
Qué puede hacer la integración
Las tools que usa el asistente en cada lado, con el nombre que les da cada servidor.
| Tool | Qué hace |
|---|---|
list_chats | Lista los chats con clientes con su canal, estado y etapa del lead. |
get_chat | Devuelve los últimos mensajes de un chat con un cliente, con su canal, estado y etapa del lead. |
send_chat_message | Envía al cliente, en su chat, el texto que aprobaste y pasa el chat al chat en vivo. |
return_chat_to_ai | Devuelve al Agente de IA un chat que está en el chat en vivo, después de tu sí, y el Agente de IA responde el último mensaje del cliente. |
get_knowledge_base | Devuelve aquello con lo que responde el Agente de IA: datos de la empresa, instrucciones, horario, FAQ, servicios y especialistas. |
add_faq | Añade preguntas y respuestas a las FAQ con las que responde el Agente de IA. |
set_business_hours | Reemplaza el horario semanal que el Agente de IA da a los clientes, después de que lo confirmes. Los días que no indiques quedan cerrados. |
test_reply | Envía un mensaje de cliente de prueba a un chat de pruebas y devuelve la respuesta del Agente de IA. |
list_posts | Lista las publicaciones y reels recientes de la cuenta de Instagram y de la página de Facebook conectadas a tu bot. |
setup_comment_replies | Configura respuestas con IA o fijas a los comentarios, a todos o por palabra clave; en Instagram y Facebook, también un DM y la elección de publicaciones. |
| Tool | Qué hace |
|---|---|
get_service_info | Lista los métodos de un servicio de la API de Square, como bookings, payments o loyalty, y qué hace cada uno. |
get_type_info | Muestra los campos que espera un método de la API de Square, para que el asistente arme una solicitud válida antes de llamarlo. |
make_api_request | Ejecuta un método de la API de Square: lee o cambia clientes, citas, pagos, reembolsos, ubicaciones, fidelización y el resto de la API. |
Qué pedirle al asistente
Pedido de cita en el chat → una cita en Square Appointments
CuándoUna clienta que ya vino antes pide por Instagram un Peeling para este sábado por la mañana y escribe su teléfono. Tu agenda está en Square Appointments, así que el Agente de IA le pasa el chat a tu equipo en lugar de agendar en Chatfuel.
- Chatfuel MCP busca con
list_chatslos chats que esperan a tu equipo, yget_chatlee el servicio, el día y el teléfono que escribió. - Con
get_type_info, Square MCP devuelve los campos que pide cada llamada. Después,make_api_requestencuentra su perfil por ese teléfono y lista los horarios libres de Peeling del sábado por la mañana. - Eliges una hora, y
make_api_requestcrea la cita en su perfil con el servicio, la especialista y tu local. send_chat_messagele confirma la hora en su chat de Instagram cuando apruebas el texto, yreturn_chat_to_aile devuelve el chat al Agente de IA con otro sí tuyo.
ResultadoLa visita queda en la agenda de Square junto a tus demás citas, y la clienta recibe la hora en el mismo chat desde donde escribió. Si ningún perfil tiene su número, el asistente te lo dice y te pregunta antes de crear uno.
PídeleFernanda Salas pidió por Instagram un Peeling para este sábado por la mañana y escribió su teléfono. Búscala en Square, muéstrame los horarios libres del sábado por la mañana, agenda el que yo elija y prepárame una confirmación para su chat.

Reglas de cancelación y horario en Square → lo que el Agente de IA les dice a los clientes
CuándoEn los chats te preguntan una y otra vez hasta cuándo pueden cambiar una cita y qué pasa si faltan. Esas respuestas ya están en la configuración de Square Appointments.
- Square MCP lee con
make_api_requesttu perfil de reservas: el plazo de 24 horas para cancelar o reprogramar, el cargo de $20 por inasistencia y el texto de tu política. También lee el horario semanal de tu local. - Chatfuel MCP revisa con
get_knowledge_basequé cubren ya las FAQ, yadd_faqsuma dos respuestas: cambiar o cancelar una cita, y faltar a ella. set_business_hoursle da al Agente de IA el mismo horario semanal que tiene tu local en Square, cuando lo confirmas.test_replyle pregunta al Agente de IA en un chat de pruebas si la cita de mañana temprano todavía se puede mover.
ResultadoLo que se responde en el chat coincide con Square: el mismo plazo, el mismo cargo y el mismo horario. Si cambias la política en Square, el Agente de IA sigue con la respuesta anterior hasta que le pides al asistente que la actualice.
PídeleLee de Square Appointments nuestro plazo de cancelación, el cargo por inasistencia y el horario. Agrega a las FAQ respuestas sobre cambiar, cancelar y faltar a una cita, ponle al Agente de IA el mismo horario y prueba qué dice si alguien quiere mover la cita de mañana.

“Me cobraron dos veces” en el chat → el cobro duplicado, reembolsado en Square
CuándoUna clienta escribe por WhatsApp que en recepción le cobraron dos veces el Facial hidratante de hoy: $59 dos veces, con la tarjeta terminada en 4821. El Agente de IA le pasa el chat a tu equipo.
- Chatfuel MCP lista con
list_chatslos chats que esperan a tu equipo, yget_chatlee el monto, el día y los cuatro últimos dígitos que dio. - Square MCP lista con
make_api_requestlos pagos de hoy, filtrados por el total de $59 y los últimos dígitos de la tarjeta, y encuentra dos pagos completados con un minuto de diferencia. - Revisas ambos, das tu visto bueno, y
make_api_requestreembolsa el segundo y consulta el estado del reembolso: pendiente o completado. send_chat_messagele avisa que el cobro duplicado ya se devolvió y cuándo verá el dinero, en cuanto apruebas el texto. Luegoreturn_chat_to_aile devuelve el chat al Agente de IA.
ResultadoLa clienta recibe el reembolso confirmado en el mismo chat, sin esperar una llamada al día siguiente. Square completa la mayoría de los reembolsos en pocas horas, y su banco puede tardar de 7 a 10 días hábiles en mostrarlo.
PídelePaola Serrano dice por WhatsApp que hoy le cobraron $59 dos veces con su tarjeta terminada en 4821. Busca los dos pagos en Square, reembolsa el duplicado cuando yo lo confirme y prepárame una respuesta que le diga cuándo le vuelve el dinero.

Puntos dobles en Square Loyalty → un DM por cada comentario con PUNTOS
CuándoDel 1 al 14 de diciembre, cada Facial hidratante suma el doble de Puntos Nuvia. Lo anuncias en una publicación de Instagram y quieres que quien comente reciba los detalles por DM.
get_service_infolista los métodos de fidelización de Square, ymake_api_requestlee tu programa: 1 punto por visita y 5 puntos para $20 de descuento en un tratamiento.make_api_requestcrea la promoción: multiplicador ×2 en el Facial hidratante del 1 al 14 de diciembre. Square la deja programada hasta el primer día.- Chatfuel MCP encuentra la publicación con
list_posts, ysetup_comment_repliesresponde cada comentario con PUNTOS: una respuesta pública corta y un DM con las fechas, la recompensa y la invitación a agendar. add_faqpone la promoción en las FAQ, para que el Agente de IA conteste las dudas que lleguen por DM.
ResultadoCada persona que comenta recibe la oferta por DM, y quienes están en el programa suman los puntos extra al pagar mientras la promoción está activa. Square asocia los puntos al teléfono de la clienta. En TikTok un comentario no puede recibir DM, así que la respuesta pública invita a escribir primero.
PídeleEn Square Loyalty, duplica los puntos del Facial hidratante del 1 al 14 de diciembre. Luego configura respuestas en nuestra última publicación de Instagram: los comentarios con PUNTOS reciben un DM con las fechas y la recompensa. Agrega también la promoción a nuestras FAQ.

Cómo conectar
Añade Chatfuel MCP
Conecta Chatfuel desde el directorio de Claude o de ChatGPT, o dale a Cursor la dirección https://mcp.chatfuel.com/panel, y entra con tu cuenta de Chatfuel.
Añade Square MCP
Claude tiene Square en su directorio. ChatGPT lo agrega como servidor MCP propio con https://mcp.squareup.com/mcp, y Cursor llega a él con npx mcp-remote. Entra en Square como dueño de la cuenta o con un usuario del equipo con permisos completos.
Pide todo en una conversación
Square MCP tiene tres tools generales, así que antes de cada llamada el asistente busca el método y sus campos. Chatfuel te pide un sí antes de cambiar el bot o escribirle a un cliente.
- Conecta Chatfuel desde el directorio de conectores de Claude y entra con tu cuenta.
- Busca Square en ese mismo directorio (hecho por Square, Inc.) y haz clic en Connect.
- Entra en Square en la página que se abre y autoriza el acceso. Después activa las tools de Square que necesites en el menú de herramientas del chat, como indica la guía de Square.
- Chatfuel MCP
- claude.ai/directory/chatfuel
- Square MCP
- Desde el directorio de Claude
- Agrega el plugin de Chatfuel desde el directorio de ChatGPT y entra con tu cuenta.
- ChatGPT todavía no tiene un plugin de Square para los datos del negocio. Con el developer mode activo, abre Plugins › + › Add custom MCP server, escribe https://mcp.squareup.com/mcp y elige OAuth.
- Entra en Square en la ventana que aparece. La guía de Square no cubre ChatGPT, pero su equipo confirmó en el foro de desarrolladores que ChatGPT está en la lista de clientes permitidos.
- Chatfuel MCP
- chatgpt.com/plugins
- Square MCP
https://mcp.squareup.com/mcp
- Agrega Chatfuel a ~/.cursor/mcp.json con la dirección https://mcp.chatfuel.com/panel.
- La guía de Square suma su servidor a Cursor como comando: npx mcp-remote https://mcp.squareup.com/mcp. Necesita Node.js y corre en tu computadora un pequeño puente hacia el servidor alojado de Square.
- Entra en Square en la pestaña del navegador que se abre. Si quieres probar primero con datos de Sandbox, usa en su lugar npx square-mcp-server start con SANDBOX=true y un access token de Sandbox.
- Chatfuel MCP
https://mcp.chatfuel.com/panel- Square MCP, en tu computadora
npx mcp-remote https://mcp.squareup.com/mcp
Qué necesitas
- Un bot de Chatfuel con un canal conectado. El caso de los puntos dobles también necesita una cuenta de Instagram o una página de Facebook, desde donde salen los DM de los comentarios.
- Una cuenta de Square en un país donde Square acepta pagos con tarjeta: Estados Unidos, Canadá, Reino Unido, Irlanda, Francia, España, Australia o Japón. Inicia sesión el dueño o alguien del equipo con permisos completos.
- Square Appointments Plus o Premium para crear, mover o cancelar citas por la API; con el plan gratuito, el asistente solo las lee. Para los puntos, Square Loyalty con un programa creado en el Square Dashboard.
- Claude, que tiene Square en su directorio de conectores; ChatGPT con developer mode para servidores MCP propios; o Cursor con Node.js instalado.
Límites
- Square marca su servidor MCP como Beta y recibe comentarios y reportes de errores como issues de GitHub en square/square-mcp-server.
- El servidor alojado solo trabaja con datos reales. Square sugiere probar los prompts antes en un Sandbox, y para eso hace falta el servidor local con un access token de Sandbox.
- La reserva de Chatfuel y Square Appointments usan agendas separadas, y nada las sincroniza. Aquí el asistente agenda en Square cuando se lo pides; las citas que el Agente de IA crea en Chatfuel se quedan en Chatfuel.
- Con acceso de vendedor, el asistente podría duplicar una cita o agendar fuera de tu horario, por eso primero revisa los horarios libres de Square. Sin Plus o Premium, Square rechaza cualquier cambio de cita con un 403.
- Square busca clientes por teléfono o email, no por nombre, y Chatfuel MCP no comparte ninguno de los dos. La clienta tiene que escribir uno en el chat; en sentido contrario, list_chats puede buscar el teléfono de un perfil de Square.
- Square no documenta un paso de aprobación propio para escrituras como los reembolsos, así que deja activa la aprobación de tools en tu asistente. Solo se reembolsan pagos completados de hasta un año, con un máximo de 20 reembolsos por pago.
- Una respuesta a un cliente sale solo cuando apruebas su redacción y dentro del plazo: 24 horas desde su último mensaje de WhatsApp, 7 días en Instagram y Messenger.
- Square solo acepta clientes MCP de su lista de permitidos. Un asistente que no está en ella no puede iniciar sesión hasta que Square lo agrega tras una solicitud en su foro de desarrolladores.
Preguntas frecuentes
Sí, las dos cosas. Block aloja el servidor en https://mcp.squareup.com/mcp, y la guía de Square en developer.squareup.com/docs/mcp lo llama Beta. El código de la versión local está en GitHub como square/square-mcp-server. Square no lo publicó en el MCP Registry.
No. La reserva de Chatfuel escribe en la agenda propia de Chatfuel, y Chatfuel MCP no la sincroniza con Square. Si tu agenda es Square, haz que el Agente de IA le pase los pedidos de cita a tu equipo y pídele al asistente que los agende en Square.
Leer citas y la configuración de reservas funciona con el plan gratuito de Appointments. Crear, mover o cancelar una cita requiere Appointments Plus o Premium. La promoción de puntos dobles necesita una suscripción a Square Loyalty.
Con el servidor alojado no, porque solo llega a producción. Usa el servidor local: npx square-mcp-server start con un access token de Sandbox y SANDBOX=true. Con DISALLOW_WRITES=true queda en solo lectura.
Sí, como servidor MCP propio en developer mode, con https://mcp.squareup.com/mcp. Square todavía no tiene un plugin de ChatGPT para los datos del negocio. La app de ChatGPT que Square anunció en julio de 2026 es otra cosa: sirve para pedir comida a restaurantes de EE. UU.
Por teléfono o email. Square busca en su Customer Directory por teléfono o email, exacto o aproximado, así que la clienta escribe uno en el chat. Al revés, list_chats encuentra un chat por el teléfono guardado en un perfil de Square.
Más integraciones
Conecta Chatfuel MCP
Empieza la prueba gratis, añade Chatfuel a tu asistente y pregúntale por Square y tus chats en un solo lugar.

