Ya en ChatGPT y ClaudeConectar

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.

Chatfuel MCP
ToolQué hace
list_chatsLista los chats con clientes con su canal, estado y etapa del lead.
get_chatDevuelve los últimos mensajes de un chat con un cliente, con su canal, estado y etapa del lead.
send_chat_messageEnvía al cliente, en su chat, el texto que aprobaste y pasa el chat al chat en vivo.
return_chat_to_aiDevuelve 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_baseDevuelve aquello con lo que responde el Agente de IA: datos de la empresa, instrucciones, horario, FAQ, servicios y especialistas.
add_faqAñade preguntas y respuestas a las FAQ con las que responde el Agente de IA.
set_business_hoursReemplaza 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_replyEnvía un mensaje de cliente de prueba a un chat de pruebas y devuelve la respuesta del Agente de IA.
list_postsLista las publicaciones y reels recientes de la cuenta de Instagram y de la página de Facebook conectadas a tu bot.
setup_comment_repliesConfigura 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.
Square MCP
ToolQué hace
get_service_infoLista los métodos de un servicio de la API de Square, como bookings, payments o loyalty, y qué hace cada uno.
get_type_infoMuestra 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_requestEjecuta 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.

  1. Chatfuel MCP busca con list_chats los chats que esperan a tu equipo, y get_chat lee el servicio, el día y el teléfono que escribió.
  2. Con get_type_info, Square MCP devuelve los campos que pide cada llamada. Después, make_api_request encuentra su perfil por ese teléfono y lista los horarios libres de Peeling del sábado por la mañana.
  3. Eliges una hora, y make_api_request crea la cita en su perfil con el servicio, la especialista y tu local.
  4. send_chat_message le confirma la hora en su chat de Instagram cuando apruebas el texto, y return_chat_to_ai le 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ídele

Fernanda 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.

Chat de Instagram en Chatfuel: la clienta pide un Peeling el sábado y escribe su teléfono, y una compañera le confirma la hora agendada en Square

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.

  1. Square MCP lee con make_api_request tu 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.
  2. Chatfuel MCP revisa con get_knowledge_base qué cubren ya las FAQ, y add_faq suma dos respuestas: cambiar o cancelar una cita, y faltar a ella.
  3. set_business_hours le da al Agente de IA el mismo horario semanal que tiene tu local en Square, cuando lo confirmas.
  4. test_reply le 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ídele

Lee 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.

FAQ de Chatfuel con dos respuestas nuevas tomadas de Square: cambiar o cancelar una cita y el cargo por inasistencia

“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.

  1. Chatfuel MCP lista con list_chats los chats que esperan a tu equipo, y get_chat lee el monto, el día y los cuatro últimos dígitos que dio.
  2. Square MCP lista con make_api_request los 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.
  3. Revisas ambos, das tu visto bueno, y make_api_request reembolsa el segundo y consulta el estado del reembolso: pendiente o completado.
  4. send_chat_message le avisa que el cobro duplicado ya se devolvió y cuándo verá el dinero, en cuanto apruebas el texto. Luego return_chat_to_ai le 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ídele

Paola 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.

Chat de WhatsApp en Chatfuel: la clienta avisa de un cobro doble, y una compañera le confirma el reembolso de $59

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.

  1. get_service_info lista los métodos de fidelización de Square, y make_api_request lee tu programa: 1 punto por visita y 5 puntos para $20 de descuento en un tratamiento.
  2. make_api_request crea la promoción: multiplicador ×2 en el Facial hidratante del 1 al 14 de diciembre. Square la deja programada hasta el primer día.
  3. Chatfuel MCP encuentra la publicación con list_posts, y setup_comment_replies responde cada comentario con PUNTOS: una respuesta pública corta y un DM con las fechas, la recompensa y la invitación a agendar.
  4. add_faq pone 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ídele

En 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.

Respuestas a comentarios en Chatfuel: palabra clave PUNTOS, una respuesta pública y un DM sobre los puntos dobles en el Facial hidratante

Cómo conectar

  1. 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.

  2. 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.

  3. 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.

  1. Conecta Chatfuel desde el directorio de conectores de Claude y entra con tu cuenta.
  2. Busca Square en ese mismo directorio (hecho por Square, Inc.) y haz clic en Connect.
  3. 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.
Square MCP
Desde el directorio de Claude
Chatfuel MCP en Claude

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.

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.