Conecte o Chatfuel MCP ao Square MCP
A agenda, os pagamentos com cartão e o programa de pontos da sua clínica ficam na Square, e os clientes escrevem pelo WhatsApp e pelo Instagram. O assistente agenda os pedidos deles no Square Appointments, estorna uma cobrança em dobro e avisa na conversa, e ensina ao Agente de IA as regras de agendamento e as promoções de pontos da Square.
O que a integração faz
As tools que o assistente usa em cada lado, com os nomes que cada servidor dá a elas.
| Tool | O que faz |
|---|---|
list_chats | Lista as conversas com clientes com canal, status e etapa do lead. |
get_chat | Mostra as últimas mensagens de uma conversa com um cliente, com canal, status e etapa do lead. |
send_chat_message | Envia ao cliente, na conversa dele, o texto que você aprovou e passa a conversa para o chat ao vivo. |
return_chat_to_ai | Devolve ao Agente de IA uma conversa que está no chat ao vivo, depois do seu sim, e o Agente de IA responde a última mensagem do cliente. |
get_knowledge_base | Mostra o que o Agente de IA usa para responder: dados da empresa, instruções, horário de atendimento, FAQ, serviços e profissionais. |
add_faq | Adiciona perguntas e respostas ao FAQ que o Agente de IA usa para responder. |
set_business_hours | Substitui o horário semanal que o Agente de IA informa aos clientes, depois da sua confirmação. Os dias que ficarem de fora ficam fechados. |
test_reply | Envia uma mensagem de cliente de teste para uma conversa de teste e devolve a resposta do Agente de IA. |
list_posts | Lista os posts e reels recentes da conta do Instagram e da página do Facebook conectadas ao seu bot. |
setup_comment_replies | Configura respostas com IA ou fixas aos comentários, a todos ou por palavra-chave; no Instagram e no Facebook, também uma DM e a escolha dos posts. |
| Tool | O que faz |
|---|---|
get_service_info | Lista os métodos de um serviço da API da Square, como bookings, payments ou loyalty, e o que cada um faz. |
get_type_info | Mostra os campos que um método da API da Square espera, para o assistente montar uma requisição válida antes de chamá-lo. |
make_api_request | Executa um método da API da Square: lê ou altera clientes, agendamentos, pagamentos, reembolsos, locais, fidelidade e o resto da API. |
O que pedir ao assistente
Pedido de horário na conversa → um agendamento no Square Appointments
QuandoUma cliente que já foi à clínica pede pelo Instagram um Peeling neste sábado de manhã e digita o telefone. A sua agenda fica no Square Appointments, então o Agente de IA passa a conversa para a equipe em vez de agendar no Chatfuel.
- O Chatfuel MCP encontra com
list_chatsas conversas que esperam a equipe, eget_chatlê o serviço, o dia e o telefone que ela digitou. - Com
get_type_info, o Square MCP devolve os campos de cada chamada. Depois,make_api_requestacha o perfil dela por esse telefone e lista os horários livres de Peeling no sábado de manhã. - Você escolhe um horário, e
make_api_requestcria o agendamento no perfil dela com o serviço, a profissional e a sua unidade. send_chat_messageconfirma o horário na conversa do Instagram depois do seu sim ao texto, ereturn_chat_to_aidevolve a conversa ao Agente de IA com mais um sim.
ResultadoA visita aparece na agenda da Square junto com os outros atendimentos, e a cliente recebe o horário na mesma conversa em que escreveu. Se nenhum perfil tiver o número dela, o assistente avisa e pergunta antes de criar um.
PeçaA Júlia Siqueira pediu pelo Instagram um Peeling neste sábado de manhã e digitou o telefone. Encontre ela na Square, me mostre os horários livres de sábado de manhã, agende o que eu escolher e escreva uma confirmação para a conversa dela.

Regras de cancelamento e horário na Square → o que o Agente de IA responde
QuandoNas conversas, os clientes perguntam sempre até quando dá para remarcar e o que acontece se faltarem. As respostas já estão nas configurações do Square Appointments.
- O Square MCP lê com
make_api_requesto seu perfil de agendamentos: o prazo de 24 horas para cancelar ou remarcar, a taxa de R$ 60 por falta e o texto da política. Também lê o horário semanal da unidade. - O Chatfuel MCP confere com
get_knowledge_baseo que o FAQ já cobre, eadd_faqinclui duas respostas: remarcar ou cancelar um horário, e faltar a ele. set_business_hourspassa ao Agente de IA o mesmo horário semanal da unidade na Square, depois da sua confirmação.test_replypergunta ao Agente de IA numa conversa de teste se o horário de amanhã cedo ainda pode ser remarcado.
ResultadoAs respostas na conversa batem com a Square: o mesmo prazo, a mesma taxa, o mesmo horário. Se você mudar a política na Square, o Agente de IA continua com a resposta antiga até você pedir ao assistente para atualizá-la.
PeçaLeia no Square Appointments o nosso prazo de cancelamento, a taxa por falta e o horário de funcionamento. Inclua no FAQ respostas sobre remarcar, cancelar e faltar, passe o mesmo horário ao Agente de IA e teste o que ele diz sobre remarcar o horário de amanhã.

“Fui cobrada duas vezes” na conversa → a cobrança duplicada estornada na Square
QuandoUma cliente escreve pelo WhatsApp que a recepção cobrou duas vezes a Hidratação facial de hoje no cartão: R$ 180 duas vezes, cartão final 4821. O Agente de IA passa a conversa para a equipe.
- O Chatfuel MCP lista com
list_chatsas conversas que esperam a equipe, eget_chatlê o valor, o dia e os quatro últimos dígitos que ela informou. - O Square MCP lista com
make_api_requestos pagamentos de hoje, filtrados pelo total de R$ 180 e pelo final do cartão, e encontra dois pagamentos concluídos com um minuto de diferença. - Você confere os dois e aprova, e
make_api_requestestorna o segundo e consulta o status do estorno: pendente ou concluído. send_chat_messageavisa que a cobrança duplicada foi estornada e quando o dinheiro aparece, assim que você aprova o texto. Depois,return_chat_to_aidevolve a conversa ao Agente de IA.
ResultadoA cliente recebe o estorno confirmado na mesma conversa, sem esperar uma ligação no dia seguinte. A Square conclui a maioria dos estornos em poucas horas, e o banco dela pode levar de 7 a 10 dias úteis para mostrar o valor.
PeçaA Bianca Sampaio disse no WhatsApp que hoje foi cobrada duas vezes em R$ 180 no cartão final 4821. Encontre os dois pagamentos na Square, estorne o duplicado quando eu confirmar e escreva uma resposta dizendo quando o dinheiro volta.

Pontos em dobro no Square Loyalty → uma DM para cada comentário com PONTOS
QuandoDe 1 a 14 de dezembro, cada Hidratação facial vale o dobro de Pontos Nuvia. Você anuncia num post do Instagram e quer que cada pessoa que comentar receba os detalhes por DM.
get_service_infolista os métodos de fidelidade da Square, emake_api_requestlê o seu programa: 1 ponto por visita e 5 pontos para R$ 60 de desconto num procedimento.make_api_requestcria a promoção: multiplicador de 2× na Hidratação facial de 1 a 14 de dezembro. A Square deixa a promoção agendada até o primeiro dia.- O Chatfuel MCP encontra o post com
list_posts, esetup_comment_repliesresponde a cada comentário com PONTOS: uma resposta pública curta e uma DM com as datas, a recompensa e o convite para agendar. add_faqcoloca a promoção no FAQ, para o Agente de IA responder às dúvidas que chegarem na DM.
ResultadoCada pessoa que comenta recebe a oferta por DM, e quem participa do programa ganha os pontos extras no pagamento enquanto a promoção está ativa. A Square vincula os pontos ao telefone da cliente. No TikTok o comentário não recebe DM, então a resposta pública convida a pessoa a escrever primeiro.
PeçaNo Square Loyalty, dobre os pontos da Hidratação facial de 1 a 14 de dezembro. Depois configure respostas no nosso último post do Instagram: comentários com PONTOS recebem uma DM com as datas e a recompensa. Coloque a promoção no nosso FAQ também.

Como conectar
Adicione o Chatfuel MCP
Conecte o Chatfuel pelo diretório do Claude ou do ChatGPT, ou passe ao Cursor o endereço https://mcp.chatfuel.com/panel, e entre com a sua conta do Chatfuel.
Adicione o Square MCP
O Claude tem a Square no diretório. O ChatGPT recebe https://mcp.squareup.com/mcp como servidor MCP próprio, e o Cursor chega lá pelo npx mcp-remote. Entre na Square como dono da conta ou com um membro da equipe com permissão total.
Peça tudo numa conversa
O Square MCP tem três tools genéricas, então o assistente consulta o método e os campos antes de cada chamada. O Chatfuel pede o seu sim antes de mudar o bot ou escrever para um cliente.
- Conecte o Chatfuel pelo diretório de conectores do Claude e entre na sua conta.
- No mesmo diretório, procure a Square (feito pela Square, Inc.) e clique em Connect.
- Entre na Square na página que abrir e autorize o acesso. Depois ative as tools da Square que precisar no menu de ferramentas da conversa, como mostra o guia da Square.
- Chatfuel MCP
- claude.ai/directory/chatfuel
- Square MCP
- Pelo diretório do Claude
- Adicione o plugin do Chatfuel pelo diretório do ChatGPT e entre na sua conta.
- O ChatGPT ainda não tem um plugin da Square para os dados do negócio. Com o developer mode ligado, abra Plugins › + › Add custom MCP server, digite https://mcp.squareup.com/mcp e escolha OAuth.
- Entre na Square na janela que abrir. O guia da Square não fala do ChatGPT, mas a equipe da Square confirmou no fórum de desenvolvedores que o ChatGPT está na lista de clientes liberados.
- Chatfuel MCP
- chatgpt.com/plugins
- Square MCP
https://mcp.squareup.com/mcp
- Adicione o Chatfuel ao ~/.cursor/mcp.json com o endereço https://mcp.chatfuel.com/panel.
- O guia da Square adiciona o servidor ao Cursor como comando: npx mcp-remote https://mcp.squareup.com/mcp. Ele precisa do Node.js e roda no seu computador uma pequena ponte até o servidor hospedado da Square.
- Entre na Square na aba do navegador que abrir. Para testar prompts antes com dados de Sandbox, use no lugar npx square-mcp-server start com SANDBOX=true e um access token de Sandbox.
- Chatfuel MCP
https://mcp.chatfuel.com/panel- Square MCP, no seu computador
npx mcp-remote https://mcp.squareup.com/mcp
O que você precisa
- Um bot do Chatfuel com um canal conectado. O caso dos pontos em dobro também precisa de uma conta do Instagram ou de uma página do Facebook, de onde saem as DMs dos comentários.
- Uma conta da Square num país onde a Square aceita pagamentos com cartão: Estados Unidos, Canadá, Reino Unido, Irlanda, França, Espanha, Austrália ou Japão. Quem entra é o dono da conta ou alguém da equipe com permissão total.
- Square Appointments Plus ou Premium para criar, remarcar ou cancelar agendamentos pela API; no plano gratuito, o assistente só lê. Para os pontos, o Square Loyalty com um programa criado no Square Dashboard.
- O Claude, que tem a Square no diretório de conectores; o ChatGPT com developer mode para servidores MCP próprios; ou o Cursor com Node.js instalado.
Limites
- A Square chama o servidor MCP de Beta e recebe sugestões e relatos de erro como issues do GitHub em square/square-mcp-server.
- O servidor hospedado só acessa dados reais. A Square recomenda testar os prompts antes num Sandbox, o que exige o servidor local com um access token de Sandbox.
- O agendamento do Chatfuel e o Square Appointments têm agendas separadas, e nada sincroniza as duas. Aqui o assistente agenda na Square quando você pede; os agendamentos que o Agente de IA faz no Chatfuel ficam no Chatfuel.
- Com acesso de vendedor, o assistente pode marcar dois clientes no mesmo horário ou fora do expediente, por isso ele confere antes os horários livres da Square. Sem Plus ou Premium, a Square recusa qualquer mudança de agendamento com um 403.
- A Square procura clientes por telefone ou e-mail, não pelo nome, e o Chatfuel MCP não passa nenhum dos dois. A cliente precisa digitar um deles na conversa; no caminho inverso, list_chats consegue buscar o telefone de um perfil da Square.
- A Square não documenta uma etapa de aprovação própria para gravações como estornos, então mantenha a aprovação de tools ligada no assistente. Só dá para estornar pagamentos concluídos com até um ano, no máximo 20 vezes por pagamento.
- Uma resposta ao cliente só sai depois que você aprova o texto e dentro do prazo: 24 horas desde a última mensagem dele no WhatsApp, 7 dias no Instagram e no Messenger.
- A Square só aceita clientes MCP da lista de liberados. Um assistente fora dela não consegue entrar até a Square incluí-lo, depois de um pedido no fórum de desenvolvedores.
Perguntas frequentes
Sim, as duas coisas. A Block hospeda o servidor em https://mcp.squareup.com/mcp, e o guia da Square em developer.squareup.com/docs/mcp chama o servidor de Beta. O código da versão local está no GitHub como square/square-mcp-server. A Square não publicou o servidor no MCP Registry.
Não. O agendamento do Chatfuel grava na agenda própria do Chatfuel, e o Chatfuel MCP não sincroniza essa agenda com a Square. Se a sua agenda é a Square, faça o Agente de IA passar os pedidos de horário para a equipe e peça ao assistente para agendar na Square.
Ler agendamentos e as configurações de agendamento funciona no plano gratuito do Appointments. Criar, remarcar ou cancelar exige o Appointments Plus ou Premium. A promoção de pontos em dobro precisa de uma assinatura do Square Loyalty.
Com o servidor hospedado, não: ele só acessa produção. Use o servidor local, npx square-mcp-server start, com um access token de Sandbox e SANDBOX=true. Com DISALLOW_WRITES=true ele fica só leitura.
Sim, como servidor MCP próprio no developer mode, com https://mcp.squareup.com/mcp. A Square ainda não tem um plugin do ChatGPT para os dados do negócio. O app do ChatGPT que a Square anunciou em julho de 2026 é outra coisa: serve para pedir comida em restaurantes dos EUA.
Pelo telefone ou pelo e-mail. A Square procura no Customer Directory por telefone ou e-mail, exato ou aproximado, então a cliente digita um deles na conversa. No sentido inverso, list_chats encontra uma conversa pelo telefone salvo num perfil da Square.
Mais integrações
Conecte o Chatfuel MCP
Comece o teste grátis, adicione o Chatfuel ao seu assistente e pergunte sobre Square e as suas conversas em um só lugar.

